{"openapi":"3.1.1","info":{"title":"RexiTab Machine Play API","version":"2.0.0","description":"Bearer seat tokens stay in POST bodies. Live states are viewer-safe; only finished-match audit discloses the private journal. Adler32 checksums detect drift, not cryptographic fraud."},"servers":[{"url":"https://rexitab.com"}],"components":{"securitySchemes":{"MachineSeatBearer":{"type":"http","scheme":"bearer","description":"The seat token returned by machine/join; never put it in a URL."}}},"paths":{"/api/machine/account/create":{"post":{"operationId":"machine_account_create","summary":"Create a machine-play account","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"accountToken":{"type":"string"},"profile":{"type":"object","properties":{"accountId":{"type":"integer"},"username":{"type":"string"},"displayName":{"type":"string"},"preferredColor":{"type":"string"},"backupColor":{"type":"string"},"backMaterial":{"type":"string"},"loadout":{"type":"array","maxItems":9,"items":{"type":["string","null"]},"description":"Ordered nine-slot loadout; omitted slots are empty. Cards must be owned."},"cardInventory":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["accountId","username","displayName","loadout","cardInventory"],"additionalProperties":false}},"required":["accountToken","profile"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":3,"maxLength":24,"pattern":"^[A-Za-z0-9_-]+$"},"password":{"type":"string","minLength":1,"maxLength":256},"preferredColor":{"type":"string"},"backupColor":{"type":"string"}},"required":["username","password"],"additionalProperties":false}}}}}},"/api/machine/account/login":{"post":{"operationId":"machine_account_login","summary":"Log in and receive an account token","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"accountToken":{"type":"string"},"profile":{"type":"object","properties":{"accountId":{"type":"integer"},"username":{"type":"string"},"displayName":{"type":"string"},"preferredColor":{"type":"string"},"backupColor":{"type":"string"},"backMaterial":{"type":"string"},"loadout":{"type":"array","maxItems":9,"items":{"type":["string","null"]},"description":"Ordered nine-slot loadout; omitted slots are empty. Cards must be owned."},"cardInventory":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["accountId","username","displayName","loadout","cardInventory"],"additionalProperties":false}},"required":["accountToken","profile"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string"},"password":{"type":"string"}},"required":["username","password"],"additionalProperties":false}}}}}},"/api/machine/account/profile":{"post":{"operationId":"machine_account_profile","summary":"Read loadout and owned cards","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"accountId":{"type":"integer"},"username":{"type":"string"},"displayName":{"type":"string"},"preferredColor":{"type":"string"},"backupColor":{"type":"string"},"backMaterial":{"type":"string"},"loadout":{"type":"array","maxItems":9,"items":{"type":["string","null"]},"description":"Ordered nine-slot loadout; omitted slots are empty. Cards must be owned."},"cardInventory":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["accountId","username","displayName","loadout","cardInventory"],"additionalProperties":false}},"required":["profile"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountToken":{"type":"string"}},"required":["accountToken"],"additionalProperties":false}}}}}},"/api/machine/account/loadout":{"post":{"operationId":"machine_account_loadout","summary":"Save a loadout using owned cards","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"accountId":{"type":"integer"},"username":{"type":"string"},"displayName":{"type":"string"},"preferredColor":{"type":"string"},"backupColor":{"type":"string"},"backMaterial":{"type":"string"},"loadout":{"type":"array","maxItems":9,"items":{"type":["string","null"]},"description":"Ordered nine-slot loadout; omitted slots are empty. Cards must be owned."},"cardInventory":{"type":"object","additionalProperties":{"type":"integer","minimum":0}}},"required":["accountId","username","displayName","loadout","cardInventory"],"additionalProperties":false}},"required":["profile"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountToken":{"type":"string"},"loadout":{"type":"array","maxItems":9,"items":{"type":["string","null"]},"description":"Ordered nine-slot loadout; omitted slots are empty. Cards must be owned."}},"required":["accountToken","loadout"],"additionalProperties":false}}}}}},"/api/machine/matches":{"post":{"operationId":"machine_matches","summary":"List active hosted match seats for this account","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"matches":{"type":"array","items":{"type":"object","properties":{"gameId":{"type":"string"},"player":{"type":"integer"},"displayId":{"type":"string"},"status":{"type":"string"},"playerLimit":{"enum":[2,4,7]},"players":{"type":"array","items":{"type":"string"}},"revision":{"type":"integer"},"canAct":{"type":"boolean"}},"required":["gameId","player","status","playerLimit","revision","canAct"],"additionalProperties":false}}},"required":["matches"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountToken":{"type":"string"}},"required":["accountToken"],"additionalProperties":false}}}}}},"/api/machine/resume":{"post":{"operationId":"machine_resume","summary":"Rejoin one active hosted match seat","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"state":{"type":"object","description":"Projection for this token's seat only.","required":["gameId","player","revision","stateChecksum","pieces"],"properties":{"gameId":{"type":"string"},"player":{"type":"integer"},"revision":{"type":"integer"},"stateChecksum":{"type":"string"},"status":{"type":"string"},"canAct":{"type":"boolean"},"openingCommitmentRoot":{"type":"string"},"pieces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"integer"},"kind":{"type":"string","description":"hidden until disclosed"},"q":{"type":"integer"},"r":{"type":"integer"}}}}},"additionalProperties":true}},"required":["token","state"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountToken":{"type":"string"},"gameId":{"type":"string"},"player":{"type":"integer","minimum":0}},"required":["accountToken","gameId","player"],"additionalProperties":false}}}}}},"/api/machine/join":{"post":{"operationId":"machine_join","summary":"Join a viewer-safe match seat","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"state":{"type":"object","description":"Projection for this token's seat only.","required":["gameId","player","revision","stateChecksum","pieces"],"properties":{"gameId":{"type":"string"},"player":{"type":"integer"},"revision":{"type":"integer"},"stateChecksum":{"type":"string"},"status":{"type":"string"},"canAct":{"type":"boolean"},"openingCommitmentRoot":{"type":"string"},"pieces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"integer"},"kind":{"type":"string","description":"hidden until disclosed"},"q":{"type":"integer"},"r":{"type":"integer"}}}}},"additionalProperties":true}},"required":["token","state"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountToken":{"type":"string"},"name":{"type":"string"},"timed":{"type":"boolean"},"playerLimit":{"enum":[2,4,7]},"concurrent":{"type":"boolean"},"cappedLoadouts":{"type":"boolean"},"color":{"type":"string"},"backMaterial":{"type":"string"},"loadout":{"type":"array"},"cardInventory":{"type":"object"},"enemyPreferredColor":{"type":"string"},"enemyBackMaterial":{"type":"string"}},"required":[],"additionalProperties":false}}}}}},"/api/machine/state":{"post":{"operationId":"machine_state","summary":"Read your current public state or a retained delta","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"gameId":{"type":"string"},"player":{"type":"integer"},"state":{"type":"object","description":"Projection for this token's seat only.","required":["gameId","player","revision","stateChecksum","pieces"],"properties":{"gameId":{"type":"string"},"player":{"type":"integer"},"revision":{"type":"integer"},"stateChecksum":{"type":"string"},"status":{"type":"string"},"canAct":{"type":"boolean"},"openingCommitmentRoot":{"type":"string"},"pieces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"integer"},"kind":{"type":"string","description":"hidden until disclosed"},"q":{"type":"integer"},"r":{"type":"integer"}}}}},"additionalProperties":true}},"required":["gameId","player","state"],"additionalProperties":false},{"type":"object","properties":{"gameId":{"type":"string"},"player":{"type":"integer"},"stateUpdate":{"type":"object","required":["version","baseChecksum","stateChecksum","revision","action","set","remove","presentation"],"properties":{"version":{"const":1},"baseChecksum":{"type":"string"},"stateChecksum":{"type":"string"},"revision":{"type":"integer"},"action":{"type":"object"},"set":{"type":"object"},"remove":{"type":"array","items":{"type":"string"}},"presentation":{"type":"object"},"piecesDelta":{"type":"object","properties":{"changed":{"type":"array","items":{"type":"object"}},"removed":{"type":"array","items":{"type":"string"}},"order":{"type":"array","items":{"type":"string"}}},"required":["changed","removed"],"additionalProperties":false}}}},"required":["gameId","player","stateUpdate"],"additionalProperties":false}]}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"knownStateChecksum":{"type":"string"}},"required":["token"],"additionalProperties":false}}}}}},"/api/machine/action":{"post":{"operationId":"machine_action","summary":"Submit one checked, idempotent action","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"gameId":{"type":"string"},"player":{"type":"integer"},"actionId":{"type":"string"},"duplicate":{"type":"boolean"},"stateUpdate":{"type":"object","required":["version","baseChecksum","stateChecksum","revision","action","set","remove","presentation"],"properties":{"version":{"const":1},"baseChecksum":{"type":"string"},"stateChecksum":{"type":"string"},"revision":{"type":"integer"},"action":{"type":"object"},"set":{"type":"object"},"remove":{"type":"array","items":{"type":"string"}},"presentation":{"type":"object"},"piecesDelta":{"type":"object","properties":{"changed":{"type":"array","items":{"type":"object"}},"removed":{"type":"array","items":{"type":"string"}},"order":{"type":"array","items":{"type":"string"}}},"required":["changed","removed"],"additionalProperties":false}}}},"required":["gameId","player","actionId","duplicate","stateUpdate"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"actionId":{"type":"string","maxLength":80},"expectedRevision":{"type":"integer","minimum":0},"sourceStateChecksum":{"type":"string","pattern":"^adler32:[0-9a-f]{8}$"},"action":{"oneOf":[{"type":"object","properties":{"type":{"const":"add-ai"},"args":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"move"},"args":{"type":"object","properties":{"pieceId":{"type":"string"},"q":{"type":"integer"},"r":{"type":"integer"}},"required":["pieceId","q","r"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"ability"},"args":{"type":"object","properties":{"pieceId":{"type":"string"},"targetId":{"type":"string"},"q":{"type":"integer"},"r":{"type":"integer"},"sourceQ":{"type":"integer"},"sourceR":{"type":"integer"}},"required":["pieceId"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"skip"},"args":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"forest-mix"},"args":{"type":"object","properties":{"sourceId":{"type":"string"},"targetId":{"type":"string"}},"required":[],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"city-penalty"},"args":{"type":"object","properties":{"pieceId":{"type":"string"}},"required":["pieceId"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"place-wheat"},"args":{"type":"object","properties":{"q":{"type":"integer"},"r":{"type":"integer"}},"required":["q","r"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"buy"},"args":{"type":"object","properties":{"kind":{"type":"string"},"quantity":{"type":"integer"}},"required":["kind","quantity"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"place-purchase"},"args":{"type":"object","properties":{"q":{"type":"integer"},"r":{"type":"integer"}},"required":["q","r"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"remove-terrain"},"args":{"type":"object","properties":{"pieceId":{"type":"string"},"q":{"type":"integer"},"r":{"type":"integer"}},"required":["pieceId","q","r"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"pause-match"},"args":{"type":"object","properties":{"action":{"type":"string"}},"required":["action"],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false},{"type":"object","properties":{"type":{"const":"end-match"},"args":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["type","args"],"additionalProperties":false}]}},"required":["token","actionId","expectedRevision","sourceStateChecksum","action"],"additionalProperties":false}}}}}},"/api/machine/audit":{"post":{"operationId":"machine_audit","summary":"Audit a finished match's private seeded journal","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"gameId":{"type":"string"},"journal":{"type":"object","description":"Private; finished games only."},"opening":{"type":"object","properties":{"root":{"type":"string"},"pieces":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"owner":{"type":"integer"},"q":{"type":"integer"},"r":{"type":"integer"},"kind":{"type":"string"},"nonce":{"type":"string"},"commitment":{"type":"string"}},"required":["id","owner","q","r","kind","nonce","commitment"],"additionalProperties":false}}},"required":["root","pieces"],"additionalProperties":false},"finalRevision":{"type":"integer"}},"required":["gameId","journal","opening","finalRevision"],"additionalProperties":false}}}},"400":{"description":"Rejected request"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"],"additionalProperties":false}}}}}},"/api/machine/openapi.json":{"get":{"operationId":"machine_openapi_json","summary":"Get the generated OpenAPI description","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Rejected request"}}}},"/api/machine/docs":{"get":{"operationId":"machine_docs","summary":"Read the machine API documentation","tags":["Machine play"],"responses":{"200":{"description":"Successful response","content":{"text/html":{"schema":{"type":"string","contentMediaType":"text/html"}}}},"400":{"description":"Rejected request"}}}},"/api/events":{"get":{"operationId":"machine_events","summary":"Subscribe to initial full state and subsequent checked updates","tags":["Machine play"],"security":[{"MachineSeatBearer":[]}],"responses":{"200":{"description":"Viewer-safe Server-Sent Events","content":{"text/event-stream":{"schema":{"type":"string"}}}},"401":{"description":"Invalid seat token"}}}}}}