Nossa API é desenvolvida usando a arquitetura REST, com alguns poucos endpoints que misturam este conceito com ações a serem realizadas em nossas entidades.

Fique atento aos seguintes pontos quando estiver integrando conosco:

Ambiente

Nossa API é disponibilizada em ambiente de staging e produção, sendo que o ambiente de staging deve ser utilizado para o seu processo de desenvolvimento.

Abaixo, seguem as URLs de cada ambiente:

Status HTTP

Como em toda arquitetura REST, os status HTTP que retornamos nas requisições são importantes, e devem ser utilizados para entender qual foi o resultado de um pedido que você fez à nossa API.

Abaixo, listamos todos os status que são utilizados em nossa API e suas respectivas interpretações:

STATUS HTTPDESCRIÇÃO
200Os dados que você pediu estão no corpo da resposta
201Seu pedido para criar uma nova entidade deu certo, mais detalhes no corpo da resposta
400Algum parâmetro ou cabeçalho HTTP requerido está ausente
401O token que você enviou é inválido ou expirado
402Uma ou mais cobranças foram negadas
422Foi encontrado algum erro validando algum parâmetro do corpo da requisição
500Ocorreu algum erro na aplicação da API da Paggi
501O método HTTP que você usou não é implementado para o recurso solicitado
502Ocorreu um erro na infraestrutura da Paggi
503Ocorreu um erro na infraestrutura da Paggi

Representação de dados

Todos os dados trafegados de e para nossa API devem ser codificados como JSON.

Isto significa que todas as respostas devolvidos por nossa API serão representadas com um JSON.

Também significa que tudo que você nos enviar no corpo das suas requisições deverá está codificado em JSON, e estas requisições deverão conter o cabeçalho Content-Type com o valor application/json.