# 내 Rank 정보 요청

<mark style="color:green;">`GET`</mark> `http://{leaderboard-external-domain}/v1.0/leaderboard/rank/me`

**Headers**

| Name            | Type   | Description                 |
| --------------- | ------ | --------------------------- |
| Authorization\* | string | Bearer {{web-access-token}} |

#### Query Params

| Name        | Type  | Description       |
| ----------- | ----- | ----------------- |
| season\_id  | int64 | 시즌 ID             |
| channel\_id | int64 | meta 정보에 있는 채널 ID |
| au\_id      | int64 | 게임 auid           |

**Response**

{% tabs %}
{% tab title="200: OK 정상 서비스 상태" %}

```json
{
    "return": 0,
    "message": "success",
    "value": {
        "rank": {
                "rank_id": 1,
                "au_id": 26,
                "wins": 1,
                "losses": 5,
                "win_rate": 16.67,
                "rank_point": 96,
                "nick_name": "bboodd",
                "profile_thumbnail": "https://innofile.blob.core.windows.net/inno/dev/onchaingame/ragmon/asset/profile_user/img_thumbnail_profile_1.png",
                "profile_frame": "https://innofile.blob.core.windows.net/inno/dev/onchaingame/ragmon/asset/profile_user/img_frame_profile_1_yellow.png",
                "reward_quantity": 200000
            }
    }
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Example Curl" %}

```powershell
curl --location 'https://localhost:51161/v1.0/leaderboard/rank/me?season_id=1&channel_id=100007&au_id=28' \
--header 'Authorization: Bearer eyJhbGc...4HUans'
```

{% endtab %}

{% tab title="Response 'Value'" %}

<table><thead><tr><th width="173.33333333333331">key</th><th width="180.93023255813955">data type</th><th>desc.</th></tr></thead><tbody><tr><td>rank_id</td><td>int64</td><td>랭크 순위</td></tr><tr><td>au_id</td><td>int64</td><td>게임용 auid</td></tr><tr><td>wins</td><td>int64</td><td>승리 횟수</td></tr><tr><td>losses</td><td>int64</td><td>패배 횟수</td></tr><tr><td>win_rate</td><td>float64</td><td>승률</td></tr><tr><td>rank_point</td><td>int64</td><td>승점 포인트</td></tr><tr><td>nick_name</td><td>string</td><td>게임 닉네임</td></tr><tr><td>profile_thumbnail</td><td>string</td><td>게임 프로필 이미지 URL</td></tr><tr><td>profile_frame</td><td>string</td><td>프로필 이미지 테두리 URL</td></tr><tr><td>reward_quantity</td><td>float64</td><td>보상 수량</td></tr></tbody></table>

{% endtab %}

{% tab title="Result Code" %}

| return        | message    | desc.        |
| ------------- | ---------- | ------------ |
| 0             | success    | 성공           |
| 21000         | data error | 랭킹 데이터 수집 실패 |
|               |            |              |
| {% endtab %}  |            |              |
| {% endtabs %} |            |              |
