Nova API V1.0 · Referência
Consultar avaliações do app conectado
O client_id do token e sua instalação identificam o app; não aceita ID de outro aplicativo. Exige OAuth PKCE de restaurante com instalação ativa, não expirada e app visível. Não exige escopo adicional. Sem restaurant_id, lista todas as avaliações do app. Com o filtro, lista e resumo incluem somente uma loja autorizada na conexão e nos vínculos atuais da rede. Retorna 10 avaliações por página, da mais recente para a mais antiga. IDs de contas e e-mails não são publicados. Avaliações excluídas logicamente não aparecem em data, ownReview, totais ou médias.
O client_id do token e sua instalação identificam o app; não aceita ID de outro aplicativo. Exige OAuth PKCE de restaurante com instalação ativa, não expirada e app visível. Não exige escopo adicional. Sem restaurant_id, lista todas as avaliações do app. Com o filtro, lista e resumo incluem somente uma loja autorizada na conexão e nos vínculos atuais da rede. Retorna 10 avaliações por página, da mais recente para a mais antiga. IDs de contas e e-mails não são publicados. Avaliações excluídas logicamente não aparecem em data, ownReview, totais ou médias.
Authorization
storeOAuth Access token de instalação OAuth Authorization Code + PKCE de app com perfil Restaurante. O client_id identifica o próprio app. Exige consentimento ativo, não expirado e app visível; não exige escopo adicional. API keys, client credentials, sessões humanas, MCP e autorizações de garçom não são aceitos.
In: header
Query Parameters
Loja autorizada nesta conexão. Em GET, filtra avaliações e resumo; omitir lista todas as avaliações do app. Em POST/DELETE, seleciona a loja autora; obrigatório quando o token autoriza várias. Vínculos atuais e consentimento limitam a seleção. Uma loja não autorizada retorna 403.
Response Body
application/json
application/json
application/json
application/json
Revogar um access token POST
Revoga antecipadamente um access ou refresh token. A operação é idempotente. Apps públicos `tk_app_...` enviam `client_id` e não possuem client secret. Para encerrar todas as sessões de uma API key, revogue a chave no AI Builders.
Criar ou atualizar avaliação do app conectado POST
O token identifica o app e as lojas autorizadas. Cria ou atualiza uma única avaliação por aplicativo e restaurante, retornando 200 nos dois casos. Se ela foi excluída logicamente, restaura o mesmo registro com a nova nota e comentário. Sem restaurant_id, infere a loja se o token autoriza somente uma; com várias lojas, o seletor é obrigatório. A nota e o comentário devem ser escolhidos pelo usuário antes do envio. O autor é o usuário do consentimento ou o dono registrado da rede, com acesso ativo verificado. Conexões sem esse usuário precisam passar novamente pelo consentimento. App e instalação são verificados e bloqueados na transação de gravação. Não exige escopo adicional e não aceita IDs de autor ou app no corpo.