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 Plugins, 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 chamada

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

curl --request POST \
     --url https://plugin.bigdatacorp.com.br/qualidadedeimagem/face \
     --header 'AccessToken: SEU-ACCESSTOKEN' \
     --header 'TokenId: SEU-TOKENID' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "image": "BASE64_OU_URL_IMAGEM"
}
'

✅
Se o retorno incluir o resultado da avaliação de qualidade da face:
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://plugin.bigdatacorp.com.br/validacoes \
     --header 'AccessToken: SEU-ACCESSTOKEN' \
     --header 'TokenId: SEU-TOKENID' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "q": "doc{CPF-CONSULTADO},phone{NUMERO-TELEFONE-COM-DDD}",
  "Services": "carriers_phone_validation"
}
'

✅
Se o retorno indicar associação válida ou inválida entre o CPF e o telefone:
Sua integração está funcionando corretamente. Caso receba erro, verifique o token, os parâmetros enviados no campo q e o endpoint utilizado.

💡
Lembrete:
O formato de autenticação é o mesmo para todos os Plugins da BigDataCorp. Basta ajustar o endpoint de acordo com o produto desejado. Por exemplo:
• ../qualidadedeimagem/ → chamadas aos plugins de Tratamento de Imagens
• .../validacoes → chamadas aos plugins de Tratamento de Dados