Autenticação - CentralCart

A API da CentralCart é autenticada por chave de API. Cada chave pertence a uma loja, carrega apenas as permissões que você marcou e pode ser revogada sozinha, sem derrubar as outras integrações.

Criar uma chave

Acesse Configurações > Integrações.
Abra a página da integração que você vai usar e clique em Gerar chave.
Marque as permissões que a integração precisa.
Copie a chave. Ela aparece uma única vez. Se perder, crie outra.

Usar a chave

Envie a chave no header Authorization, como token Bearer:

curl https://api.centralcart.io/v1/app \
  -H 'Authorization: Bearer cc_sk_sua_chave_aqui'

A chave já identifica a loja, então você não precisa enviar x-store-domain nas rotas de /v1/app.

Quando falta permissão

A chave é válida, mas não tem o escopo da rota. A resposta é 403 e diz qual permissão faltou:

{
  "errors": [
    {
      "message": "Esta credencial não tem permissão para esta operação. Escopo necessário: orders:approve."
    }
  ]
}

Não repita a requisição. Edite a chave no painel para incluir a permissão, ou crie outra chave. Veja Erros para os demais status.