Monitoramento de Serviço

Para garantir a confiabilidade e rastreabilidade das operações de intimações, foi implementado um sistema baseado em jobs, que são unidades de tarefas vinculadas às contas no sistema. Esses jobs desempenham papéis fundamentais no monitoramento e na execução de processos como coleta de notificações, coleta de perfis e leitura de intimações. Cada job armazena informações detalhadas, como status de execução, tipo de erro (em caso de falhas), datas de criação e atualização, e dados específicos sobre o tipo de operação realizada.

O sistema permite reproduções de jobs falhos utilizando os mesmos parâmetros originais, prevenindo duplicações desnecessárias e garantindo a consistência na base de dados. Além disso, os jobs seguem um fluxo diário automatizado, incluindo verificações de condições como dias úteis e intervalos de execução, o que otimiza a eficiência do sistema e reduz operações redundantes. Jobs de coleta de perfis também são executados regularmente, garantindo que as contas cadastradas estejam sempre atualizadas e prontas para novas coletas. Esse controle possibilita um monitoramento preciso e confiável do serviço de intimações.

Endpoints

Listar Jobs

Endpoint responsável por listar os jobs executados para uma conta específica.

Exemplo de chamada:

curl -X GET 'op.digesto.com.br/api/legal-deadlines/contas/{conta_id}/jobs' \
     -H 'Authorization: Bearer token' \
     -H 'Content-Type: application/json'

Parâmetro	Tipo	Descrição
conta_id	integer (path)	ID da conta.
page	integer (query)	Determina qual a página de interesse.
per_page	integer (query)	Determina quantos resultados serão retornados por vez.

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "conta_id": 10,
        "data": "2024-11-13T00:47:18.144Z",
        "execucao_manual": false,
        "id": 1,
        "quantidade_obtida": 25,
        "status": "completed",
        "tipo_job": "coleta"
    },
    {
        "conta_id": 10,
        "data": "2024-11-12T23:30:00.000Z",
        "execucao_manual": false,
        "id": 2,
        "quantidade_obtida": 0,
        "status": "error",
        "tipo_erro": "Falha na conexão",
        "tipo_job": "leitura"
    }
]

Códigos de Resposta

• 200: Lista de jobs retornada com sucesso.

• 404: Conta ou cliente não encontrado.

• 422: Erro de validação nos parâmetros.

—

Listar Sistemas Disponíveis

Endpoint responsável por listar os sistemas disponíveis para cadastro.

Exemplo de chamada:

curl -X GET 'op.digesto.com.br/api/legal-deadlines/sistemas' \
     -H 'Authorization: Bearer token' \
     -H 'Content-Type: application/json'

Parâmetros

Parâmetro	Tipo	Descrição
Nenhum	N/A	Este endpoint não requer parâmetros adicionais.

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "dados": {
            "certificate": "no",
            "instancias": {},
            "leitura_implementada": {
                "parte-cnpj": true
            },
            "requires_2fa": false,
            "tipos_acesso": {
                "Parte em processo": "parte-cnpj"
            }
        },
        "id": 1,
        "nome": "TJPI Projudi"
    },
    {
        "dados": {
            "certificate": "no",
            "instancias": {},
            "leitura_implementada": {},
            "requires_2fa": false,
            "tipos_acesso": {
                "Default": "default"
            }
        },
        "id": 3,
        "nome": "TJPE PJe"
    }
]

Códigos de Resposta

• 200: Lista de sistemas retornada com sucesso.

—

Listar Cobertura

Endpoint responsável por listar a cobertura detalhada de sistemas, representando os dados no formato de uma planilha.

Exemplo de chamada:

curl -X GET 'op.digesto.com.br/api/legal-deadlines/cobertura' \
     -H 'Authorization: Bearer token' \
     -H 'Content-Type: application/json'

Parâmetros

Parâmetro	Tipo	Descrição
Nenhum	N/A	Este endpoint não requer parâmetros adicionais.

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
    "range": "Estadual!A1:AB1070",
    "majorDimension": "ROWS",
    "values": [
        ["Tribunal", "Estado(s)", "Sistema", "Instância", "Citações/Intimações"],
        ["TJAC", "Acre", "ESAJ", "1a", "Sim"],
        ["TJAL", "Alagoas", "ESAJ", "1a", "Sim"]
    ]
}

Códigos de Resposta

• 200: Cobertura retornada com sucesso.

• 404 Not Found: Recurso não encontrado.

• 422 Validation Error: Erro de validação nos parâmetros.