GraphQL API
AgricolaDBはGraphQL形式のAPIを提供しています。
※システム刷新に伴い、過去に提供していたREST APIについては提供終了させていただきました。
API 利用方法
https://api.db.agricolajp.dev/graphql
エンドポイントにPOSTしてください。以下にcurlコマンドによるリクエストの例を挙げます:
curl 'https://api.db.agricolajp.dev/graphql' \
-H 'content-type: application/json' \
--data-raw '{"query":"{\n cards(where: {revisionID: 1}, first: 5) {\n edges {\n node {\n nameJa\n printedID\n }\n }\n }\n}"}'
GraphQL Playground を用意しているので、スキーマの確認や試験的なリクエスト送信にご利用ください。
API 利用規約
-
本APIを一般に公開する目的は以下に示す通りとしております。常識の範囲内でご利用いただき、目的外の利用はお控えください。
- エラッタ情報の反映など、メンテナンスされたアグリコラの情報を共有するため
- 拡張入りアグリコラの楽しさを広めるため
- アグリコラの戦術研究を補助するため
- アグリコラに関連するアプリケーション開発を促進するため
- 本APIで得られる情報は、Lookout Games・Z-man Games・株式会社ホビージャパンなど、製品版を発売している企業の著作物を引用、もしくはArthurによって抄訳されたものとなります。本APIの商用利用はお控えください。
- 利用者が開発したアプリケーションに組み込むなど、本APIに大量のリクエストを送信する場合には、あらかじめArthurにご相談ください。相談なき場合、リクエストをブロックする可能性があります。
- 本APIの利用に関連して利用者もしくは第三者に生じた損害について、その賠償の責任を一切負いかねます。
- 本APIを安定して運用できるよう努力をいたしますが、100%の稼働を保証しません。本APIは予告なくサービスを一時停止、終了することがございます。