Guia

Quickstart

Em 5 minutos você autentica e faz sua primeira chamada à API PDV+.

1

Obtenha suas credenciais

Solicite ao seu contato comercial PDV+ um usuário e senha de API com permissão na loja desejada.

2

Gere um token JWT

Faça um POST em /auth/token com suas credenciais. A resposta traz um token JWT a ser enviado no header Authorization das demais chamadas.

POST /auth/token
curl -X POST 'https://api.poscontrole.com.br/v3/auth/token' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "seu_usuario",
    "password": "sua_senha"
  }'
Resposta
{
  "token": "xxxxxx.yyyyyyy.zzzzzz",
  "expiresIn": 3600
}
3

Use o token nas chamadas

Adicione o header Authorization: Bearer <token> em todas as requisições.

GET /productcombos
curl 'https://api.poscontrole.com.br/v3/productcombos' \
  -H 'Authorization: Bearer xxxxxx.yyyyyyy.zzzzzz'
4

Próximos passos

  • Leia o guia de Autenticação para entender expiração e renovação do token.
  • Explore a Referência completa por área.
  • Confira o guia de erros e códigos HTTP.