Pular para o conteúdo

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.

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

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.