Como faço para acessar API?

Os clientes que consomem dados da Fastmarkets normalmente possuem seus próprios serviços que irão consumir e processar os dados. Por esse motivo, a autenticação baseada nas credenciais de um único usuário não é apropriada. Em vez disso, a Fastmarkets emite uma "Service Key" e um "Service Name" exclusivos, que podem ser usados ao chamar a Fastmarkets Authentication API para gerar um "Access Token". O "Access Token" retornado (no formato de um JSON Web Token) é então necessário para todas as chamadas subsequentes às demais APIs da Fastmarkets (como a Fastmarkets Physical Prices API) para verificar se o serviço chamador tem as permissões necessárias para visualizar os dados solicitados.

A documentação técnica completa é fornecida por meio da nossa "Swagger UI", que requer acesso de um usuário técnico nomeado. Os detalhes do seu nome de usuário e senha serão enviados em um e-mail de boas-vindas. Assim que recebê-los, você pode clicar no botão "Authorize" no canto superior direito para fazer login.

Após a autorização, você poderá:

Testar requisições e respostas de cada "endpoint", encontrar valores de exemplo, descrições de campos e modelos de resposta da API, identificar mensagens de erro para cada "endpoint".

Você receberá um e-mail de boas-vindas com os detalhes do seu nome de usuário e senha como usuário técnico da API, o que fornecerá acesso ao "Swagger UI" para testar requisições e respostas. Para acessar e se autenticar na nossa API, forneceremos um "service name" e uma "service key" gerados automaticamente. O seu "service name" e a sua "key" podem então ser usados em aplicações como o Postman para autenticar e gerar um "access token" e, em seguida, chamar a nossa Physical Prices API a partir do seu sistema.

Quantos usuários técnicos podem ter acesso à interface do Swagger?

É necessário pelo menos um usuário técnico para gerenciar as chaves de serviço. No entanto, entendemos que muitos de nossos clientes precisam de vários usuários técnicos, sejam eles técnicos ou terceirizados, para testar solicitações e respostas durante a implementação, bem como para a manutenção regular de nossa API, o que pode exigir o suporte de vários membros da equipe em diferentes locais. Solicite usuários técnicos adicionais por meio de nossa página de contato. Vamos ajudá-lo(a) a obter assistência.

Caso algum dos seus usuários técnicos mude ou deixe a empresa, por favor, nos avise.

 

O "Service Name" e a "Service Key" serão alterados ou interrompidos quando o contrato for renovado?

Não, o "Service Name" e a "Service Key" permanecerão os mesmos na renovação. Não é necessário alterar nenhuma autenticação da API.

Como faço para regenerar a "Service Key"?

Caso precise que sua "Service Key" seja regenerada por motivos de segurança ou outros, entre em contato conosco. Vamos ajudá-lo (a).

Observe que a API ficará indisponível até que a nova chave seja inserida em seu sistema.

Outra área de negócios precisa acessar os preços Fastmarkets via API. Podemos implementar isso usando o mesmo "service name" e a "service key"?

As "service keys" não devem ser compartilhadas entre diferentes equipes ou divisões de negócio, por motivos de segurança e licenciamento. Entre em contato com o seu "Account Manager" ou com o time de "Customer Success", que poderá fornecer um "service name" e uma "service key" separados, conforme necessário.

.

 

Você possui um ambiente de teste?

Não dispomos de um ambiente de teste separado para a API de Preços Físicos. Em vez disso, recomendamos que teste a solicitação e a resposta usando nossa interface Swagger antes de conectar-se à versão de produção da API com sua "service key". Isso exigirá acesso de usuário nomeado e está disponível para todos os usuários técnicos da API. Caso precise de um "service name" de teste separado, entre em contato conosco — vamos ajudá-lo.

 

Você tem algum exemplo de solicitação?

Consulte os links abaixo para exemplos de requisição em JSON, C#, Java e Python.

Acesse aqui o Guia do Usuário da API de Preços Físicos Fastmarkets (versão JSON)
Acesse aqui o Guia do Usuário da API de Preços Físicos Fastmarkets (versão C#)
Acesse aqui o Guia do Usuário da API de Preços Físicos Fastmarkets (versão Java)
Acesse aqui o Guia do Usuário da API de Preços Físicos Fastmarkets (versão Python)

Quais são as limitações quanto ao número de consultas que podem ser feitas?

É possível solicitar grandes conjuntos de dados por meio da API de Preços Físicos, especificando vários símbolos e intervalos de datas. No entanto, existem limites para o que pode ser solicitado em uma única requisição à API. Esses limites são descritos a seguir:

OBTER/Preços
Número máximo de símbolos: 100
Datas máximas: 10 (se estiver solicitando os preços mais recentes, não há limite de datas)

OBTER Preços/Histórico
Número máximo de símbolos: 100
Período máximo: 2 anos

Observe que as séries históricas podem variar entre os símbolos, dependendo da data de lançamento. Para identificar o início da série temporal, consulte o campo “firstDate”, que pode ser solicitado nos endpoints GET/Instruments ou GET/Prices.

Como posso encontrar mais informações técnicas?

Nossa página de documentação técnica fornece informações técnicas detalhadas sobre a API de Preços Físicos. Isso inclui:
- Descrição do endpoint e dos parâmetros
- Exemplos de solicitações e respostas
- Informações do modelo com descrições detalhadas dos objetos de resposta
- Exemplos de códigos e mensagens de erro

Ajuda adicional

Se você tiver mais perguntas ou precisar de suporte adicional, consulte todo o conteúdo de ajuda disponível em nosso Hub de suporte.
Se você não encontrar o que precisa e quiser contatar nossas equipes de suporte, então vamos ajudá-lo(a).