Saltar para o conteúdo principal
GET
curl
A API de verificações de hoje por hora da Didit devolve as verificações de utilizadores de hoje por hora, a partir da meia-noite no fuso horário que enviar, juntamente com as mesmas horas do mesmo dia da semana da semana anterior. São os dados que alimentam o cartão de volume no Home da Business Console. Os valores são lidos em tempo real das suas verificações, pelo que uma verificação criada há instantes já está contabilizada. Para um intervalo de datas e as restantes métricas do painel, use Obter as análises da aplicação.
Só uma chave de API com acesso total pode chamar este endpoint. Uma chave com acesso limitado recebe 403, independentemente do acesso que tenha, e o mesmo acontece com a chave de outra aplicação. Consulte Chaves de API.

Relacionados

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

organization_id
string<uuid>
obrigatório

UUID da organização.

application_id
string<uuid>
obrigatório

UUID da aplicação. Deve ser a aplicação à qual a chave de API pertence: uma chave usada em qualquer outra aplicação recebe 403.

Parâmetros de consulta

tz
string
padrão:UTC

Fuso horário IANA cuja meia-noite inicia o dia de hoje, por exemplo Europe/Madrid ou America/Mexico_City. Omita para UTC.

Exemplo:

"Europe/Madrid"

Resposta

Verificações de hoje por hora local, as do dia de comparação e os resultados de hoje.

Verificações de hoje por hora local em comparação com o mesmo dia da semana da semana passada.

time_zone
string
obrigatório

O fuso horário IANA do dia e das respetivas horas.

Exemplo:

"Europe/Madrid"

date
string<date>
obrigatório

O dia de hoje nesse fuso horário.

Exemplo:

"2026-10-30"

current_hour
integer
obrigatório

A hora local atual.

Intervalo necessário: 0 <= x <= 23
Exemplo:

14

previous_date
string<date>
obrigatório

O dia de comparação: o mesmo dia da semana uma semana antes.

Exemplo:

"2026-10-23"

hours
integer[]
obrigatório

Verificações criadas hoje, por hora local a partir das 00:00. As horas ainda por decorrer são 0.

Required array length: 24 elements
Intervalo necessário: x >= 0
previous_hours
integer[]
obrigatório

Verificações criadas no dia de comparação, por hora local a partir das 00:00.

Required array length: 24 elements
Intervalo necessário: x >= 0
total
integer
obrigatório

Verificações criadas hoje até ao momento.

Intervalo necessário: x >= 0
Exemplo:

165

previous_total_so_far
integer
obrigatório

Verificações criadas no dia de comparação até à mesma hora local.

Intervalo necessário: x >= 0
Exemplo:

151

outcomes
object
obrigatório

Das verificações de hoje, quantas estão aprovadas, a aguardar em análise e recusadas neste momento. As restantes ainda não foram concluídas.

Última modificação em 7 de novembro de 2026