Documentação pública

Integre com o ecossistema Peter Tecnet.

Esta é a documentação inicial da API pública Peter Tecnet. Ela apresenta a base de integração, os recursos de acesso aberto e o padrão de autenticação usado nas operações protegidas.

Primeiros passos

Todas as integrações partem da URL base abaixo e utilizam JSON como formato principal de troca de dados.

https://api.petertecnet.com.br/api HTTPS

Exemplo de leitura pública

curl --request GET \
  --url https://api.petertecnet.com.br/api/establishment \
  --header 'Accept: application/json'

Autenticação

A API pode ser utilizada publicamente, mas operações que acessam dados privados ou alteram recursos continuam protegidas. Quando o endpoint exigir autenticação, envie o token no cabeçalho Authorization.

Authorization: Bearer SEU_TOKEN
Accept: application/json
Content-Type: application/json

Acesso público não significa acesso irrestrito: permissões, escopo do usuário, contexto da aplicação e limites de requisição continuam sendo aplicados no servidor.

Recursos disponíveis

Identidade e contasCadastro, login, Google, perfil e sessão.

EstabelecimentosDescoberta, consulta e dados de empresas e operações.

Catálogo e itensProdutos, serviços, menus e recursos comerciais.

Pedidos e atendimentoFluxos de pedido, acompanhamento e registros de serviço.

Eventos e ingressosEventos, produções e recursos de ticketing.

ConteúdoNotícias e recursos de descoberta consumidos pelas plataformas.

Alguns endpoints públicos

Os exemplos abaixo são pontos de entrada de leitura já disponíveis. A documentação será ampliada progressivamente com schemas, filtros e exemplos de resposta.

GET/api/establishment

GET/api/item/index

GET/api/event

GET/api/ticket

GET/api/news

Boas práticas de integração

Use HTTPSNunca envie tokens ou dados de usuário por conexões inseguras.

Respeite rate limitsImplemente cache, backoff e evite polling desnecessário.

Não exponha tokensCredenciais sensíveis não devem ficar em URLs, logs ou código público.

Prepare-se para evoluçãoPrefira recursos versionados e integrações desacopladas de uma plataforma específica.