...
Informações essenciais
O CNPJ passado no endpoint /api/organizations/:cnpj/certificates refere-se ao CNPJ do cliente PLEXI, que está solicitando a operação. É importante garantir que o CNPJ informado corresponda ao cliente autorizado, pois ele será utilizado para validações internas de segurança e permissão.
Cadastrar certificados
Endpoint: POST /api/organizations/:cnpj/certificates
...
| Code Block | ||
|---|---|---|
| ||
{
"name": "certificado-1",
"metadata": "Qualquer informação extra que possa ajudar na identificação do certificado",
"certificate": {
"pfx": "base64 encoded",
"password": "123"
}
} |
Também é possível enviar diretamente o conteúdo do certificado junto com sua chave privada, já descriptografada, ambos codificados em base64
| Code Block | ||
|---|---|---|
| ||
{
"name": "certificado-1",
"metadata": "Qualquer informação extra que possa ajudar na identificação do certificado",
"certificate": {
"cert": "base64 encoded",
"key": "base64 encoded"
}
} |
...
Para atualizar um certificado basta enviar os dados do certificado como na endpoint de criação, sem o campo name no corpo.
| Code Block | ||
|---|---|---|
| ||
{
"metadata": "Qualquer informação extra que possa ajudar na identificação do certificado",
"certificate": {
"cert": "base64 encoded",
"key": "base64 encoded"
}
} |
ou
| Code Block | ||
|---|---|---|
| ||
{
"metadata": "Qualquer informação extra que possa ajudar na identificação do certificado",
"certificate": {
"pfx": "base64 encoded",
"password": "123"
}
} |
...
Exemplo de retorno:
| Code Block | ||
|---|---|---|
| ||
[
{
"name": "certificado-cliente-1",
"metadata": "Qualquer informação extra que possa ajudar na identificação do certificado",
"certificate" : {
"common_name": "FULANO DE TAL 1234567890",
"fingerprint": "VXRpbC9IdG1sSnNvbkZpbmRlci5waHAK",
"due_date": "2024-01-01T00:00:00Z"
}
},
{
"name": "certificado-cliente-1",
"metadata": "Qualquer informação extra que possa ajudar na identificação do certificado",
"certificate" : {
"common_name": "FULANO DE TAL 1234567890",
"fingerprint": "VXRpbC9IdG1sSnNvbkZpbmRlci5waHAK",
"due_date": "2024-01-01T00:00:00Z"
}
},
] |
...
| Code Block | ||
|---|---|---|
| ||
{
"name": "certificado-cliente-1",
"metadata": "Qualquer informação extra que possa ajudar na identificação do certificado",
"certificate" : {
"common_name": "FULANO DE TAL 1234567890",
"fingerprint": "VXRpbC9IdG1sSnNvbkZpbmRlci5waHAK",
"due_date": "2024-01-01T00:00:00Z"
}
} |
...