Como cadastrar, consultar e deletar certificados digitais via API Manager SaaS Administração

É possível realizar o cadastro, consulta e exclusão de certificados digitais via API. O certificado deve ser no formato A1, padrão ICP-Brasil.

Todos os endpoints exigem o Token da Software House da API de Administração. Para obter o Token, siga as instruções desta documentação: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360044620773

Cadastro de certificado digital

POST https://managersaas.tecnospeed.com.br:1337/api/v1/certificado

Body - (form-data)

Exemplo de retorno:

{
    "mensagem": "Certificado cadastrado com sucesso",
    "dados": {
        "handle": 778638,
        "certificatename": "CN=TECNOSPEED NEGOCIOS LTDA:12342609000177, OU=Certificado PP A1, O=ICP-Brasil, C=BR, S=PR, L=Maringa, E=, SE=1d 2c 34 56 78 9b ef 9c",
        "senha": "senhaDeInstalaçãoDoCertificado",
        "vencimento": "2024-02-03T16:49:00.000Z"
    }
}

Consultar todos os certificados cadastrados

GET https://managersaas.tecnospeed.com.br:1337/api/v1/certificado

Body - (form-data)

Exemplo de retorno:

{
    "mensagem": "Registros retornados com sucesso",
    "dados": [
        {
            "certificatename": "CN=TECNOSPEED NEGOCIOS LTDA:12342609000177, OU=Certificado PP A1, O=ICP-Brasil, C=BR, S=PR, L=Maringa, E=, SE=1d 2c 34 56 78 9b ef 9c",
            "cnpjsoftwarehouse": "12342609000123",
            "emailcertificate": "teste@teste.com.br",
            "validatedate": "2023-11-21T16:40:00.000Z",
            "aliasCertificate": "TESTES",
            "handleCertificate": 777042,
            "leftDays": 71
        },
        {
            "certificatename": "CN=TECNOSPEED LTDA:12342609000123, OU=Certificado PP A1, O=ICP-Brasil, C=BR, S=PR, L=Maringa, E=, SE=1d 2c 34 56 78 9b ef 9c",
            "cnpjsoftwarehouse": "12342609000123",
            "emailcertificate": "teste@tecnospeed.com.br",
            "validatedate": "2024-07-19T13:14:00.000Z",
            "aliasCertificate": "Teste Certificado 2",
            "handleCertificate": 777002,
            "leftDays": 312
        }
    ],
    "total": 2
}

Consultar um certificado pelo handle

GET https://managersaas.tecnospeed.com.br:1337/api/v1/certificado/{handle}

Body - (form-data)

Exemplo de retorno:

{
    "mensagem": "Registro retornado com sucesso",
    "dados": {
        "aliasCertificate": "TESTES",
        "certificatename": "CN=TECNOSPEED NEGOCIOS LTDA:12342609000177, OU=Certificado PP A1, O=ICP-Brasil, C=BR, S=PR, L=Maringa, E=, SE=1d 2c 34 56 78 9b ef 9c",
        "emailcertificate": "teste@teste.com.br",
        "handleCertificate": 777042,
        "leftDays": 71,
        "validatedate": "2023-11-21T16:40:00.000Z",
        "cnpjsoftwarehouse": "12342609000177",
        "senha": "senhaDeInstalaçãoDoCertificado"
    }
}

Deletar um certificado pelo handle

DELETE https://managersaas.tecnospeed.com.br:1337/api/v1/certificado/{handle}

Body - (form-data)

Exemplo de retorno:

{
    "mensagem": "Registro excluído com sucesso"
}

Collection de exemplo do Postman:

https://api.postman.com/collections/23505788-c9503bd1-b80f-4f94-9050-ea9a6c4d8cab?access_key=PMAT-01HA2PMQQ361C1H9SZJXGD1RCC