chunirec API v1.3 ドキュメント

アカウントやプレイヤーの情報を取得することができます。

• GET users/me
• GET users/show

GET users/me

アクセストークン保持者のアカウントデータを取得します。

エンドポイント

https://api.chunirec.net/1.3/users/me.json

仕様

• 応答形式: JSON
• アクセストークン: 必須

パラメーター

リクエスト例

GET https://api.chunirec.net/1.3/users/me.json?token=YOUR_TOKEN HTTP/1.1

応答例

Status: 200 OK

{
  "account": {
    "user_id": 1,
    "user_name": "kn2kw",
    "is_protected": false,
    "user_description": "[d bg=#ebf0ff][b]夏川くいな[/b][/d]と[d bg=#fff6c9][b]忍野忍[/b][/d]推し。\nぱないの！",
    "urls": [
      {
        "name": "mypage",
        "title": "kn2kw さんのマイ ページ",
        "url": "https://chunirec.net/users/kn2kw",
        "url_short": "https://chunirec.net/@kn2kw"
      },
      {
        "name": "worldsend",
        "title": "kn2kw さんの WORLD'S END レコード",
        "url": "https://chunirec.net/users/kn2kw/worldsend",
        "url_short": "https://chunirec.net/@kn2kw/worldsend"
      },
      {
        "name": "overpower",
        "title": "kn2kw さんのオーバーパワー",
        "url": "https://chunirec.net/users/kn2kw/overpower",
        "url_short": "https://chunirec.net/@kn2kw/overpower"
      },
      {
        "name": "stat",
        "title": "kn2kw さんのレコード集計",
        "url": "https://chunirec.net/users/kn2kw/stat",
        "url_short": "https://chunirec.net/@kn2kw/stat"
      },
      {
        "name": "course",
        "title": "kn2kw さんのコースレコード",
        "url": "https://chunirec.net/users/kn2kw/course",
        "url_short": "https://chunirec.net/@kn2kw/course"
      }
    ]
  },
  "player": {
    "playername": "ｋｎ２ｋｗ",
    "honor": "天使ちゃんマジ天使",
    "honor_type": 5,
    "level": 54,
    "rating": 15.21,
    "rating_max": 15.42,
    "classemblem": 4,
    "updated_on": "2020-11-10"
  }
}

GET users/show

アカウントデータを取得します。

エンドポイント

https://api.chunirec.net/1.3/users/show.json

仕様

• 応答形式: JSON
• アクセストークン: 必須

パラメーター

リクエスト例

GET https://api.chunirec.net/1.3/users/show.json?user_name=kn2kw&token=YOUR_TOKEN HTTP/1.1

応答例

Status: 200 OK

{
  "account": {
    "user_id": 1,
    "user_name": "kn2kw",
    "is_protected": false,
    "user_description": "[d bg=#ebf0ff][b]夏川くいな[/b][/d]と[d bg=#fff6c9][b]忍野忍[/b][/d]推し。\nぱないの！",
    "urls": [
      {
        "name": "mypage",
        "title": "kn2kw さんのマイ ページ",
        "url": "https://chunirec.net/users/kn2kw",
        "url_short": "https://chunirec.net/@kn2kw"
      },
      {
        "name": "worldsend",
        "title": "kn2kw さんの WORLD'S END レコード",
        "url": "https://chunirec.net/users/kn2kw/worldsend",
        "url_short": "https://chunirec.net/@kn2kw/worldsend"
      },
      {
        "name": "overpower",
        "title": "kn2kw さんのオーバーパワー",
        "url": "https://chunirec.net/users/kn2kw/overpower",
        "url_short": "https://chunirec.net/@kn2kw/overpower"
      },
      {
        "name": "stat",
        "title": "kn2kw さんのレコード集計",
        "url": "https://chunirec.net/users/kn2kw/stat",
        "url_short": "https://chunirec.net/@kn2kw/stat"
      },
      {
        "name": "course",
        "title": "kn2kw さんのコースレコード",
        "url": "https://chunirec.net/users/kn2kw/course",
        "url_short": "https://chunirec.net/@kn2kw/course"
      }
    ]
  },
  "player": {
    "playername": "ｋｎ２ｋｗ",
    "honor": "天使ちゃんマジ天使",
    "honor_type": 5,
    "level": 54,
    "rating": 15.21,
    "rating_max": 15.42,
    "classemblem": 4,
    "updated_on": "2020-11-10"
  }
}

備考

• user_id または user_name パラメーターを指定することで他人の情報を取得することが出来ます。省略するとアクセストークン所持者の情報が取得されます。
• 存在しないユーザーにアクセスしようとした場合は 404 Not Found が返ります。
• フレンド同士でない非公開ユーザーにアクセスしようとした場合は 403 Forbidden が返ります。