50% de desconto com o código BLACKFRIDAY5020% de desconto com o código BLACKFRIDAY20
Integrações e APITodos os planos

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 Starter / 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"}'

EndpointAcesso necessárioPágina
POST /api/v1/orders/{order_id}/statusOrdersAPI: atualizar o status de um pedido
GET /api/v1/whatsapp/templatesWhatsAppAPI: listar e enviar modelos de WhatsApp
POST /api/v1/whatsapp/send-templateWhatsAppAPI: listar e enviar modelos de WhatsApp
StatusErroSignificado
401missing_api_key, invalid_api_keyNenhuma chave enviada, ou a chave está errada ou foi revogada.
403scope_deniedA chave não tem o acesso de que este endpoint precisa.
429rate_limitedRequisições demais neste minuto. Cada chave tem 120 por minuto por padrão.
Bom saberVocê pode ter até 10 chaves ativas. Peça ao suporte da Menuthere para revogar uma chave que não usa mais. Tudo o que a usa para de funcionar na hora, e uma chave revogada não pode ser restaurada.

Perguntas

Uma chave pode ver os pedidos de outro restaurante?
Não. Cada chave pertence a um restaurante. Toda requisição é verificada em relação a esse restaurante, então um pedido de outra conta é informado como não encontrado.
Perdi minha chave. Podem mostrá-la de novo?
Não. Só uma impressão digital é guardada. Peça ao suporte da Menuthere para revogar a chave antiga e criar uma nova, depois atualize seu software.

Não encontrou? Escreva para help@mail.menuthere.com ou fale com a gente no chat, das 9h às 21h.Central de ajudaPreçosmenuthere.com