> ## 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.

# Supergasbras Developer APIs: visão geral da plataforma

> Conheça as APIs Supergasbras para e-commerce de gás: Cart, Checkout e Composition. Saiba o que cada serviço faz e quando usá-lo.

A Supergasbras oferece um conjunto de APIs RESTful que permitem integrar a experiência de compra de gás diretamente na sua aplicação. Com as APIs Cart, Checkout e Composition, você gerencia todo o ciclo de vida de um pedido — do carrinho ao pagamento.

## APIs disponíveis

<CardGroup cols={3}>
  <Card title="Cart API" icon="cart-shopping" href="/api-reference/cart/overview">
    Cria e gerencia sessões de carrinho de compras, incluindo agendamento de entrega.
  </Card>

  <Card title="Checkout API" icon="bag-shopping" href="/api-reference/checkout/overview">
    Controla sessões de compra, cupons promocionais e pagamentos.
  </Card>

  <Card title="Composition API" icon="layer-group" href="/api-reference/composition/overview">
    Fornece ofertas recomendadas para consumidores e relatórios financeiros para revendedores.
  </Card>
</CardGroup>

## Fluxo geral de uma compra

Um pedido típico na plataforma Supergasbras segue este fluxo:

<Steps>
  <Step title="Sessão de carrinho">
    Crie ou atualize uma sessão de carrinho via Cart API com os produtos que o cliente deseja comprar.
  </Step>

  <Step title="Sessão de checkout">
    Inicie uma sessão de compra na Checkout API. Vincule a sessão de carrinho e defina os dados do cliente.
  </Step>

  <Step title="Entrega e cupons">
    Atualize as informações de entrega e aplique eventuais cupons promocionais à sessão de compra.
  </Step>

  <Step title="Pagamento">
    Liste os métodos de pagamento disponíveis, inicie o pagamento e complete a sessão.
  </Step>
</Steps>

## Ambientes

Todas as APIs utilizam HTTPS. As URLs base de produção são:

| API             | URL base                                  |
| --------------- | ----------------------------------------- |
| Cart API        | `https://cart-ms.supergasbras.app`        |
| Checkout API    | `https://checkout-ms.supergasbras.app`    |
| Composition API | `https://composition-ms.supergasbras.app` |

<Note>
  Certifique-se de incluir seu token de autenticação em todas as requisições. Veja [Autenticação](/authentication) para detalhes.
</Note>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Autenticação" icon="lock" href="/authentication">
    Configure seu token e aprenda a autenticar as requisições.
  </Card>

  <Card title="Início Rápido" icon="bolt" href="/quickstart">
    Faça sua primeira chamada de API com exemplos práticos.
  </Card>
</CardGroup>

# Titulo 1

dfhsaufhsufdifh

## sub1

dfsdfsd