USUM API

ニンテンドー3DS ソフト「ポケットモンスター ウルトラサン・ウルトラムーン」のポケモン情報をJSON形式で返すAPIです。

注意事項

• 個人的な事情により突然停止する可能性があります。
• 自分用に作成したAPIですので、内容については保証できません。
• 常識的な範囲での利用をお願いします。同じ値しか返さないようにしていますので、大量のアクセスが想定される場合はキャッシュするなどしてなるべくサーバに負荷を与えないようにしてください。

利用方法

• リクエストは GET メソッドを使用してください。
• HTTP でアクセスした場合は HTTPS にリダイレクトされます。
• レスポンスの Content-Type は application/json; charset=utf-8 です。
• エラーが発生した場合はJSON以外を返却する可能性があります。HTTPステータスコードをチェックしてから使用することをおすすめします。
• プログラム・サービスから定期的にアクセスする場合は User-Agent を設定してください。形式は問いませんが、アプリケーションの名称/バージョン/URLなどが含まれているとベストです。

リクエスト方法

ポケモンの一覧情報を返します。

https://usumapi.nelke.jp/v1/pokemon/

フィルターを使用して絞り込むことができます。

https://usumapi.nelke.jp/v1/pokemon/?no={%1}&?key={%2}

• %1 : ポケモンの全国図鑑No
• %2 : ポケモンの内部Key（指定する値はNo, Key一覧を参照）

メガシンカやアローラのすがたがあるため、ポケモンの全国図鑑Noでは一意にならない点には注意してください。

レスポンスデータ

実際のデータにはスペースや改行は含まれていませんが、読みやすさを重視してスペースや改行を追加してあります。

{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "no": 1,
            "key": "bulbasaur",
            "names": [
                {
                    "name": "フシギダネ",
                    "language": {
                        "id": 1,
                        "key": "ja"
                    }
                },
                {
                    "name": "Bulbasaur",
                    "language": {
                        "id": 2,
                        "key": "en"
                    }
                }
            ],
            "types": [
                {
                    "type": {
                        "key": "grass",
                        "names": [
                            {
                                "name": "Grass",
                                "language": {
                                    "id": 2,
                                    "key": "en"
                                }
                            },
                            {
                                "name": "くさ",
                                "language": {
                                    "id": 1,
                                    "key": "ja"
                                }
                            }
                        ]
                    },
                    "order": 1
                },
                {
                    "type": {
                        "key": "poison",
                        "names": [
                            {
                                "name": "Poison",
                                "language": {
                                    "id": 2,
                                    "key": "en"
                                }
                            },
                            {
                                "name": "どく",
                                "language": {
                                    "id": 1,
                                    "key": "ja"
                                }
                            }
                        ]
                    },
                    "order": 2
                }
            ],
            "abilities": [
                {
                    "ability": {
                        "key": "overgrow",
                        "names": [
                            {
                                "name": "しんりょく",
                                "language": {
                                    "id": 1,
                                    "key": "ja"
                                }
                            },
                            {
                                "name": "Overgrow",
                                "language": {
                                    "id": 2,
                                    "key": "en"
                                }
                            }
                        ]
                    },
                    "order": 1,
                    "is_hidden_ability": false
                },
                {
                    "ability": {
                        "key": "chlorophyll",
                        "names": [
                            {
                                "name": "ようりょくそ",
                                "language": {
                                    "id": 1,
                                    "key": "ja"
                                }
                            },
                            {
                                "name": "Chlorophyll",
                                "language": {
                                    "id": 2,
                                    "key": "en"
                                }
                            }
                        ]
                    },
                    "order": 3,
                    "is_hidden_ability": true
                }
            ],
            "hp": 45,
            "attack": 49,
            "defense": 49,
            "special_attack": 65,
            "special_defense": 65,
            "speed": 45,
            "height": "0.7",
            "weight": "6.9"
        }
    ]
}

• count : 総件数
• next : 次の一覧のURL（存在しない場合はnull）
• previous : 前の一覧のURL（存在しない場合はnull）
• results : 結果の配列
  • no : 全国図鑑のポケモンNo。メガシンカポケモンはメガシンカ前のポケモンのNo。
  • key : ポケモンのUniqueKey
  • names : ポケモンの名称
    • name : ポケモンの各言語の名称
    • language : 言語
      • id : 言語の内部ID
      • key : 言語の内部Key
  • types : ポケモンのタイプを表す配列
    • type : ポケモンのタイプ
      • key : タイプのUniqueKey
      • names : タイプの各言語の名称
        • name : タイプの各言語ごとの名称
        • language : 言語
          • id : 言語の内部ID
          • key : 言語の内部Key
    • order : ポケモンのタイプの順序
  • abilities : ポケモンの特性を表す配列
    • type : ポケモンの特性
      • key : 特性のUniqueKey
      • names : 特性の名称
        • name : 特性の各言語の名称
        • language : 言語
          • id : 言語の内部ID
          • key : 言語の内部Key
    • order : ポケモンの特性の順序
    • is_hidden_ability : 隠れ特性かどうか（trueの場合、隠れ特性）
  • hp : HP種族値
  • attack : 攻撃種族値
  • defense : 防御攻撃種族値
  • special_attack : 特攻種族値
  • special_defense : 特防種族値
  • speed : 素早さ種族値
  • height : 身長
  • weight : 体重

1回のリクエストで取得できるポケモンの数は30件です。30件を超える場合はnext, previousに前後の一覧のURLが埋め込まれます。

No, Key 一覧

更新履歴

• 1.0.0 : 2019/04/12
• 初版