{"openapi":"3.1.0","info":{"title":"Doctrine Wars API","version":"v1","description":"API Convention v1. All endpoints under /api/v1; WebSocket push at /api/v1/ws (subprotocol doctrinewars.v1.json, envelope {t,seq,d})."},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{}},"paths":{"/api/v1/meta":{"get":{"tags":["meta"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["build","api","proto","minClient","serverTime","rulesVersion","features"],"properties":{"build":{"type":"string"},"api":{"type":"string"},"proto":{"type":"integer"},"minClient":{"type":"string"},"serverTime":{"type":"number"},"rulesVersion":{"type":"integer"},"features":{"type":"array","items":{"type":"string"}}}}}}}}}},"/api/v1/healthz":{"get":{"tags":["meta"],"responses":{"200":{"description":"Default Response"}}}},"/api/v1/content":{"get":{"tags":["content"],"description":"Static game content: factions, tenets, axes.","responses":{"200":{"description":"Default Response"}}}},"/api/v1/auth/guest":{"post":{"tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"client":{"anyOf":[{"type":"string","enum":["web"]},{"type":"string","enum":["portal"]},{"type":"string","enum":["native"]}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["playerId","accessToken","expiresIn","handle"],"properties":{"playerId":{"type":"string"},"accessToken":{"type":"string"},"expiresIn":{"type":"integer"},"refreshToken":{"type":"string"},"handle":{"type":"string"}}}}}}}}},"/api/v1/auth/refresh":{"post":{"tags":["auth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"refreshToken":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["playerId","accessToken","expiresIn","handle"],"properties":{"playerId":{"type":"string"},"accessToken":{"type":"string"},"expiresIn":{"type":"integer"},"refreshToken":{"type":"string"},"handle":{"type":"string"}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/api/v1/auth/logout":{"post":{"tags":["auth"],"responses":{"200":{"description":"Default Response"}}}},"/api/v1/auth/link/{provider}":{"post":{"tags":["auth"],"security":[{"bearer":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"provider","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/v1/rt/ticket":{"post":{"tags":["realtime"],"security":[{"bearer":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["ticket","rt","proto","expiresIn"],"properties":{"ticket":{"type":"string"},"rt":{"type":"string"},"proto":{"type":"string"},"expiresIn":{"type":"integer"}}}}}}}}},"/api/v1/games":{"get":{"tags":["games"],"security":[{"bearer":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["games"],"properties":{"games":{"type":"array","items":{"type":"object","required":["gameId","turn","status","faction","updatedAt"],"properties":{"gameId":{"type":"string"},"turn":{"type":"integer"},"status":{"type":"string"},"faction":{"type":"string"},"updatedAt":{"type":"number"}}}}}}}}}}},"post":{"tags":["games"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["factionId"],"properties":{"factionId":{"type":"string"},"seed":{"minimum":0,"type":"integer"},"aiCount":{"minimum":1,"maximum":3,"type":"integer"},"turnLimit":{"minimum":10,"maximum":120,"type":"integer"}}}}}},"security":[{"bearer":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["gameId","turn","etag","state","forecast"],"properties":{"gameId":{"type":"string"},"turn":{"type":"integer"},"etag":{"type":"string"},"state":{"additionalProperties":true,"description":"Full authoritative game state (see shared/src/types.ts GameState).","type":"object","properties":{}},"forecast":{"additionalProperties":true,"description":"Per-city projection: flipsIn, to, trend.","type":"object","properties":{}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/api/v1/games/{id}":{"get":{"tags":["games"],"security":[{"bearer":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["gameId","turn","etag","state","forecast"],"properties":{"gameId":{"type":"string"},"turn":{"type":"integer"},"etag":{"type":"string"},"state":{"additionalProperties":true,"description":"Full authoritative game state (see shared/src/types.ts GameState).","type":"object","properties":{}},"forecast":{"additionalProperties":true,"description":"Per-city projection: flipsIn, to, trend.","type":"object","properties":{}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/api/v1/games/{id}/preview":{"post":{"tags":["games"],"description":"Forecast with the given orders applied this turn (does not change state).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["orders"],"properties":{"orders":{"type":"object","required":["envoyMoves","censor","broadcast","workshop"],"properties":{"envoyMoves":{"maxItems":16,"type":"array","items":{"type":"object","required":["envoyId","toCityId"],"properties":{"envoyId":{"type":"string"},"toCityId":{"type":"string"}}}},"censor":{"maxItems":64,"type":"array","items":{"type":"string"}},"broadcast":{"maxItems":64,"type":"array","items":{"type":"string"}},"workshop":{"anyOf":[{"type":"null"},{"type":"object","required":["axes","tenets"],"properties":{"axes":{"type":"array","items":[{"minimum":-1,"maximum":1,"type":"number"},{"minimum":-1,"maximum":1,"type":"number"},{"minimum":-1,"maximum":1,"type":"number"}],"additionalItems":false,"minItems":3,"maxItems":3},"tenets":{"minItems":2,"maxItems":2,"type":"array","items":{"anyOf":[{"type":"string","enum":["zeal"]},{"type":"string","enum":["canon"]},{"type":"string","enum":["communion"]},{"type":"string","enum":["commerce"]},{"type":"string","enum":["vigil"]},{"type":"string","enum":["openhand"]},{"type":"string","enum":["martyrs"]},{"type":"string","enum":["synthesis"]}]}}}}]}}}}}}}},"security":[{"bearer":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/v1/games/{id}/turns":{"post":{"tags":["games"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expectedTurn","orders"],"properties":{"expectedTurn":{"type":"integer"},"orders":{"type":"object","required":["envoyMoves","censor","broadcast","workshop"],"properties":{"envoyMoves":{"maxItems":16,"type":"array","items":{"type":"object","required":["envoyId","toCityId"],"properties":{"envoyId":{"type":"string"},"toCityId":{"type":"string"}}}},"censor":{"maxItems":64,"type":"array","items":{"type":"string"}},"broadcast":{"maxItems":64,"type":"array","items":{"type":"string"}},"workshop":{"anyOf":[{"type":"null"},{"type":"object","required":["axes","tenets"],"properties":{"axes":{"type":"array","items":[{"minimum":-1,"maximum":1,"type":"number"},{"minimum":-1,"maximum":1,"type":"number"},{"minimum":-1,"maximum":1,"type":"number"}],"additionalItems":false,"minItems":3,"maxItems":3},"tenets":{"minItems":2,"maxItems":2,"type":"array","items":{"anyOf":[{"type":"string","enum":["zeal"]},{"type":"string","enum":["canon"]},{"type":"string","enum":["communion"]},{"type":"string","enum":["commerce"]},{"type":"string","enum":["vigil"]},{"type":"string","enum":["openhand"]},{"type":"string","enum":["martyrs"]},{"type":"string","enum":["synthesis"]}]}}}}]}}}}}}}},"security":[{"bearer":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["view","events"],"properties":{"view":{"type":"object","required":["gameId","turn","etag","state","forecast"],"properties":{"gameId":{"type":"string"},"turn":{"type":"integer"},"etag":{"type":"string"},"state":{"additionalProperties":true,"description":"Full authoritative game state (see shared/src/types.ts GameState).","type":"object","properties":{}},"forecast":{"additionalProperties":true,"description":"Per-city projection: flipsIn, to, trend.","type":"object","properties":{}}}},"events":{"type":"array","items":{"additionalProperties":true,"type":"object","properties":{}}}}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}}}},"/api/v1/games/{id}/events":{"get":{"tags":["games"],"parameters":[{"schema":{"type":"integer"},"in":"query","name":"sinceTurn","required":false},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"security":[{"bearer":[]}],"responses":{"200":{"description":"Default Response"}}}},"/api/v1/{*}":{"get":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"head":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"trace":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"delete":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"options":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"patch":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"put":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"post":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}},"query":{"parameters":[{"schema":{"type":"string"},"in":"path","name":"*","required":true}],"responses":{"200":{"description":"Default Response"}}}}}}