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 利用規約

  1. 本APIを一般に公開する目的は以下に示す通りとしております。常識の範囲内でご利用いただき、目的外の利用はお控えください。
    • エラッタ情報の反映など、メンテナンスされたアグリコラの情報を共有するため
    • 拡張入りアグリコラの楽しさを広めるため
    • アグリコラの戦術研究を補助するため
    • アグリコラに関連するアプリケーション開発を促進するため
  2. 本APIで得られる情報は、Lookout Games・Z-man Games・株式会社ホビージャパンなど、製品版を発売している企業の著作物を引用、もしくはArthurによって抄訳されたものとなります。本APIの商用利用はお控えください。
  3. 利用者が開発したアプリケーションに組み込むなど、本APIに大量のリクエストを送信する場合には、あらかじめArthurにご相談ください。相談なき場合、リクエストをブロックする可能性があります。
  4. 本APIの利用に関連して利用者もしくは第三者に生じた損害について、その賠償の責任を一切負いかねます。
  5. 本APIを安定して運用できるよう努力をいたしますが、100%の稼働を保証しません。本APIは予告なくサービスを一時停止、終了することがございます。