# Emblems

> `GET /api/academy/emblems`: Academy endpoint of the Rone Arena API.

List all emblems with details. Supports query parameters for pagination and localization.

Query parameters:
- **size**: Number of items per page (minimum: 1).
- **index**: Page index (starting from 1).
- **lang**: Language code for localized content (default: `en`).

The response includes emblem data:
- **records**: Array of emblem entries, each containing:
    - **_id**: Unique record identifier.
    - **_createdAt**: Creation timestamp.
    - **_updatedAt**: Last update timestamp.
    - **data**:
        - **giftid**: Emblem ID.
        - **gifttiers**: Emblem tier level.
        - **emblemskill**: Associated skill details:
            - **skillid**: Skill ID.
            - **skillid_lv**: Skill ID with level reference.
            - **skillname**: Skill name (e.g., 'Weapons Master').
            - **skillicon**: Skill icon URL.
            - **skilldesc**: Full description of skill effects.
            - **skilldesc_text**: Template-based description with placeholders.
            - **skilldescemblem**: Emblem-specific description.
            - **numdescribe**: Numeric effect values (e.g., '5%').
    - **id**: Internal record ID.
    - **sourceId**: Source reference ID.

This endpoint is useful for:
- Displaying the full emblem catalog.
- Explaining emblem effects and associated skills.
- Guiding players in emblem selection and optimization.

## Request

`GET https://arena.rone.dev/api/academy/emblems`

### Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `size` | query | integer | no | `20` | Number of items per page. Range: 1... |
| `index` | query | integer | no | `1` | Page index for pagination. Range: 1... |
| `lang` | query | string | no | `en` | Language code for localized content. One of: `en`, `id`, `ru`, `es`, `pt`, `tr`, `ar`, `de`, `fr`, `it`, `ja`, `ko`, `th`, `vi`, `zh-CN`, `zh-TW`, `km`. |

### Example

```bash
curl -X GET 'https://arena.rone.dev/api/academy/emblems'
```

## Example response

```json
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1736302497664,
        "_id": "677ddfa16cecfab942bd1208",
        "_updatedAt": 1736302497664,
        "data": {
          "emblemskill": {
            "numdescribe": "5%",
            "skilldesc": "Physical Attack and Magic Power gained from equipment, emblem, talents, and skills are increased by 5%.",
            "skilldesc_text": "Physical Attack and Magic Power gained from equipment, emblem, talents, and skills are increased by <%Num1>.",
            "skilldescemblem": "Physical Attack and Magic Power gained from equipment, emblem, talents, and skills are increased by 5%.",
            "skillicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_893891a86726cbf0b00401127a1f9486.png",
            "skillid": 61010,
            "skillid_lv": "61010/1",
            "skillname": "Weapons Master"
          },
          "giftid": 1221,
          "gifttiers": 2
        },
        "id": 100333,
        "sourceId": 2718121
      }
    ],
    "total": 26
  }
}
```

## Links

- Try it in the playground: https://arena.rone.dev/web/academy/emblems
- Academy endpoints: https://arena.rone.dev/web/academy.md
- OpenAPI schema: https://arena.rone.dev/api/openapi.json