Cadastro de Certificado Digital

curl --location 'https://crawler.prod.judit.io/credentials/certificate' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "customer_key": "teste",
  "system_name": "ESAJ - TJSP - 1º grau",
  "file_base64": "<conteudo-do-pfx-em-base64>",
  "password": "123456"
}'

curl --location 'https://crawler.prod.judit.io/credentials/certificate' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "customer_key": "teste",
  "system_name": "ESAJ - TJSP - 1º grau",
  "file_base64": "<conteudo-do-pfx-em-base64>",
  "password": "123456",
  "custom_data": {
    "secret": "JBSWY3DPEHPK3PXP"
  }
}'

{
	"message": "CERTIFICATE_CREATED",
	"customer_key": "teste",
	"subject_cn": "NOME DO TITULAR:12345678909",
	"not_after": "2027-01-01T00:00:00.000Z",
	"uploaded_at": "2026-07-31T17:00:00.000Z"
}

POST

credentials

certificate

curl --location 'https://crawler.prod.judit.io/credentials/certificate' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "customer_key": "teste",
  "system_name": "ESAJ - TJSP - 1º grau",
  "file_base64": "<conteudo-do-pfx-em-base64>",
  "password": "123456"
}'

curl --location 'https://crawler.prod.judit.io/credentials/certificate' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "customer_key": "teste",
  "system_name": "ESAJ - TJSP - 1º grau",
  "file_base64": "<conteudo-do-pfx-em-base64>",
  "password": "123456",
  "custom_data": {
    "secret": "JBSWY3DPEHPK3PXP"
  }
}'

{
	"message": "CERTIFICATE_CREATED",
	"customer_key": "teste",
	"subject_cn": "NOME DO TITULAR:12345678909",
	"not_after": "2027-01-01T00:00:00.000Z",
	"uploaded_at": "2026-07-31T17:00:00.000Z"
}

O certificado não pode ser enviado pela rota POST /credentials. Campos de certificado dentro de custom_data são recusados com o erro CERTIFICATE_FIELDS_NOT_ALLOWED.

string

obrigatório

Conteúdo do arquivo .pfx / .p12 (PKCS#12) convertido para Base64, em uma única linha, sem quebras. Arquivo com no máximo 64 KB.

string

obrigatório

Senha do arquivo .pfx. Não é a senha do portal do tribunal.

string

Sistema e tribunal em que o certificado será usado, por exemplo ESAJ - TJSP - 1º grau. Use * para cadastrar como credencial coringa.

string

Identificador da credencial definido por você. Se omitido, é usado o valor padrão *.

object

Dados extras da credencial. Envie apenas quando o tribunal também exigir autenticação em dois fatores.

Mostrar properties

string

Segredo 2FA (secret) — a chave fixa de configuração do aplicativo autenticador, nunca o código temporário de 6 dígitos.

curl --location 'https://crawler.prod.judit.io/credentials/certificate' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "customer_key": "teste",
  "system_name": "ESAJ - TJSP - 1º grau",
  "file_base64": "<conteudo-do-pfx-em-base64>",
  "password": "123456"
}'

curl --location 'https://crawler.prod.judit.io/credentials/certificate' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "customer_key": "teste",
  "system_name": "ESAJ - TJSP - 1º grau",
  "file_base64": "<conteudo-do-pfx-em-base64>",
  "password": "123456",
  "custom_data": {
    "secret": "JBSWY3DPEHPK3PXP"
  }
}'

{
	"message": "CERTIFICATE_CREATED",
	"customer_key": "teste",
	"subject_cn": "NOME DO TITULAR:12345678909",
	"not_after": "2027-01-01T00:00:00.000Z",
	"uploaded_at": "2026-07-31T17:00:00.000Z"
}

Se já existir um certificado do mesmo titular nessa credencial, a mensagem será CERTIFICATE_UPDATED e o certificado anterior é descartado.

Erros possíveis

Código	HTTP	Quando acontece
`PFX_MALFORMED`	400	Base64 inválido ou arquivo PFX corrompido
`PFX_PASSWORD_INVALID`	400	Senha do arquivo incorreta
`PFX_NO_PRIVATE_KEY`	400	Arquivo sem chave privada
`PFX_NO_CERTIFICATE`	400	Arquivo sem certificado
`PFX_EXPIRED`	400	Certificado vencido
`PFX_NOT_YET_VALID`	400	Certificado ainda não vigente
`PFX_TOO_LARGE`	400	Arquivo maior que 64 KB
`CERTIFICATE_HOLDER_MISMATCH`	409	Novo certificado pertence a outro titular (CPF/CN)
`CREDENTIAL_TYPE_CONFLICT`	409	Já existe credencial de usuário/senha para a mesma combinação de credencial e `customer_key`

Guia completo, com conversão do arquivo para Base64 e passo a passo no Postman: Cofre de Credenciais — certificado digital.

Autorizações

api-key

string

header

obrigatório

API key for authentication

Corpo

application/json

file_base64

string

obrigatório

PFX/P12 file content encoded as a single-line Base64 string

password

string

obrigatório

Password of the PKCS#12 file (not the court portal password)

system_name

string

e.g. "ESAJ - TJSP - 1º grau" or * (wildcard)

customer_key

string

Client-defined identifier for the credential. Defaults to *

custom_data

object

Extra credential data. Only required when the court also enforces two-factor authentication.

Show child attributes

Resposta

Certificate created or updated

message

enum<string>

Opções disponíveis:

CERTIFICATE_CREATED,

CERTIFICATE_UPDATED

customer_key

string

subject_cn

string

Certificate holder (CN)

not_after

string<date-time>

Certificate expiration date

uploaded_at

string<date-time>

Requests · Consultas Assíncronas

Responses · Resultados das Consultas

Tracking · Monitoramento

Lawsuits · Consultas Síncronas (Cache JUDIT)

Lawsuits · Dados Cadastrais 2

Lawsuits · Anexos de Processos

Cofre de Credenciais

Autorizações

Corpo

Resposta