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

# Introdução

> A Ticto API v2 permite criar e gerenciar produtos e ofertas programaticamente. Integre sua central, ERP ou plataforma diretamente à Ticto.

A Ticto API v2 é a interface de integração pública da Ticto que permite criar e gerenciar **produtos** e **ofertas** diretamente via código. Com ela, você conecta sua central, ERP ou sistema interno à Ticto sem precisar acessar o painel manualmente para cada operação.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Faça sua primeira chamada à API em minutos
  </Card>

  <Card title="Autenticação" icon="key" href="/authentication/overview">
    Gere seu token e aprenda a autenticar requisições
  </Card>

  <Card title="Criar Produto" icon="box" href="/guides/create-product">
    Guia passo a passo para criar seu primeiro produto
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/produtos/listar-produtos">
    Referência completa de todos os endpoints
  </Card>
</CardGroup>

## O que você pode fazer

**Escrita**, para criar recursos por código:

* **Produtos**: cursos, ebooks, mentorias, consultorias e outros produtos digitais
* **Ofertas**: preços, forma de cobrança (única ou recorrente) e métodos de pagamento de cada produto

**Leitura**, para consultar seus dados (paridade com a API v1, para quem está migrando):

* **Pedidos**, **Assinaturas** e **Saques**: histórico, resumo e detalhe por recurso

Na escrita, você envia apenas os campos essenciais. Os \~80 campos internos de uma oferta são preenchidos automaticamente pelos padrões da Ticto, a partir de um preset seguro por tipo de produto.

## Como funciona

<Steps>
  <Step title="Gere um token de API">
    Acesse o painel da Ticto, navegue até **Integrações → API v2** e crie um token com os escopos necessários.
  </Step>

  <Step title="Autentique suas requisições">
    Passe o token no header `Authorization: Bearer` em cada chamada à API.
  </Step>

  <Step title="Crie produtos e ofertas">
    Use os endpoints `/api/v2/products` e `/api/v2/products/{hash}/offers` para criar e listar seus recursos.
  </Step>

  <Step title="Comece a vender">
    Produtos criados via API nascem **aprovados e ativos**, prontos para vender. Envie `is_active: false` se quiser prepará-los antes de divulgar e ativá-los depois no painel.
  </Step>
</Steps>

## Bases da API

<CardGroup cols={3}>
  <Card title="Ambientes" icon="flask" href="/concepts/environments">
    Sandbox e produção
  </Card>

  <Card title="Idempotência" icon="rotate" href="/concepts/idempotency">
    Retries seguros sem duplicação
  </Card>

  <Card title="Erros" icon="triangle-exclamation" href="/concepts/errors">
    Formato de erro e códigos HTTP
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.