Vamos realizar a sua primeira chamada às APIs da BigDataCorp de forma simples e segura?

Os exemplos abaixo demonstram como utilizar o token JWT, configurar corretamente os headers de autenticação e interpretar os retornos recebidos pelas APIs.

O objetivo é que você consiga validar rapidamente a integração com nossos Apps, seguindo o formato padrão de chamadas adotado em todas as APIs da BigDataCorp.

🔑 Usando seu Token JWT

Todas as chamadas às APIs da BigDataCorp exigem autenticação via tokens JWT, utilizando os headers AccessToken e TokenId.

     --header 'AccessToken: SEU-ACCESSTOKEN' \
     --header 'TokenId: SEU-TOKENID' \

Esses tokens podem ser gerados diretamente no BDC Center.

📘
Mais detalhes sobre autenticação e segurança estão disponíveis na seção Autenticação e segurança.

⚙️ Fazendo as chamadas

Abaixo você encontra exemplos reais de requisição, demonstrando o formato padrão utilizado nos Apps da BigDataCorp.

curl --request POST \
     --url https://app.bigdatacorp.com.br/bigid/kba/perguntas \
     --header 'AccessToken: SEU-ACCESSTOKEN' \
     --header 'TokenId: SEU-TOKENID' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "Parameters": [
    "CPF=12345678900",
    "NAME=JOSE DA SILVA"
  ],
  "Group": "SEU-GRUPO"
}
'

✅
Se o retorno incluir um conjunto de perguntas:
Sua integração está funcionando corretamente. Caso receba erro, verifique o token, o corpo da requisição e o endpoint informado.

curl --request POST \
     --url https://app.bigdatacorp.com.br/bigia/biogenerativa \
     --header 'AccessToken: SEU-ACCESS-TOKEN' \
     --header 'TokenId: SEU-TOKENID' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "q": "doc{CPF}",
  "Datasets": "genai_description_gpt_x1_5_person"
}
'

✅
Se a autenticação estiver correta:
A resposta trará um conteúdo JSON com a narrativa gerada para o CPF consultado. Caso contrário, verifique:

Se o token é válido e não expirou;

Se os headers AccessToken e TokenId estão corretamente informados;

Se o endpoint está correto (/bigia/biogenerativa).