Nunciatura Provista

API Documentation V1

Dashboard Recent Processes

Retorna os 5 processos mais recentes cadastrados no sistema

Este endpoint é do tipo: Protected

Descrição

Retorna os 5 processos de provisão mais recentes cadastrados no sistema, ordenados pela data de criação (do mais recente para o mais antigo). Útil para exibir atividades recentes no dashboard.

  • Valida o token JWT no header Authorization
  • Retorna os últimos 5 processos cadastrados
  • Ordenação por data de criação (mais recente primeiro)
  • Inclui todos os detalhes de cada processo
  • Útil para monitoramento de atividades recentes

Detalhes do Endpoint

VERBO

GET

URL BASE

http://api.provista.dev.nabrasil.org.br/v1

ENDPOINT

/dashboard/recent-processes

Cabeçalhos

Parâmetro Valor
Authorization Bearer {token}
Accept application/json

Respostas

Sucesso - 200

{
    "success": true,
    "data": [
        {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "name": "Diocese de São Paulo",
            "protocol": "PROV-2024-001",
            "description": "Processo de provisão para Diocese de São Paulo",
            "users": 10,
            "users_collected": 5,
            "img_url": "https://example.com/image.jpg",
            "status": "Em andamento",
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-15T10:30:00.000000Z"
        }
    ]
}

Erro - 401 (Não autorizado)

{
    "success": false,
    "message": "Token não fornecido"
}

Condição: Token JWT não fornecido, inválido ou expirado

Erro - 500 (Erro interno)

{
    "success": false,
    "message": "Erro interno do servidor"
}

Condição: Erro inesperado ao processar a requisição

Campos da Resposta

Campo Tipo Descrição
id string (UUID) Identificador único do processo
name string Nome do processo de provisão
protocol string Número de protocolo no formato PROV-YYYY-XXX
description string Descrição detalhada do processo
users integer Número total de usuários esperados
users_collected integer Número de usuários já coletados
img_url string URL da imagem do processo
status string Status: "A iniciar", "Em andamento" ou "Concluído"
created_at string (ISO 8601) Data e hora de criação do processo
updated_at string (ISO 8601) Data e hora da última atualização

Códigos de Resposta

Código Descrição
200 Processos retornados com sucesso
401 Token não fornecido, inválido ou expirado
500 Erro interno do servidor