DADOS ESPORTIVOS, PRONTOS PARA ATIVAR

Dados confiáveis para
momentos que importam.

A Sports Data API fornece consultas estruturadas de eventos, atletas, classificações e gatilhos comerciais. Este ambiente usa uma prova fictícia para homologação segura.

Testar no playground Explorar endpoints

REST: API versionada
JSON: Contratos previsíveis
ISO 8601: Horários explícitos

Ambiente de homologação. Nenhum dado, credencial ou serviço de produção é usado nesta plataforma.

REFERÊNCIA

Catálogo de endpoints

Todos exigem chave de parceiro e devolvem success, data e meta.

GET/v1/events

Eventos permitidos.

GET/v1/events/{event_id}

Metadados e revisão.

GET/status

Atualização e cobertura.

GET/athletes

Atletas paginados.

GET/athletes/{athlete_id}

Perfil de um atleta.

GET/rankings

Classificação observada.

GET/splits

Parciais e checkpoints.

GET/triggers

Gatilhos revisáveis.

HOMOLOGAÇÃO INTERATIVA

Playground

A chave permanece somente na memória do navegador; não entra na URL, exemplos ou armazenamento local. Os exemplos copiados usam https://api.kzu.li; as consultas desta página usam o proxy local do portal.

GET /v1/events

Aguardando consulta.

{}

Integração

AUTOMAÇÃO COM CONTEXTO

Gatilhos publicitários

RACE_STARTEDFIRST_SWIM_EXITFIRST_BIKE_STARTFIRST_RUN_STARTLEADER_CHANGEDATHLETE_FINISHEDFIRST_MALE_FINISHFIRST_FEMALE_FINISHFINISHERS_MILESTONE

A plataforma não infere RACE_FINISHED pela ausência de dados. Esse estado exige confirmação explícita.

ACESSO POR PARCEIRO

Autenticação

Envie uma chave própria no cabeçalho Authorization: Bearer … ou X-API-Key. Cada chave possui permissões por evento e endpoint, limite individual e revogação.

Authorization: Bearer $SPORTS_DATA_API_KEY
Accept: application/json

OPERAÇÃO RESPONSÁVEL

Atualização e limites

O limite é definido por parceiro. A resposta informa idade, cobertura, modo e atualização. Clientes devem respeitar 429 e Retry-After.

fresh: Dentro da janela
stale: Dado vencido
partial: Cobertura limitada