Registro de aplicação cliente
Antes de consumir a API, a sua aplicação precisa ser registrada no DS Cloud. O registro gera as credenciais client_id e client_secret que identificam a aplicação no fluxo de autorização.
Registro assistido pela equipe técnica
Hoje o registro da aplicação cliente é feito com apoio da equipe do DS Cloud. Envie os dados abaixo e a equipe retornará com as credenciais e as instruções iniciais de configuração.Dados necessários para o registro
Para registrar a aplicação, informe:
Informações do registro
Ambientehomologação | produçãoobrigatórioEm qual ambiente a aplicação será habilitada. Toda integração começa em homologação.
Nome da aplicaçãostringobrigatórioNome ou breve descrição do software/solução que vai integrar.
Observações de usostringopcionalDescrição do uso previsto da integração (fluxos, volume, contexto).
E-mail de contato técnicostringobrigatórioE-mail responsável por manutenção, avisos e atualizações da integração.
URLs de redirecionamentostring[] por ambienteobrigatórioLista de redirect URIs autorizadas em cada ambiente (para onde o DS Cloud devolve o authorization code).
Sobre as URLs de redirecionamento
As redirect URIs devem ser exatas e por ambiente. Uma URL de callback só é aceita no fluxo de autorização se estiver previamente cadastrada. Exemplo:meusoftware.com.br/psc/dscloud-callback.Credenciais retornadas
Concluído o registro, a aplicação recebe:
Credenciais da aplicação
{
"client_id": "a1b2c3d4-....",
"client_secret": "s3cr3t-....",
"redirect_uris": [
"https://meusoftware.com.br/psc/dscloud-callback"
]
}Proteja o client_secret
Oclient_secret é sigiloso e nunca deve ser exposto em código cliente (navegador, app mobile) nem versionado em repositório. Guarde-o como segredo no seu backend.Solicitar credenciais
Você pode iniciar o pedido de credenciais pelo nosso canal de integrações. Em breve o registro será totalmente self-service pela área do desenvolvedor.