Documentação
A API de Parceiros do BackResto, de ponta a ponta. Comece pelo guia rápido se já tiver uma chave.
Primeiros passos
O que é a API de Parceiros e como fazer a sua primeira chamada.
Introdução
O que a API de Parceiros do BackResto expõe hoje, o que deliberadamente não expõe, e quem decide.
Obter uma chave
Como pedir uma chave da API de Parceiros, o que incluir no pedido e o que recebe de volta.
Guia rápido
De uma chave a uma entrega e a um registo de coleção em cinco minutos, com curl.
Conceitos essenciais
Autenticação, erros, paginação e limites de pedidos.
Autenticação
Chaves de parceiro, os vinte e seis âmbitos, o que significa uma concessão, e como rodar sem interrupção.
Erros
Um documento de problema legível por máquina para cada falha, e o que cada tipo significa para a sua lógica de repetição.
Paginação e intervalos de tempo
Como percorrer as entregas e os registos de uma coleção com um cursor opaco, e porque é que uma recebe um intervalo de tempo e a outra não.
Limites de pedidos
O orçamento por chave, o único cabeçalho que o descreve, e como ficar abaixo dele.
Recursos
Os endpoints, campo a campo.
Entregas
O registo de receção de mercadorias — cada campo, o seu tipo, e o que significa no terreno.
Fotografias das entregas
As imagens tiradas na receção, servidas como URL assinados que expiram ao fim de quinze minutos.
Coleções e registos
Os vinte e quatro tipos de registo para além das entregas — o envelope de instantâneo que partilham, o que é um instantâneo, e como percorrer um.
Agentes e MCP
Ligue o BackResto a um cliente de IA através de MCP.
Servidor MCP
Ligue o Claude, o Cursor, o Codex ou qualquer cliente MCP aos registos de conformidade de um restaurante com um URL e a sua chave de API.
Suporte
Versionamento, limites dos dados atuais e como falar connosco.
Suporte e completude dos dados
O que os dados atuais cobrem e não cobrem, como a API é versionada, e como falar com uma pessoa.