Tokens de API
Genera tokens para conectar tu servicio a la API de Códice y leer cartas y mazos. Cada token se muestra una sola vez: guárdalo en un lugar seguro. Puedes revocarlo cuando quieras.
Crear token
Tus tokens
Cargando…
Cómo usar la API
1. Autenticación
Toda petición lleva tu token en la cabecera:
Authorization: Bearer ctcg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxBase URL: https://codicetcg.org/api/v1
Cada token puede tener vigencia (la eliges al crearlo). Un token expirado responde 401 y debes generar uno nuevo.
2. Permisos (scopes)
cards:read— leer cartas y datos de referencia (todos los tokens lo tienen).decks:public— leer mazos públicos de cualquier usuario (por defecto).decks:private— leer también mazos privados. Solo lo concede el equipo de Códice a partners de confianza.
3. Vincular un usuario
El usuario de Códice copia su ID de conexión (public_id) desde su página de Configuración y lo pega en tu app. Con ese ID consultas sus mazos.
4. Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /users/:publicId | Identidad: public_id, username, avatar. |
| GET | /users/:publicId/decks | Mazos del usuario (públicos; privados si el token está elevado). |
| GET | /users/:publicId/decks/:slug | Mazo completo: datos_json (uuid→cantidad) + core_cards. |
| GET | /catalog | Manifiesto de bloques con fecha (para cachear). |
| GET | /catalog/:bloque | Índice completo de cartas del bloque (IMP, FX, PB, PE…). |
| GET | /cards/:uuid | Detalle de una carta. |
| GET | /banlist?format=Standard&bloque=IMP | Banlist vigente. |
| GET | /reference/types | Tipos base. |
| GET | /reference/races | Razas base. |
| GET | /reference/editions?bloque=IMP | Ediciones. |
| GET | /reference/families?bloque=IMP | Mapeo carta→familia. |
5. Reconstruir un mazo
Un mazo trae solo UUIDs y cantidades. Para obtener las cartas reales:
- Lee el mazo → obtienes
datos_json.main/side(uuid → cantidad) y elbloque. - Descarga el catálogo del bloque una vez:
/catalog/:bloque. - Cruza cada UUID contra el catálogo para resolver nombre, imagen, coste, fuerza, etc.
Usa /catalog (manifiesto) para cachear y solo re-descargar cuando cambie.
6. Ejemplo (curl)
TOKEN="ctcg_..."
BASE="https://codicetcg.org/api/v1"
# Mazos del usuario
curl -H "Authorization: Bearer $TOKEN" "$BASE/users/$PUBLIC_ID/decks"
# Un mazo completo
curl -H "Authorization: Bearer $TOKEN" "$BASE/users/$PUBLIC_ID/decks/mi-mazo"
# Catálogo del bloque para resolver los UUIDs
curl -H "Authorization: Bearer $TOKEN" "$BASE/catalog/IMP"Errores
401 token ausente/inválido/revocado · 403 falta el permiso requerido · 404 no encontrado · 429 límite de tasa.