Primeiros passos

A mesma API /api/v1/* aceita dois modos de autenticação. Escolha pelo que você está construindo:

• Token de API da loja — o próprio lojista gera um token no painel e cola no seu sistema. É o mais rápido: sem conta de integrador, sem App e sem tela de consentimento. Ideal para conectar uma loja ao seu ERP, PDV ou planilha. Veja Token de API da loja.
• OAuth 2.0 — você publica um App que muitas lojas instalam. Cada lojista clica em “Conectar Sellit”, autoriza, e você recebe um token por loja. Exige conta de integrador e um App registrado (passo a passo abaixo). Veja OAuth 2.0.

Não precisa de conta de integrador nem de App. O lojista gera o token no painel dele, em Configurações → Integrações → Tokens de API, e te entrega o valor sellit_sk_…. Você o envia no header Authorization: Bearer em cada chamada — nada mais é necessário.

1. •

   1. Crie sua conta de integrador

   Acesse docs.sellit-br.com/signup e cadastre-se com nome, e-mail e senha. Essa é a conta de desenvolvedor/integrador, separada da conta de lojista.

   Não confunda com app.sellitbr.com/signup, que é para criar uma loja. A conta de integrador (e o registro do App) fica no portal de desenvolvedores, em docs.sellit-br.com.
2. •

   2. Registre um App

   Em docs.sellit-br.com/dashboard/apps, clique em Novo App. Informe um nome, as URLs de redirecionamento (callback) e marque os escopos que seu App vai solicitar.

   Durante o desenvolvimento, você pode registrar http://localhost:PORT/callback como redirect URI. A URL deve ser exatamente igual à enviada no parâmetro redirect_uri do fluxo OAuth — qualquer diferença (barra final, maiúsculas) causa erro.
3. •

   3. Guarde o Client ID e gere uma secret

   Após criar, você verá o client_id do App. Clique em Gerar nova secret para obter uma client_secret. Você pode ter mais de uma secret e revogá-las quando quiser.

   A secret é exibida apenas uma vez. Copie e guarde com segurança — ela não pode ser recuperada depois.
4. •

   4. Implemente o fluxo OAuth

   Com client_id e client_secret em mãos, siga o guia de Autenticação OAuth 2.0 para obter o token de acesso de uma loja.