Quick Start

La Tikra Portal API te permite integrar tu sistema con tu cuenta de El Ciervo Club: consultar stock en tiempo real, crear pedidos, listar remitos y recibir eventos vía webhooks.

Prerequisitos

• Ser admin de un portal de cliente (tu cuenta de portal, no el dashboard de Tikra).
• Tener acceso a /portal/dashboard/api/keys para crear tu primera API key.

Paso 1: Crear una API key

1. Iniciá sesión en tu portal y andá a API → API Keys.
2. Click en Crear API key.
3. Asignale un nombre (ej. mi-sistema-produccion) y seleccioná los scopes que necesitás.
4. Guardá el token en un lugar seguro — se muestra una sola vez.

Paso 2: Tu primer request

Reemplazá <TOKEN> con tu API key y probá consultar tu stock:

curl -H "Authorization: Bearer <TOKEN>" \
  https://app.tikra.com/api/v1/portal/stock

La respuesta tiene la forma:

{
  "data": [
    {
      "product_id": "uuid",
      "product_name": "Cerveza Artesanal IPA",
      "quantity": 48,
      "unit": "unidad"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Paso 3: Manejar errores

Los errores siguen el formato RFC 7807. Si tu key no tiene el scope correcto:

{
  "type": "https://api.tikra.com/errors/auth/insufficient-scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "Esta API key no tiene el scope requerido: read:stock.",
  "request_id": "req_01HX..."
}

Guardá siempre el X-Request-Id del header de respuesta para debugging.

Próximos pasos

• Autenticación — scopes disponibles y rotación de keys
• Errores — tabla completa de códigos y cómo manejarlos
• Recetas — ejemplos de código para casos de uso reales
• Referencia OpenAPI — documentación interactiva de todos los endpoints