Referência da API
Toda operação da especificação v23.0 da Meta é roteada e validada. Comportamento real quer dizer que o mock a simula com estado; as outras respondem com o próprio exemplo da Meta, válido contra o schema de resposta.
Convenções
- URL base:
http://localhost:3010/v23.0, o mesmo caminho da Meta. - Autenticação:
Authorization: Bearer <qualquer token>. Uma chamada sem token é recusada, como na Meta. - Erros: o envelope da Meta,
{"error":{"message","type":"OAuthException","code","error_data","fbtrace_id"}}, com os códigos da Meta. - Webhooks: o corpo
entry[].changes[]da Meta, assinado comx-hub-signature-256quandoWEBHOOK_SECRETestá definido. - Versões: cada versão da Graph é a sua própria especificação; uma nova é uma nova pasta
spec/<versão>.
A aba API do painel traz as mesmas operações, com um curl pronto para cada uma.
As operações da v23.0
Abra uma operação para ver os parâmetros, os exemplos de requisição da especificação da Meta e cada resposta com o seu exemplo, erros incluídos.
Headers de teste
O que só um teste precisa vai em headers opcionais, nunca no corpo, para o corpo continuar sendo o que a Cloud API espera.
| Header | Em | O que faz |
|---|---|---|
X-Mock-From | POST /{phone}/messages, /calls | A chamada sai do celular do usuário: uma mensagem, uma confirmação, uma ligação |
X-Mock-Contact-Name | idem | O nome de perfil que o seu webhook vê |
X-Mock-Message-Status | uma confirmação com X-Mock-From | delivered, read ou failed |
X-Mock-Template-Review | criar e editar template | APPROVED (padrão), REJECTED, PAUSED, DISABLED, PENDING |
X-Mock-Template-Review-Reason | idem | O motivo no webhook de status |
X-Mock-Template-Review-Delay | idem | Quanto a revisão demora, em ms (até 10 minutos) |
X-Mock-Skip-Callback-Verification | webhook por número | Aceita a URL sem a verificação hub.challenge |
As rotas /settings
Só para o que a Meta não tem endpoint: os ajustes do próprio mock (modo de entrega, atraso do webhook), o log de eventos, todas as conversas, a árvore de contas com o código que um número espera, e as ligações. Abra uma rota para ver o que ela recebe e o que responde: toda resposta abaixo, erros incluídos, foi capturada de uma execução da imagem.