Documentação
Migrar do API Legado
Prompt para inventariar o uso do API Legado e planejar a migração para a Nova API V1.0 com paridade e rollback.
Use este prompt quando o projeto já consome https://webhook.takeat.app,
faz login em /public/api/sessions ou chama rotas sob /api/v1. A primeira
resposta do agente é somente leitura: inventário, matriz de migração, riscos e
testes de paridade. Ele só implementa depois da sua aprovação.
Leia antes o guia Migrar do API Legado para entender a troca de e-mail e senha por API Key e o checklist de corte.
Prompt
Migrar uma integração do API Legado
Oi! Preciso da sua ajuda para migrar uma integração existente do API Legado
da Takeat para a Nova API V1.0.
Este projeto já consome https://webhook.takeat.app, faz login em
/public/api/sessions e pode chamar rotas sob /api/v1. A migração precisa
preservar o comportamento usado pelo produto e ter rollback. Não trate isso
como uma simples substituição global de URL ou prefixo.
A documentação oficial foi preparada para agentes:
https://docs.takeat.app/llms.txt (índice das páginas e contratos)
https://public-api.takeat.app/mcp (MCP unificado com OAuth)
Leia primeiro Migrar do API Legado e Autenticação com API Key. Depois,
encontre no llms.txt o contrato Markdown do API Legado e o contrato V1.0 de cada
operação encontrada no código. Trate os contratos publicados como fonte da
verdade. Não invente equivalências, campos, escopos ou endpoints.
Comece com uma análise somente leitura do projeto. Localize:
- a criação e renovação da sessão do API Legado;
- as variáveis de ambiente pelo nome, sem revelar seus valores;
- todas as chamadas a webhook.takeat.app e /api/v1;
- os campos de resposta realmente consumidos;
- caches, jobs, retries, logs, testes e regras de isolamento por restaurante.
Classifique cada chamada em uma tabela com: uso atual, contrato do API Legado, rota
V1.0 correspondente, escopo exigido, compatibilidade de resposta, mudanças
necessárias e bloqueios. Para /inputs e /intermediaries, confira os escopos e
a paginação da referência V1.0. Não substitua
/products por /menu sem justificar a mudança de semântica.
A autenticação da migração é por API Key. Onde hoje o projeto envia e-mail e
senha para /public/api/sessions e guarda o JWT de 15 dias, ele passa a usar uma
chave tk_test_ ou tk_live_ criada no AI Builders. No backend, troque essa chave
em POST /oauth/token com grant_type=api_key e api_key, sem client_id e sem
client_secret, e use o access token retornado como Bearer nas rotas /v1. A API
Key nunca vai diretamente para /v1. Renove com grant_type=refresh_token usando
o refresh token atual, que é rotativo: substitua-o atomicamente pelo novo valor
e proteja a renovação contra execuções concorrentes. Não proponha OAuth
Authorization Code nem PKCE nesta migração.
Proponha uma migração incremental com cliente HTTP isolado, configuração para
alternar API Legado e V1.0, testes de contrato, amostras controladas de paridade,
canário, observabilidade e rollback. Considere os limites publicados, cache,
backoff e renovação atômica do refresh token. Cada restaurante deve permanecer
isolado em credenciais, tokens, banco, cache e jobs.
Segurança é inegociável: não me peça e-mail, senha, API Key, JWT, access token,
refresh token ou header Authorization. Não abra, imprima nem altere arquivos
.env que possam conter segredos. Se encontrar um possível segredo no código,
informe somente arquivo e localização com o valor totalmente mascarado e
recomende rotação.
Na primeira resposta, não modifique o código. Entregue o inventário, a matriz de
migração, os riscos e lacunas, os testes de paridade e uma sequência de etapas
com critérios de aceite e rollback. Cite as URLs .md oficiais que sustentam
cada decisão. Espere minha aprovação antes de implementar.O que esperar
- Uma tabela com cada chamada atual, a rota V1.0 correspondente, o escopo e as diferenças de resposta.
- Um plano incremental com chave de configuração para alternar entre as APIs, canário e rollback.
- Nenhuma alteração de código até você aprovar.
Veja também
Integrar uma aplicação existente
Prompt para adicionar a Takeat a um projeto que já funciona, reaproveitando arquitetura, telas e infraestrutura.
Implementar access e refresh tokens
Prompt para implementar e testar o ciclo de tokens da API Key: troca, renovação antecipada, rotação atômica e recuperação de falhas.