Voltar para Docs

Referencia da API REST

210+ endpoints cobrindo autenticacao, catalogo, carrinho, checkout, pagamentos, frete e administracao.

Base URL: https://api.venddor.com.brGraphQL Playground →
GETLeitura
POSTCriacao
PUTAtualizacao
PATCHParcial
DELETEExclusao

Autenticacao

Duas formas de autenticar — escolha a que combina com seu cliente.

A

Sessao de usuario (JWT)

Para acoes do usuario logado: carrinho, checkout, perfil. Faca login e use o access_token retornado.

  1. POST /api/v1/auth/login → access_token
  2. Envie em cada request:
Authorization: Bearer eyJhbGci...
B

Chave de API (apps e integracoes)

Para acesso server-to-server ao catalogo storefront. Mesma chave funciona em REST e GraphQL.

  1. Gere uma chave em /admin/api-keys (perfil admin)
  2. Envie em cada request:
X-API-Key: sfk_live_abc123...

Escopos: storefront:read, storefront:write, customer:read, customer:write

Endpoints retornam 403 missing_scope se a chave nao tem o escopo exigido.

Precisa de compatibilidade? Veja a API v1.0 Compat→