{"openapi":"3.1.0","info":{"title":"SEEDSN 公開API","version":"1.0.0","description":"地域課題・団体情報の公開データを取得するための読み取り専用API。書き込み系エンドポイントは含まない。"},"servers":[{"url":"/api/v1/public"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"任意。未指定でも匿名として利用できる（レート上限は低くなる）。クエリ文字列でのキー送信はできない。"}}},"security":[{},{"bearerAuth":[]}],"paths":{"/api/v1/public/issues":{"get":{"summary":"公開課題の一覧","parameters":[{"name":"region","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"課題一覧","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"時間あたりの上限"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"残り呼び出し可能数"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"リセット時刻（UNIX秒）"}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"publicId":{"type":"string"},"title":{"type":"string"},"summary":{"type":["string","null"]},"description":{"type":["string","null"]},"background":{"type":["string","null"]},"currentState":{"type":["string","null"]},"desiredState":{"type":["string","null"]},"targetPeople":{"type":"array","items":{"type":"string"}},"requiredSupport":{"type":"array","items":{"type":"string"}},"stakeholders":{"type":"array","items":{"type":"string"}},"sdgs":{"type":"array","items":{"type":"number"}},"category":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"tags":{"type":"array","items":{"type":"string"}},"region":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"fullName":{"type":"string"}},"required":["code","name","fullName"],"additionalProperties":false},"locationText":{"type":["string","null"]},"status":{"type":"string"},"urgency":{"type":["number","null"]},"importance":{"type":["number","null"]},"progress":{"type":"number"},"reactionCount":{"type":"number"},"participantCount":{"type":"number"},"commentCount":{"type":"number"},"aiGeneratedFields":{"type":"array","items":{"type":"string"}},"publishedAt":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["publicId"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","pagination"],"additionalProperties":false}}}},"429":{"description":"レート制限超過","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"再試行までの秒数"}}}}}},"/api/v1/public/issues/{publicId}":{"get":{"summary":"公開課題の詳細","parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"課題詳細","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"時間あたりの上限"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"残り呼び出し可能数"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"リセット時刻（UNIX秒）"}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"publicId":{"type":"string"},"title":{"type":"string"},"summary":{"type":["string","null"]},"description":{"type":["string","null"]},"background":{"type":["string","null"]},"currentState":{"type":["string","null"]},"desiredState":{"type":["string","null"]},"targetPeople":{"type":"array","items":{"type":"string"}},"requiredSupport":{"type":"array","items":{"type":"string"}},"stakeholders":{"type":"array","items":{"type":"string"}},"sdgs":{"type":"array","items":{"type":"number"}},"category":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"tags":{"type":"array","items":{"type":"string"}},"region":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"fullName":{"type":"string"}},"required":["code","name","fullName"],"additionalProperties":false},"locationText":{"type":["string","null"]},"status":{"type":"string"},"urgency":{"type":["number","null"]},"importance":{"type":["number","null"]},"progress":{"type":"number"},"reactionCount":{"type":"number"},"participantCount":{"type":"number"},"commentCount":{"type":"number"},"aiGeneratedFields":{"type":"array","items":{"type":"string"}},"publishedAt":{"type":["string","null"]},"updatedAt":{"type":"string"}},"required":["publicId"],"additionalProperties":false}}}},"404":{"description":"見つかりません（存在しない、または閲覧できないリソース）"},"429":{"description":"レート制限超過","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"再試行までの秒数"}}}}}},"/api/v1/public/organizations":{"get":{"summary":"公開団体・企業の一覧","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"団体・企業一覧","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"時間あたりの上限"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"残り呼び出し可能数"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"リセット時刻（UNIX秒）"}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"publicId":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"logoUrl":{"type":["string","null"]},"websiteUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"activityRegionText":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["publicId"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","pagination"],"additionalProperties":false}}}},"429":{"description":"レート制限超過","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"再試行までの秒数"}}}}}},"/api/v1/public/organizations/{publicId}":{"get":{"summary":"公開団体・企業の詳細","parameters":[{"name":"publicId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"団体・企業詳細","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"時間あたりの上限"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"残り呼び出し可能数"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"リセット時刻（UNIX秒）"}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"publicId":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"logoUrl":{"type":["string","null"]},"websiteUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"activityRegionText":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["publicId"],"additionalProperties":false}}}},"404":{"description":"見つかりません（存在しない、または閲覧できないリソース）"},"429":{"description":"レート制限超過","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"再試行までの秒数"}}}}}},"/api/v1/public/categories":{"get":{"summary":"カテゴリマスター","responses":{"200":{"description":"カテゴリ一覧","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"時間あたりの上限"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"残り呼び出し可能数"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"リセット時刻（UNIX秒）"}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"429":{"description":"レート制限超過","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"再試行までの秒数"}}}}}},"/api/v1/public/regions":{"get":{"summary":"地域マスター","responses":{"200":{"description":"地域一覧","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"時間あたりの上限"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"残り呼び出し可能数"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"リセット時刻（UNIX秒）"}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"fullName":{"type":"string"},"level":{"type":"string"}},"required":["code"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"429":{"description":"レート制限超過","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"再試行までの秒数"}}}}}}}}