Pular para o conteúdo
HILLS API v1 Acesso antecipado

Referência da API

Status

Os estados possíveis de um lançamento e de cada uma das suas plataformas, como a API responde. status mantém o termo antigo durante um ciclo de descontinuação.

A aprovação entrega na hora; uma plataforma aparece como no ar quando de fato estiver.

release_status

Código Significado
draft Rascunho: ainda não enviado.
in_review Em revisão: enviado; aguardando uma decisão da revisão.
changes_requested Alterações solicitadas: devolvido ao artista com um motivo; pode ser editado de novo.
approved Aprovado: as plataformas recebem a entrega na hora.
archived Arquivado: não é entregue.
taken_down Removido: removido de todas as plataformas em que estava.

delivery_state

Código Significado
not_started Não iniciado: nenhuma plataforma recebeu nada ainda.
delivering Em entrega: o lançamento está sendo enviado às plataformas.
delivered Entregue: todas as plataformas o receberam; nenhuma o mostra no ar ainda.
partially_live No ar em algumas plataformas: no ar em algumas plataformas; as outras já o receberam ou estão recebendo.
live No ar: no ar em todas as plataformas para as quais foi enviado.
needs_attention Requer atenção: uma plataforma falhou, o rejeitou ou aguarda uma pessoa (a página dele diz quem precisa agir).
taking_down Em remoção: uma remoção está a caminho das plataformas.
taken_down Removido: removido de todas as plataformas em que estava.

update_state

Código Significado
none Todas as plataformas têm a versão aprovada mais recente.
pending Uma versão aprovada mais nova aguarda envio.
delivering Uma versão aprovada mais nova está sendo enviada.

stores[key].status

Código Significado
awaiting_approval Aguardando aprovação (fase review)
queued A caminho (fase queue)
delivered Entregue (fase done)
live No ar (fase done)
failed Requer correção sua (fase attention)
takedown_queued Remoção solicitada (fase takedown)
taken_down Removido (fase takedown)

status (obsoleto, removido em 30 de abril de 2027)

Código Significado
draft release_status draft
pending release_status in_review
approved release_status approved, ainda não está no ar em nenhuma plataforma
distributed release_status approved, no ar em pelo menos uma plataforma
rejected release_status changes_requested
archived release_status archived ou taken_down

Pronto para integrar?

Solicite acesso à API e retornamos em 1 a 3 dias úteis.