Documentación REST y GraphQL. Desarrolla a tu manera.

Cada petición necesita una clave de API. Crea una cuenta, genera una clave de prueba y llama a los endpoints de abajo; las claves de prueba devuelven datos de ejemplo y las claves reales, datos de mercado actuales de los mercados de tu plan.

Autenticación

La API usa un token bearer. Mantén las claves reales en tu servidor y nunca las incluyas en un paquete público de app; en el navegador usa una clave de prueba o una clave restringida por origen.

Authorization: Bearer YOUR_API_KEY

Recursos

GraphQL: elige tus campos

Consulta un producto y sus precios por mercado a través de un solo endpoint. Selecciona solo los campos que necesita tu interfaz, sobre el mismo modelo de datos que REST.

POST /graphql
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Envía un cuerpo JSON con query y variables. En el ejemplo de abajo, el selector de mercado actualiza las variables y la respuesta de ejemplo. Las pestañas Consulta, Variables y Respuesta pertenecen a la misma petición.

El esquema cubre búsqueda de productos, precios de mercado e historial de precios. La complejidad de consulta está limitada por petición y cada petición GraphQL cuenta una vez contra tu cuota; una consulta anidada no equivale a datos ilimitados en una petición.

Ejemplos de código

Respuesta de ejemploKA—001

KICKSAPI ORIGINAL

Concept 01

KA-001 / EU 42

Mercado

Precio€189.00

Ejemplo estático · la API real devuelve datos de mercado actuales

Tipo de API

RESTGraphQL

JSONJavaScriptPython

GET /v1/products/ka_concept_001/prices

{
  "id": "ka_concept_001",
  "name": "KicksAPI Concept 01",
  "style_code": "KA-001",
  "market": "NL",
  "currency": "EUR",
  "variants": [
    {
      "size": "42",
      "size_system": "EU",
      "asking_price": 189
    }
  ],
  "source": "stockx",
  "observed_at": "2026-09-10T08:00:00Z"
}

API en producciónREST / JSON

Actualidad y valores ausentes

Guarda la fecha de observación y la de recepción. Un precio null indica que no hay un valor utilizable. No lo conviertas en cero ni interpretes un precio de oferta como venta completada.

Gestión de errores

Prepara respuestas para 401 por credenciales inválidas, 404 por productos desconocidos, 429 por límites y 503 por indisponibilidad temporal. Conserva el último registro válido y muestra su antigüedad si falla una actualización.

Con GraphQL, comprueba tanto el estado HTTP como el array errors. Una respuesta puede contener datos parciales y errores. Los ejemplos de integración rechazan respuestas con errores; las apps de producción pueden decidir cómo mostrar resultados parciales utilizables.