API pública: visão geral e chaves
A API da Menuthere permite que seu próprio PDV ou software atue na sua loja. O suporte da Menuthere cria uma chave para você com acesso a Orders, WhatsApp ou aos dois, e seu software chama os endpoints com ela. Uma chave só consegue ver e alterar os seus próprios dados.
- Onde
- Ask Menuthere support for a key
- Plano
- O painel não restringe as chaves de API por plano. Enviar modelos de WhatsApp também exige um número de WhatsApp conectado, o que começa no Pro.
- Tempo
- 5 min
- Atualizado
Crie e gerencie chaves
Passo 1: Peça uma chave ao suporte da Menuthere
As chaves de API ainda não estão no painel, então o suporte da Menuthere as cria. Diga ao suporte para que serve a chave, como “Billing POS”.
Passo 2: Escolha o acesso
Uma chave com acesso Orders pode atualizar o status dos seus pedidos. Uma com acesso WhatsApp pode enviar modelos de WhatsApp. Peça só o que o seu software precisa.
Passo 3: Guarde a chave na hora
Uma chave aparece uma vez, quando é criada. A Menuthere guarda só uma impressão digital, então ela não pode ser mostrada de novo. Coloque-a nas configurações do seu software imediatamente. Se perdê-la, peça ao suporte para revogá-la e criar outra.
Usar uma chave
Envie a chave como Authorization: Bearer ck_live_… a partir do seu servidor. Nunca a coloque em uma página de navegador nem em um app de celular, porque quem a ler pode alterar seus pedidos. Um exemplo de uma linha:
curl -X POST 'https://menuthere.com/api/v1/orders/ORDER_ID/status' -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d '{"status":"accepted"}'
| Endpoint | Acesso necessário | Página |
|---|---|---|
| POST /api/v1/orders/{order_id}/status | Orders | API: atualizar o status de um pedido |
| GET /api/v1/whatsapp/templates | API: listar e enviar modelos de WhatsApp | |
| POST /api/v1/whatsapp/send-template | API: listar e enviar modelos de WhatsApp |
| Status | Erro | Significado |
|---|---|---|
| 401 | missing_api_key, invalid_api_key | Nenhuma chave enviada, ou a chave está errada ou foi revogada. |
| 403 | scope_denied | A chave não tem o acesso de que este endpoint precisa. |
| 429 | rate_limited | Requisições demais neste minuto. Cada chave tem 120 por minuto por padrão. |
Perguntas
Uma chave pode ver os pedidos de outro restaurante?
Perdi minha chave. Podem mostrá-la de novo?
Relacionados
Não encontrou? Escreva para [email protected] ou fale com a gente no chat, das 9h às 21h.Central de ajudaPreçosmenuthere.com