Este artigo ajuda você a identificar, entender e resolver problemas comuns ao integrar o Power BI com as APIs Fastmarkets . Ele aborda erros específicos da API Fastmarkets , problemas específicos do Power BI e limitações conhecidas, com orientações práticas sobre como solucionar problemas rapidamente.

Como pensar sobre erros na integração do Power BI?

Quando algo quebra, a causa principal geralmente se enquadra em uma destas categorias:

• Problemas de acesso ao instrumento (autorizações, símbolos incorretos)
• Problemas na construção da solicitação (parâmetros ausentes ou inválidos)
• Problemas de autenticação (limites de taxa, chaves expiradas, nome de serviço incorreto)
• Problemas de configuração do Power BI (níveis de privacidade, avisos do conector, versões desatualizadas)

Muitos erros da API Fastmarkets são retornados com HTTP 200 OK, mas contêm objetos de erro embutidos. O Power BI pode continuar tratando essas chamadas como bem-sucedidas, a menos que você verifique explicitamente o conteúdo da resposta. Sempre inspecione a resposta JSON em busca de `invalidInstruments` .

API Fastmarkets - Erros comuns e como corrigi-los

200 OK with inline Forbidden

Causa : Sua conta de API não tem acesso ao instrumento solicitado.

"invalidInstruments": [
        {
            "symbol": "FP-PLP-0001",
            "error": "Forbidden",
            "message": "You do not have access to instrument 'FP-PLP-0001'."
        }
    ]

Isso acontece quando sua chave de API não tem permissão para acessar o conjunto de dados solicitado.

Como corrigir:

• Verifique a sua elegibilidade para o instrumento no seu contrato Fastmarkets e solicite ao suporte Fastmarkets que restabeleça o seu acesso.
• Remova os instrumentos restritos da sua consulta do Power BI.

200 OK with Inline NotFound

Causa : O símbolo do instrumento não existe ou está digitado incorretamente.

"invalidInstruments": [
        {
            "symbol": "FP-PLP-0001123",
            "error": "NotFound",
            "message": "Instrument 'FP-PLP-0001123' does not exist."
        }
    ] 

Isso ocorre quando há um erro de digitação no símbolo ou quando o símbolo está desatualizado/desativado. O mesmo erro pode aparecer na API de Dados de Mercado ou na API de Notícias para IDs de Artigo inválidos.

Como corrigir:

• Valide os símbolos comparando-os com a documentação oficial Fastmarkets
• Evite a entrada manual de símbolos sempre que possível.
• Centralizar listas de instrumentos como parâmetros do Power BI

400 Bad Request - Missing Required Parameter 

Causa : Um parâmetro de consulta obrigatório não foi incluído.

 "invalidParameters": [
        {
            "parameter": "Ids",
            "error": "Missing",
            "message": "Missing required parameter 'Ids'"
        }
    ]

Por que isso acontece:

• Consulta criada dinamicamente no Power Query (M)
• O nome do parâmetro diferencia maiúsculas de minúsculas.
• Valor vazio passado de um parâmetro do Power BI

Como corrigir:

• Confirme os parâmetros necessários para o endpoint.
• Valide os valores dos parâmetros antes de executar a solicitação.
• Adicionar verificações defensivas no código M (por exemplo, impedir listas vazias)

Authentication 400 Bad Request - Invalid credentials

Causa : Credenciais incorretas fornecidas na solicitação de autenticação.

Isso ocorre quando o nome do serviço ou a chave do serviço são digitados incorretamente. Copie as credenciais diretamente da fonte e teste a autenticação separadamente antes de usar o Power BI (verificação com cURL, Postman etc.).

Authentication 400 Bad Request - Authentication Rate Limit

Causa : Muitas solicitações de autenticação em um curto período de tempo.

{
    "error": "invalid_request",
    "error_description": "You have exceeded the maximum number of 10 authentication requests within 5 minutes. Please try again later"
}

Por que isso acontece:

• Atualizando credenciais em várias consultas do Power BI
• Solicitação de token incorporada diretamente em cada consulta.
• Atualizações frequentes do conjunto de dados durante o desenvolvimento.

Como corrigir :

• Autentique-se uma vez e reutilize o token em várias consultas: consulte a abordagem de Conexão do Power BI.
• Evite chamar o endpoint de autenticação dentro da lógica de nível de linha.
• Durante o desenvolvimento, desative as atualizações automáticas desnecessárias.

401 Unauthorized - Get Data Fails

Possíveis causas:

• O escopo de API necessário está faltando.
• Token expirou e não foi renovado.

Como corrigir:

• Verifique os escopos da API específica (Preços Físicos vs Notícias vs Dados de Mercado)
• Regenerar token de acesso à API se expirado
• Certifique-se de que a lógica de atualização do token esteja implementada.

Problemas e soluções específicas do Power BI

“Please Specify How to Connect” Error

Causa : O Power BI não consegue conciliar as fontes de dados devido a conflitos de nível de privacidade ou tratamento inconsistente de autenticação.

Como corrigir :

1. No Power BI Desktop, acesse Arquivo → Opções e configurações → Configurações da fonte de dados
2. Selecione cada endpoint da API Fastmarkets - endpoints de autenticação e dados.
3. Clique em Editar permissões para cada fonte.
4. Defina o nível de privacidade para o mesmo valor (recomendado: Organizacional).
5. Aplicar e concluir
6. Reinicie o Power BI Desktop.

Verificações adicionais:

• Use a versão mais recente do Power BI Desktop.
• Garanta que todas as chamadas de API usem a mesma URL base.
• Evite misturar chamadas anônimas e autenticadas.

Outros erros comuns no Power BI

Lista de verificação para resolução de problemas

• Verificar a titularidade do instrumento
• Confirme os símbolos do instrumento.
• Verifique os parâmetros de consulta necessários.
• Evite chamadas de autenticação repetidas.
• Alinhar os níveis de privacidade do Power BI
• Inspecione as respostas JSON em busca de erros embutidos.