GETAPI pública v1

Produtos (pública)

Lista produtos da loja para integradores. Escopo products:read.

GET/api/v1/products
AutenticaçãoChave de APIproducts:read.

Chave pública sk_... via Authorization: Bearer, com escopo.

Parâmetros de consulta

  • pageintegeropcional

    Página.

Cabeçalhos

  • Authorizationstringobrigatório

    Chave de API pública no formato Bearer sk_live_... (escopo por endpoint).

Requisição

curl "https://api.ecomplataforma.com.br/api/v1/products" -H "Authorization: Bearer sk_live_xxx"

Resposta200

200 OK
{
  "data": [ { "id": "p_12", "nome": "Camiseta Preta", "precoCents": 7990 } ],
  "pagination": { "page": 1, "limit": 20, "total": 58 }
}

Respostas de erro

401Chave inválida
401 Chave inválida
{ "error": { "code": "UNAUTHORIZED", "message": "Chave de API ausente ou inválida." } }
403Sem escopo
403 Sem escopo
{ "error": { "code": "FORBIDDEN", "message": "A chave não possui o escopo necessário." } }