Registro de alterações

As 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.

Erros, 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).

Primeiros 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.

Todo erro agora retorna { code, message, requestId, retryable }. Os clientes devem decidir com base em code e só tentar de novo quando retryable for true.

GET /v1/rankings/official retorna um objeto provenance (coverageStatus, observedAt) ao lado de data.

As chaves têm escopos explícitos (rank:read, live:read, creator:read, …). Requisições fora dos escopos da chave falham com 403 insufficient_scope.