APIs da DigiCert oferecem aos desenvolvedores muita liberdade e personalização. Assim, é importante entender como aproveitar ao máximo a sua integração de API. Ao seguir essas melhores práticas, você reduzirá o seu número total de chamadas de API e assegurará receber os tempos de respostas mais rápidos.
Para gerar uma chave API, é necessário vinculá-la a um usuário existente. Isso fornece autenticação e autorização para a chave de API. Ao construir integrações de API, certifique-se de usar uma chave de API com as permissões necessárias para completar as tarefas requeridas.
Recomendamos que você não envie solicitações paralelas, pois isso pode aumentar os tempos de resposta e pode causar comportamento inesperado. Solicitações paralelas também aumentam o risco de atingir o seu limite de taxa de solicitação, temporariamente bloqueando o seu acesso de API.
Ao trabalhar com múltiplas solicitações, envie solicitações sequencialmente (uma por vez) e sempre aguarde um código de resposta antes de enviar a próxima solicitação na fila. Isso produz o melhor desempenho de transmissão de dados e amplamente reduz a chance de comportamentos anormais e erros.
Por padrão, solicitações de pedidos de certificados SSL/TLS incluem uma etapa de aprovação que deve ser concluída antes que a DigiCert possa processar o pedido.
Você pode pular esta etapa de aprovação ao incluir o parâmetro skip_approval com um valor de true no corpo da solicitação dos seus pedidos. Isso agiliza os tempos de resposta consideravelmente e lhe permite tirar vantagem da emissão imediata de certificado.
Quando você deseja associar um pedido a uma organização existente, recomendamos sempre usar o ID da organização em vez dos detalhes da organização no corpo da sua solicitação. Para obter os valores de ID para organizações em sua conta, use o terminal Listar organizações.
Também recomendamos desativar organizações não utilizadas para garantir que elas nunca sejam acidentalmente atribuídas a uma nova solicitação de pedido. Para desativar uma organização, use o terminal Desativar organização.
Após enviar um pedido, você desejará saber quando status do pedido mudar o certificado estiver pronto para download. Em vez de fazer múltiplas chamadas para verificar o status de cada pedido, use o ponto de extremidade Lista de alteração de status.
O ponto de extremidade da lista de alteração de status retorna uma lista de pedidos que mudou o status em um período específico (até 7 dias no passado). Quando o status de um pedido muda de pendente para emitido, é possível usar a order_id retornada para obter detalhes específicos do pedido ou para baixar o certificado.
Ao solicitar, re-emitir e duplicar certificados de domínios exclusivos, é possível escolher se deve incluir uma SAN adicional específica gratuitamente.
Para proteger as duas versões do seu domínio ([seu-dominio].com e www.[seu-dominio].com), na sua solicitação, use o parâmetro common_name para adicionar o domínio ([seu-dominio].com) e a matriz dns_names[] para adicionar a outra versão do domínio (www.[seu-dominio].com). Se você deseja proteger apenas o nome comum (FQDN), simplesmente omita o parâmetro dns_names[] da sua solicitação.
Para o ponto de extremidade Order SSL (type_hint), é necessário adicionar o domínio base (diferente da versão www) ao parâmetro common_name e a SAN adicional (versão www) à matriz dns_names.
{
"certificate": {
"common_name": "example.com",
"dns_names": [
"www.example.com"
],
...