> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loja.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução à API

> Visão geral da API pública da loja.gg: storefront headless e integração com servidores de jogo.

A API pública da loja.gg cobre dois casos de uso: montar sua própria vitrine (storefront) e entregar automaticamente o que foi comprado dentro do seu servidor de jogo.

<CardGroup cols={2}>
  <Card title="Storefront headless" icon="layout-template" href="/api-reference/storefront-headless">
    API pública, autenticada por chave de API (`publishable`/`secret`), para quem quer montar sua própria vitrine consumindo catálogo, checkout e pedidos da loja.gg.

    **Base URL:** `https://api.loja.gg/storefront/v1`
  </Card>

  <Card title="Integração com servidores de jogo" icon="gamepad-2" href="/api-reference/fivem-redm">
    Como entregar produtos automaticamente dentro do servidor — FiveM, RedM ou qualquer outro engine — quando um pedido é pago.
  </Card>
</CardGroup>

## Quando usar cada uma

<Tabs>
  <Tab title="Use a API de storefront se...">
    Você quer construir a **vitrine pública** da loja (o site que o comprador visita) com uma stack própria — Next.js, WordPress, mobile — mantendo o catálogo, o carrinho e o checkout centralizados na loja.gg.
  </Tab>

  <Tab title="Use a integração de jogo se...">
    Você já vende pela vitrine padrão da loja.gg (ou pela sua própria, via storefront headless) e precisa que a compra vire algo dentro do jogo automaticamente — dar um item, VIP, dinheiro ou rodar um comando no servidor assim que o pedido é pago.
  </Tab>
</Tabs>

<Note>
  As duas coisas são independentes e combináveis: dá para montar uma vitrine própria com a API de storefront **e** entregar os produtos no servidor de jogo com a integração descrita aqui.
</Note>

## Formato de resposta e erros

A API de storefront retorna JSON com um formato estruturado de erro, com `type`, `code` e `request_id` — veja [Storefront headless](/api-reference/storefront-headless#6-erros).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Storefront headless" icon="layout-template" href="/api-reference/storefront-headless">
    Catálogo, checkout e pedidos para montar sua própria vitrine.
  </Card>

  <Card title="FiveM e RedM" icon="gamepad-2" href="/api-reference/fivem-redm">
    Entrega automática de produtos no servidor de jogo.
  </Card>
</CardGroup>