Entrar

Obter token

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

Emite um novo token de acesso para uma integração. Usa o par API Key + API Secret gerado no setup da conta — não o token de usuário x-guper-authorization (esse endpoint é o que produz). O accessToken retornado é enviado em todas as requisições subsequentes como x-guper-authorization.

Olhe o expiresIn. Token apresentado depois daquele momento é recusado com 401 e Code: E0002 por todos os endpoints que recebem x-guper-authorization — chame este endpoint de novo para pegar um novo. Pedir token novo antes do atual expirar é permitido e não revoga o anterior.

Credencial errada responde 401. Depois de 8 tentativas falhas para a mesma chave e IP de origem, este endpoint responde 429 por 15 minutos; os outros chamadores da mesma organização não são afetados.

Try-it values populated from environment ACME (Demo)


Autenticação

Apikey

Envie suas credenciais x-guper-apikey + x-guper-apisecret. Não envie x-guper-authorization — este endpoint é o que emite.

Cabeçalhos

Name Type Description
Content-Type * string Always `application/json` for endpoints that accept a JSON body.
x-guper-apikey * string Identificador público da sua conta de integração (emitido pela Guper).
x-guper-apisecret * string Secret da sua conta de integração. Trate como senha — nunca exponha no browser.

Respostas

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