Esta página foi criada para ajudá-lo a realizar sua primeira chamada às APIs da BigDataCorp de forma simples e segura. Aqui você encontrará exemplos práticos de requisições para diferentes produtos, mostrando como utilizar seu token JWT, configurar os headers necessários e interpretar os retornos recebidos.

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 ou pela API de Tokens.

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

⚙️ Exemplo prático de chamada

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

🙂 Faces | Tratamento de Imagem

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.

📞 Associação de CPF com Telefone | Tratamento de Dados

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 informado:
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