Autenticar requisições na API Supergasbras

Todas as APIs Supergasbras utilizam autenticação via token Bearer. Você precisa incluir seu token de acesso no cabeçalho Authorization em todas as requisições.

Obter o token de acesso

Entre em contato com a equipe Supergasbras ou acesse o portal para gerar suas credenciais de API. Você receberá um token Bearer para usar nos seus ambientes de desenvolvimento e produção.

Nunca exponha seu token de acesso em código-fonte público, logs ou respostas de API. Armazene-o em variáveis de ambiente seguras.

Como usar o token

Inclua o token no cabeçalho Authorization de cada requisição usando o esquema Bearer:

Authorization: Bearer SEU_TOKEN_AQUI

Exemplo com cURL

curl -X GET "https://cart-ms.supergasbras.app/v1/sessions/{sessionId}" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json"

Exemplo com JavaScript (fetch)

const response = await fetch(
  'https://cart-ms.supergasbras.app/v1/sessions/SESSION_ID',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer SEU_TOKEN_AQUI',
      'Content-Type': 'application/json'
    }
  }
);
const data = await response.json();

Exemplo com Python (requests)

import requests

headers = {
    'Authorization': 'Bearer SEU_TOKEN_AQUI',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://cart-ms.supergasbras.app/v1/sessions/SESSION_ID',
    headers=headers
)
data = response.json()

Erros de autenticação

Código HTTP	Descrição
`401 Unauthorized`	Token ausente ou inválido. Verifique se o cabeçalho `Authorization` está correto.
`403 Forbidden`	Token válido, mas sem permissão para o recurso solicitado.

Use variáveis de ambiente para armazenar seu token. Por exemplo: export SUPERGASBRAS_TOKEN="seu_token_aqui" e referencie como Bearer $SUPERGASBRAS_TOKEN nas chamadas.

Introdução

Conceitos

Guias

Autenticar requisições na API Supergasbras

Obter o token de acesso

Como usar o token

Exemplo com cURL

Exemplo com JavaScript (fetch)

Exemplo com Python (requests)

Erros de autenticação

​Obter o token de acesso

​Como usar o token

​Exemplo com cURL

​Exemplo com JavaScript (fetch)

​Exemplo com Python (requests)

​Erros de autenticação

Obter o token de acesso

Como usar o token

Exemplo com cURL

Exemplo com JavaScript (fetch)

Exemplo com Python (requests)

Erros de autenticação