> For the complete documentation index, see [llms.txt](https://docs.api.epicbots.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.epicbots.xyz/coinsbot/users/rang-dun-joueur.md).

# Rang d'un joueur

`GET` `/api/coinsbot/users/rank`

***

### 🔧 Paramètres

| Paramètre | Requis |  Défaut | Description               |
| --------- | :----: | :-----: | ------------------------- |
| `GuildId` |    ✅   |    —    | ID du serveur             |
| `UserId`  |    ✅   |    —    | ID de l'utilisateur       |
| `apiKey`  |    ✅   |    —    | Clé API du serveur        |
| `sortBy`  |    ❌   | `total` | Critère — voir /users/all |

***

### 💡 Exemple

```http
GET /api/coinsbot/users/rank?GuildId=123&UserId=456&apiKey=CLE&sortBy=total
```

***

### ✅ Réponse `200`

```json
{
  "GuildId": "123",
  "UserId": "456",
  "sortBy": "total",
  "value": 9500,
  "rank": 3,
  "total": 128
}
```

| Champ   | Description                             |
| ------- | --------------------------------------- |
| `value` | Valeur du joueur pour le critère choisi |
| `rank`  | Sa position (`1` = premier)             |
| `total` | Nombre total de joueurs dans le serveur |

***

### ❌ Erreurs

|  Code | Cause                                             |
| :---: | ------------------------------------------------- |
| `400` | `GuildId` ou `UserId` manquant, `sortBy` invalide |
| `401` | Clé API invalide                                  |
| `404` | Utilisateur non trouvé                            |
| `500` | Erreur interne                                    |