Visão geral da autenticação da API Fastmarkets
Aprenda como navegar e implementar a autenticação da API Fastmarkets para acesso seguro e eficiente aos dados.
Table of Contents
As APIs Fastmarkets utilizam OAuth 2.0 com fluxo de credenciais do cliente. A autenticação é realizada através da API de Autenticação Fastmarkets para obter um token de acesso, que é então transmitido nas requisições da API de dados como um cabeçalho HTTP.
O mesmo modelo de autenticação e as mesmas credenciais são usados nas APIs de Physical Prices, Marked Data, News e Analytics. Uma vez autenticado, o token de acesso pode ser reutilizado em todas as APIs compatíveis.
Ponto de extremidade de autenticação
https://auth.fastmarkets.com/connect/token
Parâmetros de autenticação necessários
| Parâmetro | Valor | Descrição |
|---|---|---|
| grant_type |
servicekey |
Tipo de concessão de acesso - servicekey para uso na API |
| client_id |
service_client |
Tipo de cliente de acesso - service_client para uso da API |
| scope |
<string> |
Cadeia de escopos concatenados, separados por espaços, para acesso combinado: fastmarkets.news.api fastmarkets.search.api para API de News fastmarkets.analytics.api para API de Analytics |
|
serviceName |
<string> | Fornecido por Fastmarkets |
| serviceKey | <string> | Fornecido por Fastmarkets |
As mesmas credenciais e o mesmo token podem ser usados para as APIs de Physical Prices, Marked Data, News e Analytics.
Exemplo Authentication request (cURL):
curl --location "https://auth.fastmarkets.com/connect/token" --data-urlencode "grant_type=servicekey" --data-urlencode "client_id=service_client" --data-urlencode "scope=fastmarkets.physicalprices.api" --data-urlencode "serviceName=yourServiceName" --data-urlencode “serviceKey=AskdjcORI2309/Cl...ajni”
A resposta inclui um token de acesso que deve ser passado em solicitações de API subsequentes:
Authorization: Bearer <access_token>
Limites de autenticação e ciclo de vida do token
Limites de solicitações de autenticação:
- Máximo: 10 solicitações de autenticação a cada 5 minutos
- Solicitações excessivas de tokens podem ser rejeitadas.
Devido a essa limitação, a reutilização de tokens é essencial ao trabalhar com o Power BI.
Considerações sobre o ciclo de vida do token:
- Os tokens de acesso têm validade limitada (2 horas).
- Os tokens expiram e precisam ser renovados.
- O Power BI não mantém sessões de longa duração entre atualizações.
As soluções do Power BI devem evitar solicitar um novo token a cada execução de consulta.