{"openapi":"3.1.0","info":{"title":"カイゴ様式.ai API","version":"1.0.0","description":"介護・障害福祉事業所の帳票をPDF生成するAPI。様式一覧・スキーマ取得・PDF生成・記録からの自動記入・既存書類の読み取りに対応。AIエージェントからの利用を想定。"},"servers":[{"url":"https://localhost:8080"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/api/v1/forms":{"get":{"operationId":"listForms","summary":"利用可能な様式の一覧を取得","responses":{"200":{"description":"様式一覧"}}}},"/api/v1/forms/{slug}":{"get":{"operationId":"getFormSchema","summary":"様式の入力フィールド定義を取得","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"様式スラッグ（listFormsで取得）"}],"responses":{"200":{"description":"フィールド定義"},"404":{"description":"様式が存在しない"}}}},"/api/v1/generate":{"post":{"operationId":"generatePdf","summary":"様式と入力データからPDFを生成","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["form"],"properties":{"form":{"type":"string","description":"様式スラッグ"},"data":{"type":"object","additionalProperties":{"type":"string"},"description":"フィールドkey→値。getFormSchemaの定義に従う"}}}}}},"responses":{"200":{"description":"PDFバイナリ","content":{"application/pdf":{}}}}}},"/api/v1/autofill":{"post":{"operationId":"autofillFromText","summary":"記録・カルテ・問診テキストから様式フィールドを自動記入","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["form","text"],"properties":{"form":{"type":"string"},"text":{"type":"string","description":"元となる記録・メモ（2万字以内）"}}}}}},"responses":{"200":{"description":"自動記入された data オブジェクト"}}}},"/api/v1/extract":{"post":{"operationId":"extractFromDocument","summary":"既存書類（PDF・画像のbase64）を読み取り様式フィールドを埋める","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["form","mime","data"],"properties":{"form":{"type":"string"},"mime":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]},"data":{"type":"string","description":"ファイルのbase64（5MB以内）"}}}}}},"responses":{"200":{"description":"読み取られた data オブジェクト"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"発行したAPIキー（sk_kaigo_...）を Authorization: Bearer で送信"}}}}