Saltar al contenido
Docs

Referencia

Emitir llave de pruebas

POST/v1/partner/sandbox/api-key

SOLO LOCAL · Emite una api_key de partner sin pasar por el backoffice.

Siembra al partner de ejemplo y emite una llave real con ApiKeysAdminService.issue: vive 365 días, en base solo queda su sha256 y el secreto se muestra UNA vez, como en producción. Pedir scopes distintos es la forma de provocar los 403 de scope. Fuera de local/test esta ruta no existe (404).

Cuerpo de la petición

  • scopesarray de stringopcional

    por omisión me:read,ping:read

    Ejemplo: ["me:read","ping:read"]

Respuesta 200

Llave lista para pegar en «Authorize»

  • apiKeystring

    Pégalo en «Authorize» → api-key. Se muestra UNA vez: en base solo vive su sha256.

    Ejemplo: "slan_9fQ2xL…"

  • comoUsarstring

    Ejemplo

    "1) Copia `apiKey`. 2) «Authorize» → api-key (cabecera x-api-key). 3) Prueba GET /v1/partner/ping."
  • expiresAtstring

    Ejemplo: "2027-09-04T15:04:05.000Z"

  • Ejemplo: "01JKX7PTNR0000000000000004"

  • prefixstring

    Ejemplo: "slan_9fQ2xL"

  • scopesarray de string

    Ejemplo: ["me:read","ping:read"]

Errores

EstadoCódigosCuándo
429RATE_LIMITEDLimite de uso: 10 por minuto por IP, con bloqueo de un minuto al superarlo. Respeta la cabecera `Retry-After`.