Documentação
Guias
Início rápido, autenticação, requisições, erros, limites, paginação, webhooks e entrega DDEX.
- Início rápido Crie uma chave de API no app web da HILLS, verifique-a com /me, depois liste seus lançamentos e leia seus ganhos. Cerca de cinco minutos.
- Autenticação Envie sua chave hm_live_ como token Bearer: como criar chaves, escolher escopos, definir validade, fazer rotação e revogar, e o que cada erro significa.
- Como fazer requisições URL base, JSON de requisição e resposta, headers de resposta, versionamento e descontinuações, e o que enviar ao suporte quando algo dá errado.
- Erros O formato dos erros, cada status e código que a API responde, quais erros tentar de novo e um tratador de erros em Node pronto para copiar.
- Limites de requisições Requisições por minuto por chave de API em cada plano, os headers X-RateLimit, como é um 429 e como recuar e ficar abaixo do limite.
- Paginação Pagine lançamentos com cursor e next_cursor, pagine entregas de webhook com before e has_more, e sincronize só o que mudou.
- Webhooks Receba eventos da HILLS Music no seu endpoint HTTPS: assinatura, os 13 tipos de evento, o envelope, o X-Hills-Signature, novas tentativas e o log.
- Entrega DDEX Envie lançamentos em DDEX ERN: teste um lote com POST /ddex/validate, entregue com POST /ddex ou uploads diretos, use SFTP e leia o relatório de entrega.