Erros e limites
Os erros seguem o formato do OData:
{ "error": { "code": "consulta_invalida", "message": "Propriedade desconhecida em apontamentos: hora." } }A message explica o problema em português e pode ser mostrada ao usuário.
Códigos
Seção intitulada “Códigos”| HTTP | code |
O que fazer |
|---|---|---|
| 400 | consulta_invalida |
Corrija a consulta: a mensagem diz o que está errado |
| 401 | nao_autenticado |
Envie um token válido. No Power BI, use a aba Básico |
| 403 | sem_permissao |
O IP não está na lista do token, ou a organização não tem a OpenAGROs |
| 403 | sem_escopo |
O token não tem o escopo desta tabela. Crie um com o domínio certo |
| 404 | nao_encontrado |
Tabela, endereço ou chave que não existe |
| 409 | erp_nao_configurado |
Os dados da organização ainda não foram ligados. Fale com o suporte |
| 429 | limite_excedido |
Limite por minuto atingido. Espere Retry-After segundos |
| 501 | nao_suportado |
$expand, $apply, $search ou $compute: relacione no seu modelo |
| 502 | erro_de_dados |
Não foi possível ler estes dados. Se repetir, fale com o suporte |
| 503 | erp_ocupado, erp_indisponivel |
Base ocupada ou fora do ar. Tente de novo em instantes |
| 504 | tempo_esgotado |
A consulta passou de 15 segundos. Filtre um período menor |
Limites
Seção intitulada “Limites”Cada token tem um limite de requisições por minuto, de até 240. Toda resposta informa o saldo do minuto:
| Cabeçalho | Significado |
|---|---|
RateLimit-Limit |
Requisições por minuto deste token |
RateLimit-Remaining |
Quantas ainda cabem neste minuto |
RateLimit-Reset |
Segundos até o minuto virar |
Os mesmos valores também vêm com o prefixo X- (X-RateLimit-Limit…). Ao passar do limite, a
resposta é 429 com Retry-After.
Cada consulta tem até 15 segundos. Uma tabela grande sem filtro de data pode passar disso: filtre um período ou deixe o Power BI paginar.