Automatizar o Acesso à API

Para que os seus sistemas possam se comunicar de forma automatizada com a nossa API da Feature Store, utilizamos a autenticação M2M (Machine to Machine). Preparamos este guia para mostrar como você pode utilizar as credenciais fornecidas pela nossa equipe para gerar seus tokens de acesso de forma segura e rápida!

1. Suas Credenciais de Acesso

A nossa equipe de suporte e implantação realizará o cadastro da sua aplicação em nossos servidores. Após essa configuração, você receberá de forma segura as seguintes credenciais:

• Domain (O endereço de autenticação)
• Client ID (O identificador da sua aplicação)
• Client Secret (A chave secreta da sua aplicação)

🔒 Aviso Importante de Segurança: O seu Client ID e, principalmente, o seu Client Secret são informações extremamente sensíveis. Elas funcionam como o "login e senha" do seu sistema para acessar a nossa plataforma. Certifique-se de armazená-las em variáveis de ambiente seguras ou em cofres de senhas, e nunca as exponha em repositórios públicos de código.

2. Entendendo o Ciclo de Vida do Token

Para realizar chamadas na API da Feature Store, você precisará trocar suas credenciais por um Token de Acesso (Access Token).

• O tempo padrão de expiração de um token gerado é de 10 horas.
• Para otimizar o desempenho da sua aplicação e evitar bloqueios, seu sistema deve reutilizar esse mesmo token durante este período, solicitando um novo apenas quando o atual expirar,
• 🚨 Atenção: Múltiplas requisições de token não são permitidas. A solicitação de um novo token antes do prazo de expiração (10 horas) resultará na queda imediata da sua conexão M2M.

3. Exemplo Prático de Código em Python

Abaixo, disponibilizamos exemplos práticos de como o seu sistema pode solicitar o token e, em seguida, consumir os dados da nossa Feature Store.

Passo A: Obtendo o Token de Acesso

Python

import requests

# Substitua pelo domínio fornecido pela nossa equipe
url = "https://4intelligence.auth0.com/oauth/token" 

payload = {
    "client_id": "SEU_CLIENT_ID",
    "client_secret": "SEU_CLIENT_SECRET",
    "audience": "4casthub",
    "grant_type": "client_credentials",
}
headers = {"Content-Type": "application/json"}

try:
    response = requests.post(url, json=payload, headers=headers)
    response.raise_for_status() # Lança um erro se a resposta falhar
    
    token_data = response.json()
    access_token = token_data.get("access_token")
    print("Token obtido com sucesso!")
    
except requests.exceptions.RequestException as e:
    print(f"Erro ao obter o token: {e}")

Passo B: Fazendo uma requisição na Feature Store Com o access_token em mãos, você já pode acessar nossos indicadores:

Python

import requests

url = "https://apis.4intelligence.ai/api-feature-store/api/v1/indicators"

# Passamos o token obtido no cabeçalho de Autorização
headers = {
    'Authorization': f'Bearer {access_token}',
    'Content-Type': 'application/json'
}

try:
    response = requests.get(url, headers=headers)
    if response.status_code == 200:
        data = response.json()
        print("Dados recebidos da Feature Store com sucesso!")
        # Processe os dados conforme a sua necessidade
    else:
        print(f"Erro na requisição: {response.status_code} - {response.text}")
except requests.exceptions.RequestException as e:
    print(f"Erro na conexão com a API: {e}")

4. Documentação Completa da API

Para explorar todos os endpoints disponíveis, entender os parâmetros de busca e descobrir todas as séries e projeções que a 4intelligence oferece, consulte a nossa documentação técnica completa: Documentação da API 4intelligence