API Catégories

Les catégories permettent d'organiser les marchés en groupes logiques (ex. : Sports, Crypto, Politique).

Créer une catégorie

POST /api/v1/categories

Authentification : X-Api-Key

Corps de la requête :

Champ	Type	Requis	Description
name	string	Oui	Nom de la catégorie
slug	string	Oui	Slug compatible URL (doit être unique par opérateur)
description	string	Non	Description de la catégorie
iconUrl	string	Non	URL de l'image de l'icône
sortOrder	number	Non	Ordre d'affichage (plus petit = en premier)

Exemple :

curl -X POST https://polymarket.sandbox.playbatman.com/api/v1/categories \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sports",
    "slug": "sports",
    "description": "Sports prediction markets",
    "sortOrder": 1
  }'

Réponse (201 Created) :

{
  "success": true,
  "data": {
    "id": "category-uuid",
    "operatorId": "operator-uuid",
    "name": "Sports",
    "slug": "sports",
    "description": "Sports prediction markets",
    "iconUrl": null,
    "isActive": true,
    "sortOrder": 1,
    "createdAt": "2026-02-18T22:00:00.000Z"
  }
}

Lister les catégories

GET /api/v1/categories

Authentification : X-Api-Key

Paramètres de requête :

Paramètre	Type	Défaut	Description
includeGlobal	boolean	true	Inclure les catégories globales (sans opérateur)
activeOnly	boolean	true	Retourner uniquement les catégories actives

Exemple :

curl "https://polymarket.sandbox.playbatman.com/api/v1/categories?activeOnly=true" \
  -H "X-Api-Key: your-api-key"

Réponse :

{
  "success": true,
  "data": [
    {
      "id": "category-uuid",
      "operatorId": "operator-uuid",
      "name": "Sports",
      "slug": "sports",
      "description": "Sports prediction markets",
      "iconUrl": null,
      "isActive": true,
      "sortOrder": 1,
      "createdAt": "2026-02-18T22:00:00.000Z"
    }
  ]
}

Obtenir une catégorie

Récupère une catégorie unique par son identifiant.

GET /api/v1/categories/{id}

Authentification : Aucune requise.

Réponse : Même structure qu'une catégorie individuelle dans la réponse de liste.

Codes d'erreur

Code	Description
CATEGORY_NOT_FOUND	La catégorie avec l'identifiant donné n'existe pas
CATEGORY_DUPLICATE_SLUG	Une catégorie avec ce slug existe déjà pour cet opérateur