GET /guilds

エンドポイント: GET /v1/pdapi/guilds

認証: ベアラートークン

許可: REST.Guilds.Read

目的

既知のギルドと概要情報をリストします。特定のギルドをリクエストする前に、このエンドポイントを使用してギルド ID を検出します。

なし。

なし。

リクエスト本文がありません。

Field	Type	Description
`Meta`	object	Guild list metadata.
`Guilds`	object	Known guild summaries keyed by guild UUID.

Meta object schema:

Field	Type	Description
`GuildCount`	integer	Number of guilds returned.

Guild summary object schema:

Field	Type	Description
`name`	string	Guild name.
`Level`	integer	Guild base camp level.
`admin`	object	Guild admin details.
`camp_count`	integer	Number of base camps in the guild.
`camps`	object[]	Base camp summaries.
`member_count`	integer	Number of guild members.
`members`	string[]	Guild member PlayerUID values.

admin object schema:

Field	Type	Description
`id`	string	Admin PlayerUID.
`name`	string	Admin player name.

camps[] item schema:

Coordinate object schema:

エラー本体は次の形状を使用します。

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Human-readable message",
        "Details": {}
    }
}

HTTP	エラーコード	それが起こったとき
`401`	`INVALID_TOKEN`	`Authorization` ヘッダーが欠落しているか、形式が不正であるか、構成されたベアラートークンと一致しません。
`403`	`MISSING_PERMISSION`	トークンは有効ですが、このエンドポイント権限が含まれていません。
`400`	`INVALID_JSON`	リクエスト本文が指定されましたが、JSON として解析できませんでした。
`400`	`REQUEST_FAILED`	ゲームスレッドコールバックが例外をスローしたか、共有プレーヤー/リソースリゾルバーが失敗しました。
`500`	`REQUEST_TIMEOUT`	内部ゲームスレッドコールバックは 5 秒以内に完了しませんでした。

GET /v1/pdapi/guilds

GET /v1/pdapi/guilds