Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://pedirgasdocs.supergasbras.app/llms.txt

Use this file to discover all available pages before exploring further.

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 HTTPDescrição
401 UnauthorizedToken ausente ou inválido. Verifique se o cabeçalho Authorization está correto.
403 ForbiddenToken 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.