Entrar

Obtener token

GET https://{organization}.myguper.com/api/connect/token

Emite un nuevo token de acceso para una integración. Usa el par API Key + API Secret generado en el setup de la cuenta — no el token de usuario x-guper-authorization (este endpoint es el que lo produce). El accessToken devuelto se envía en cada petición posterior como x-guper-authorization.

Observe el expiresIn. Un token presentado después de ese momento es rechazado con 401 y Code: E0002 por todos los endpoints que reciben x-guper-authorization — llame de nuevo a este endpoint para obtener uno nuevo. Pedir un token nuevo antes de que expire el actual está permitido y no revoca el anterior.

Una credencial incorrecta responde 401. Después de 8 intentos fallidos para la misma llave e IP de origen, este endpoint responde 429 durante 15 minutos; los demás llamadores de la misma organización no se ven afectados.

Try-it values populated from environment ACME (Demo)


Autenticación

Apikey

Envía tus credenciales x-guper-apikey + x-guper-apisecret. No envíes x-guper-authorization — este endpoint es el que lo emite.

Encabezados

Name Type Description
Content-Type * string Always `application/json` for endpoints that accept a JSON body.
x-guper-apikey * string Identificador público de tu cuenta de integración (emitido por Guper).
x-guper-apisecret * string Secret de tu cuenta de integración. Trátalo como contraseña — nunca lo expongas en el navegador.

Respuestas

{
    "accessToken": "c074cb9bd30d7b431230877facb45e0a06790e93dea6a728cef9fdaf656bf349",
    "expiresIn":   "2023-08-11T15:13:00-03:00",
    "dateTime":    "2023-08-11T09:13:00-03:00"
}
Copied to clipboard