RoomScope API · v1
Construa sobre a inteligência de LIVE
Os mesmos rankings, sessões de LIVE, criadores e alertas do painel, por meio de chaves de API com escopos e cobrados da mesma carteira de créditos. URL base https://api.toktokdata.live.
Primeiros passosCrie uma chave de API e faça sua primeira requisição em cinco minutos.LerAutenticaçãoChaves Bearer, escopos e rotação.LerAPI de rankingsRankings oficiais por região, com cobertura e procedência.LerWebhooksEntregas assinadas para presentes, envelopes e inícios de LIVE.Ler
Endpoints mais usados
- GET
/v1/rankings/officialRanking oficial - GET
/v1/rankings/regionsRegiões cobertas - GET
/v1/creators/{uid}Perfil do criador - GET
/v1/live/sessionsHistórico de sessões de LIVE - POST
/v1/alerts/rulesCriar uma regra de alerta
Novidades
Registro de alterações completo →- AlteradoCabeçalhos de webhook renomeadosAs entregas de webhook agora trazem x-roomscope-signature, x-roomscope-timestamp, x-roomscope-alert-id e x-roomscope-schema-version. O esquema de assinatura e o payload não mudaram; leia os novos nomes de cabeçalho ao verificar.
- CorrigidoDocumentação alinhada com a APIErros, Créditos, Limites de requisição, Autenticação e Webhooks agora descrevem o comportamento real: códigos de erro reais, limites de requisição por chave com cabeçalhos X-RateLimit, custos em créditos e franquias mensais, e o esquema de webhooks assinados. A referência passa a incluir insights de criadores, melhor horário e presença. A busca na documentação está ativa (⌘K).
- AdicionadoModelo da documentação da APIPrimeiros passos, Autenticação, Erros, Limites de requisição, a referência de Rankings e Webhooks. As páginas de referência dos demais recursos virão quando forem geradas a partir do documento OpenAPI.