API:1

ギルドウォーズ2のAPIのバージョン1は、公開された最初のAPIで、2013年5月14日にリリースされました。現在のところ、既存のリソースが将来変更される可能性があることを意味する「ベータ」というラベルが付けられていますが、これまでのすべての変更によってAPIが大幅に変更されることはありませんでした。APIバージョン1は進行中の作業とみなされます。

HTTPS経由で一般公開されており、承認は必要ありません。すべてのリソースはGETを介してのみアクセス可能であり、パラメータはクエリ文字列パラメータの形式で提供されます。APIは、JSONドキュメントの形式で応答を返します。

エンドポイント[]

すべてのエンドポイントのベースURLは https://api.guildwars2.com です。

• /v1/build.json
• /v1/event_details.json
• /v1/continents.json
• /v1/events.json
• /v1/event_names.json
• /v1/files.json
• /v1/guild_details.json
• /v1/items.json
• /v1/item_details.json
• /v1/maps.json
• /v1/map_floor.json
• /v1/map_names.json
• /v1/recipes.json
• /v1/recipe_details.json
• /v1/skins.json
• /v1/skin_details.json
• /v1/world_names.json
• /v1/wvw/matches.json
• /v1/wvw/match_details.json
• /v1/wvw/objective_names.json
• /v1/colors.json
• /v1/wvw

エラー[]

誤った入力パラメータによるエラーは、HTTPステータスコード500になりますが、4xxステータスコードはユーザエラーの方が適切です。サーバーは、リクエストに間違っていた理由を含むテキストプロパティを含むJSONエラーオブジェクトを返します。たとえば map_floor のリソースへの要求が必要なパラメータなしで要求されると、次のエラードキュメントが生成されます。：

{ "error": 10, "product": 0, "module": 4, "line": 264, "text": "missing continent_id or floor"}

存在しないエンドポイントを要求すると、HTTP出力コード404が生成されます。

特に記載のない限り、コミュニティのコンテンツはCC BY-SAライセンスの下で利用可能です。