Para garantir a segurança e a privacidade dos seus dados, nossa API requer autenticação para cada solicitação.
A autenticação pode ser feita de duas maneiras:
Incluindo uma chave de API (API Key) no cabeçalho da solicitação.
Usando três cabeçalhos (headers), método que deve ser usado se você estiver tentando integrar um novo aplicativo (APP) ao Darwin.
Método da Chave de API (API Key Method)
Obtendo sua Chave de API
Sua chave de API exclusiva é fornecida diretamente pela equipe do Darwin.
Essa chave atua como um token de acesso seguro à sua conta e deve ser mantida em sigilo.
Não compartilhe sua chave de API publicamente nem com pessoas não autorizadas.
Se você ainda não recebeu sua chave de API ou a perdeu, entre em contato com nossa equipe de suporte pelo e-mail [email protected] para obter assistência.
Usando sua Chave de API
Para autenticar suas solicitações à API, inclua sua chave de API no cabeçalho de cada solicitação usando o campo X-API-KEY.
Aqui está um exemplo de como incluir sua chave de API em uma solicitação usando cURL:
curl -X GET 'https://api.getdarwin.ai/endpoint' \ -H 'X-API-KEY: SuaChaveDeAPIAqui'
Substitua SuaChaveDeAPIAqui pela sua chave real fornecida pela equipe do Darwin.
Método da Chave de APP (APP Key Method)
Obtendo sua APP Key e APP Secret
Se você estiver tentando integrar um novo aplicativo (APP) ao Darwin, será necessário obter uma APP Key e um APP Secret.
Essas chaves são fornecidas diretamente pela equipe do Darwin e atuam como tokens de acesso seguro para o seu aplicativo.
Elas devem ser mantidas em sigilo e não devem ser compartilhadas publicamente ou com pessoas não autorizadas.
Se você ainda não recebeu suas credenciais (APP Key e APP Secret) ou as perdeu, entre em contato com a equipe de suporte pelo e-mail [email protected] para obter ajuda.
Usando sua APP Key e APP Secret
Você precisará enviar três cabeçalhos (headers) na sua solicitação para autenticar as requisições do seu aplicativo:
X-APP-KEY
X-SIGNATURE
X-AGENT-ID
Para gerar o valor de X-SIGNATURE, você precisará usar sua APP Key, seu APP Secret e o payload da solicitação.
Aqui está um exemplo de como fazer isso:
const crypto = require('crypto'); const payload = JSON.stringify(request.body); const signature = crypto.createHmac('sha256', 'your_app_secret') .update('your_app_key' + payload) .digest('hex');