Saltar al contenido principal
Cada llamada a la API se identifica con una clave que creás en tu panel. La clave actúa en nombre de tu cuenta: crea pedidos que se te cobran. Tratala como una contraseña.

Crear una clave

  1. Entrá a tu panel de Gudink, sección Integraciones > API (/integraciones/api). Necesitás el email verificado. No hace falta pedir acceso: la API es gratis y la clave la creás vos.
  2. Creá una clave con un nombre que te diga dónde la usás, por ejemplo “mi web producción”.
  3. Copiala en ese momento. Se muestra una sola vez. Si la perdés, revocala y creá otra.
Después del prefijo vienen 40 caracteres entre a-z y 0-9. La misma clave sirve para probar y para vender: un pedido de prueba no se produce ni se cobra hasta que lo pagás (ver Probar sin pagar). Podés tener hasta 5 claves activas por cuenta. Cada clave nueva te manda un mail de seguridad.

Cómo cuidarla

  • Sólo en tu servidor. Nunca en un navegador, en una app móvil ni en código que corra en el dispositivo de tu comprador. La API no tiene CORS, a propósito: se usa de servidor a servidor.
  • Nunca en un repositorio, aunque sea privado. Usá una variable de entorno o un gestor de secretos.
  • Nunca en la URL. Sólo en la cabecera Authorization.
  • Nunca en una descarga de imagen. Las imágenes de los productos son públicas y se bajan sin clave.
  • Nunca en el chat con un agente de IA. Pasale el nombre de la variable de entorno, no el valor.
  • Si creés que se filtró, revocala desde el panel. Es inmediato.

Cuándo se revocan solas

Para protegerte, Gudink revoca todas tus claves y desactiva tus destinos de avisos cuando cambia quién controla la cuenta: si se resetea o cambia la contraseña, si se confirma un cambio de email, si la cuenta se desactiva o si se apaga el acceso a la API. Después de cualquiera de esos casos, creá claves nuevas. Cuando pasa por un cambio de contraseña o de email, o porque se apagó el acceso, te llega un mail avisándote. Hasta que cargues la clave nueva en tu servidor, tu integración recibe 401 invalid_api_key: si cambiás la contraseña de tu cuenta, acordate de la API.

Cómo se manda

Toda ruta lleva esta cabecera, salvo GET /openapi.json y GET /llms.txt, que se leen sin clave:
Los ejemplos usan dos variables de entorno:
Para comprobar que anda:
billing_complete dice si tu cuenta tiene los datos de facturación que hacen falta para crear pedidos. Si es false, POST /orders responde 403 billing_data_required hasta que los completes en tu panel. missing_billing_fields dice cuáles faltan, con los mismos nombres que usa ese error en details.missing_fields:

Qué responde cuando la clave no sirve

No reintentes un 401 en bucle: la clave no va a empezar a funcionar sola, y demasiados intentos fallidos seguidos terminan en 429 por unos minutos. Una clave válida sigue entrando igual. Estos códigos sólo cuentan cuando la respuesta es JSON y trae el sobre { "error": { ... } }.

Un 403 que no es JSON no es tu clave

Si recibís un 403 con un texto o una página en vez de JSON (por ejemplo error code: 1010), es un bloqueo de la red que está delante de la API, no de la API: tu clave no tiene nada que ver, y no es api_access_disabled. Pasa incluso en GET /llms.txt, que no lleva clave.
  • Casi siempre es el User-Agent que tu librería manda por defecto (pasa con urllib de Python).
  • Mandá una cabecera User-Agent propia en cada llamada, por ejemplo MiTienda/1.0 (+https://mitienda.com), y repetí.
  • Si sigue, escribinos a soporte@gudink.com con la hora y tu IP.
Ver Respuestas que no son de la API. La tabla completa de errores, con qué trae cada uno, está en Errores y límites.