Skip to main content
Las claves se crean en el panel de vendedor, en Vendedor → Claves API. Se muestran una sola vez y actúan en nombre de la cuenta hasta que se revocan.

​
Enviar la clave

La clave va en cada solicitud. No hay tokens intermedios por los que canjearla.
Solo HTTPS. Una clave que haya viajado por HTTP sin cifrar debe considerarse filtrada y sustituirse.

​
A qué llega una clave

Las ofertas del propio vendedor: listarlas (GET /v1/offers/my), crearlas, editarlas, gestionar unidades, despublicarlas y archivarlas. Todo lo que el panel protege con un segundo factor — cambiar el correo de la cuenta, los ajustes de 2FA, los retiros — queda fuera del alcance de una clave.

​
Lista de direcciones permitidas

Opcional. Si tu integración funciona desde direcciones fijas, indícalas al crear la clave (una dirección o una subred, hasta 16 entradas) y la clave se rechazará desde cualquier otro lugar. Una lista vacía significa cualquier dirección.

​
Límites de solicitudes

Superarlos devuelve 429. Es un rechazo temporal: espera y vuelve a intentarlo, la clave sigue siendo válida.

​
Rotar una clave

Una cuenta puede tener hasta 5 claves. Crea la sustituta antes de necesitarla: apunta tu integración a la nueva clave, comprueba que funciona y revoca la antigua. No hace falta que nada deje de funcionar entretanto.

​
Errores