API FLUXO DE RUA

Workspace privado

Distribuição sob controle.

Acesse o painel de operações para preparar lançamentos, acompanhar automações e revisar alertas.

ACESSO RESTRITO · FLUXO DE RUA

Entrar no sistema

Use sua conta para continuar.

Centro de operações / distribuição

Visão geral

Saúde do serviço, sessão de distribuição e atividade dos lançamentos.

Selo conectado: verificando...

Atualizando status...

Uptime do servidor

--

Desde a última inicialização

Memória do processo

--

RSS do serviço Node.js

Lançamentos salvos

0

Rascunhos no banco local

Em atenção

0

Erros que precisam de revisão

Serviços e acesso

Atualização automática

API do aplicativo

Rotas locais e banco de dados

Conectando

Sessão ONErpm

Perfil Chromium persistente

Verificando

Automação

Aguardando tarefa

Ociosa

Rascunhos0

Em execução0

Aguardando confirmação0

Metadados concluídos0

Alertas recentes

Carregando atividade...

Faixas recentes

Últimos lançamentos cadastrados

Faixas do catálogo ordenadas pela última atualização; não representa dados de reprodução.

Carregando faixas...

Selos com mais faixas

Volume do catálogo

Faixas e lançamentos agrupados por selo cadastrado.

Carregando dados dos selos...

Artistas em lançamentos com erro

Por artista principal

Mostra artistas associados a lançamentos que precisam de atenção; não atribui a causa do erro ao artista.

Carregando ocorrências...

Problemas mais comuns

Por etapa da automação

Contagem dos erros registrados agrupados pela etapa em que ocorreram.

Carregando problemas...

Resumo da distribuição

Estado atual do catálogo

Aguardando envio0

Enviados à ONErpm0

Envio incerto0

Aprovados0

Não enviados0

Cadastro / metadados

Preparar lançamento

Organize os dados antes de preencher o painel de distribuição.

Etapa atual: Informações do álbum

01Informações do álbum

02Upload de faixa

03Preferências

Informações do álbum

* Campos obrigatórios

Metadados compartilhados pelo lançamento e pelas faixas. Na próxima etapa, Upload de faixa, você pode adicionar os artistas ou colaboradores necessários.

Título do álbum, single ou EP *

Tipo de lançamento *

Artista principal *

Artistas adicionais · até 3

Artista adicional 1 (opcional)

Função do artista 1

Artista adicional 2 (opcional)

Função do artista 2

Artista adicional 3 (opcional)

Função do artista 3

Classificação

Gênero principal *

Gênero secundário *

Idioma do álbum e das faixas *

Label & copyright

Selo / titular dos direitos *

2026

O selo escolhido será ativado na ONErpm antes de iniciar o preenchimento da faixa.

Preencha os dados e selecione um WAV independente para cada faixa. Em Álbum ou EP, adicione até 30 faixas; a capa e a data são compartilhadas.

Faixa 1Metadados e áudio desta faixa

Título da faixa (máximo 200 caracteres) *

Versão alternativa de lançamento original

Add artists or contributors

Artistas e colaboradores são opcionais. Use “Adicionar” para incluir quantos forem necessários e escolha uma função para cada pessoa.

Artista ou colaborador 1 (opcional)

Função

Produtor / engenheiro da faixa

Produtor / engenheiro da faixa *

Função *

Composição e músicos

Add songwriters · até 3

Songwriter 1 *

Songwriter 2 (opcional)

Songwriter 3 (opcional)

Add musicians · até 3

Músico 1 *

Instrumento/função do músico 1 *

Músico 2 (opcional)

Instrumento/função do músico 2

Músico 3 (opcional)

Instrumento/função do músico 3

Declarações e letra

AI-Assisted Materials *

Idioma da faixa *

Conteúdo explícito *

Faixa instrumental

Letra (opcional)

ISRC (opcional)

Mensagens de validação da ONErpm devem ser revisadas antes de continuar.

Áudio da faixa (WAV)Opcional. WAV de até 3 GB; será copiado para o armazenamento local ao salvar.

1 faixa

URL base e autenticação

Todos os endpoints v1 usam HTTPS e autenticação Bearer. Integre sistema-a-sistema pelo backend; nunca coloque tokens em código frontend, navegador, repositório ou logs.

https://api.fluxoderua.com

Armazenamento local: esta instalação grava metadados no SQLite e áudio/capa em armazenamento local gerenciado pelo app; os arquivos só seguem para a ONErpm depois do comando de automação. O domínio público ainda exige DNS, HTTPS e proxy/túnel direcionados ao servidor que mantém o banco e a sessão ONErpm. Não exponha a porta local diretamente.

Token de acesso

Cada token é criado para um usuário/sistema, com permissões mínimas e validade configurável. O segredo completo aparece apenas uma vez; revogue e gere outro se ele for perdido. Chamadas incluem Authorization: Bearer SEU_TOKEN.

Autorizar usuário ou sistema

Tokens ativos e revogados

Buscar token por nome, escopo ou prefixo

Situação

Carregando autorizações...

Catálogo, arquivos e distribuição assistida

O outro sistema salva os metadados e arquivos como rascunho (visível em Faixas), e a primeira confirmação inicia o preenchimento ONErpm, que para para revisão humana. Também pode solicitar Shares vinculados a faixas do catálogo. Depois que o administrador aprovar a análise, uma segunda rota, com permissão separada, muda para o selo e envia o comando final de distribuição.

GET/api/v1/onerpm/session

Consulta se o navegador ONErpm está autenticado e o aviso de renovação. O servidor estima a duração em 44 horas a partir do primeiro status autenticado observado; warning fica ativo nas últimas 24 horas e nextReminderAt avança em intervalos de 30 minutos. O prazo é estimado, não garantido. Exige catalog:read.

GET/api/v1/onerpm/queue

Consulta a tarefa ONErpm em execução, a fila FIFO, páginas do navegador e o intervalo mínimo de cinco segundos entre tarefas. Exige catalog:read.

POST/api/v1/shares

Solicita um Share e o coloca na fila ONErpm global. Shares consecutivos do mesmo selo podem rodar em paralelo em até três páginas; outros tipos de automação continuam FIFO e exclusivos. Envie {"label":"MANDELA HITS","songName":"Nome da faixa","participants":[{"email":"nome@exemplo.com","percent":"33,3"}]}; percentuais aceitam vírgula decimal e a soma máxima é 100. Retorna 202 com ID e status. Exige catalog:write. Se o webhook global estiver configurado, envia eventos de progresso e o resultado final do Share.

GET/api/v1/shares?limit=50&offset=0

Consulta o histórico paginado e os resultados dos Shares. A resposta inclui hasMore para indicar se há outra página; avance offset pelo número de itens retornados. Exige catalog:read.

GET/api/v1/shares/{id}

Consulta status, progresso, errorCode e erros de uma solicitação. Se a ONErpm informar Total share percentage is more than 100%, o erro share_total_percentage_exceeded é registrado e a página Royalty Shares é reaberta após 2 segundos. Se mais de uma faixa corresponder ao nome, share_track_ambiguous é registrado sem salvar o Share. Os estados possíveis incluem queued, running, sent, duplicate, failed e uncertain. Com o webhook global configurado, esses resultados também são enviados nos eventos share.sent, share.total_percentage_exceeded e share.duplicate.

POST/api/v1/releases

Criar lançamento em rascunho. Retorna 201 e o ID interno.

GET/api/v1/releases?limit=50&offset=0

Lista lançamentos e estados do processamento. Exige catalog:read.

GET / PUT/api/v1/releases/{id}

Consultar o resultado/erros/ID ONErpm ou atualizar metadados.

GET/api/v1/release-status-events?after=0&limit=100

Consultar mudanças incrementais de status de distribuição. Use nextAfter como cursor na próxima consulta; exige catalog:read.

GET/api/v1/labels

Listar os selos que podem ser escolhidos em label, incluindo quais estão habilitados na conta ONErpm. Exige catalog:read.

DELETE/api/v1/releases/{id}

Excluir rascunho e arquivos locais associados. Responde 204; exige catalog:write.

PUT/api/v1/releases/{id}/assets/audio

Enviar WAV binário, até 3 GB; usar X-File-Name e Content-Length.

PUT/api/v1/releases/{id}/assets/track-audio-{index}

Enviar o WAV de cada faixa de Álbum ou EP (índice começando em 0, até 29); por exemplo, track-audio-0 para a primeira faixa. Exige assets:write.

DELETE/api/v1/releases/{id}/assets/audio ou /assets/track-audio-{index}

Remover somente o WAV local indicado e informar o espaço liberado, sem excluir os metadados, deslocar os arquivos das outras faixas ou afetar a cópia já enviada à ONErpm. Exige assets:write; bloqueado enquanto a automação ou distribuição estiver em andamento ou incerta.

PUT/api/v1/releases/{id}/assets/cover

Enviar PNG/JPG binário de 3000 × 3000 pixels, até 35 MB.

POST/api/v1/releases/{id}/automation

Comandar o preenchimento ONErpm. Retorna 202; consulte o GET do lançamento para status, etapa, progresso, erros, ID e presença dos arquivos.

POST/api/v1/releases/{id}/distribution-confirmation

Confirmação do sistema integrador para iniciar o preenchimento ONErpm depois de salvar os dados e arquivos. Exige automation:start, retorna 202 na primeira confirmação e não inicia duas vezes se a confirmação for repetida durante ou após a automação.

POST/api/v1/releases/{id}/distribute

Comando final após a análise e aprovação do administrador. Envie { "label": "FLUXO DE RUA", "onerpmId": "1234567" }; o sistema troca para esse selo e abre /distribution-tools/my-catalog/upload-music/{onerpmId}?step=distribution-preferences. Para Single, aplica a shortClipStart opcional se informada no lançamento; se omitida ou vazia, mantém a seleção padrão da ONErpm e segue sem arrastar a waveform. Depois clica em ALBUM PREVIEW, confirma o ID ONErpm e clica em Distribute Album. Exige o escopo separado distribution:submit; confirmação repetida não clica novamente. HTTP 202 confirma apenas que o comando foi aceito: consulte o statusUrl para acompanhar o resultado e erros. As etapas também podem ser enviadas por webhook global HTTPS configurado no servidor; a confirmação final de distribuição chega quando a aprovação da ONErpm é recebida.

Webhook de automação, distribuição e Share In

Configure DISTRIBUTION_WEBHOOK_URL e DISTRIBUTION_WEBHOOK_SECRET no arquivo .env e reinicie o servidor. O endpoint recebe eventos de etapa, progresso, erros e aprovação de lançamentos e também eventos de Share: share.progress, share.sent, share.total_percentage_exceeded, share.duplicate, share.uncertain e share.failed. O evento share.total_percentage_exceeded também é enviado quando a soma é recusada pela validação da API; erros incluem errorCode e a mensagem, e e-mails dos participantes nunca são incluídos. Valide a assinatura HMAC-SHA256 X-ONErpm-Signature usando o corpo HTTP bruto e o mesmo segredo; use X-ONErpm-Delivery para deduplicar reenvios. Entregas são tentadas em segundo plano, com repetição automática até 12 tentativas; o receptor deve responder com HTTP 2xx. O webhook não substitui consultas à API para recuperar o estado atual.

{
  "id": "uuid-da-entrega",
  "type": "release.progress",
  "occurredAt": "2026-10-16T11:09:48.128Z",
  "data": {
    "releaseId": "id-interno",
    "title": "Nome do lançamento",
    "status": "needs_attention",
    "step": "artist_profile_selection_unconfirmed",
    "onerpmId": null,
    "distributionStatus": "not_submitted",
    "progressMessage": "A automação parou nesta etapa.",
    "errorMessage": "Revise a seleção de perfil na ONErpm.",
    "updatedAt": "2026-10-16T11:09:48.128Z"
  }
}

Fluxo de recebimento e confirmação

const created = await fetch(`${base}/releases`, {
  method: "POST", headers,
  body: JSON.stringify(releaseMetadata)
});
const { data: draft } = await created.json();
// Envie a capa e os WAVs usando draft.id; eles e os metadados
// ficam salvos no catálogo e aparecem na área Faixas.
// Só quando o outro sistema autorizar o envio:
const confirmation = await fetch(
  `${base}/releases/${draft.id}/distribution-confirmation`,
  { method: "POST", headers }
); // 202: preenchimento iniciado; 200: confirmação repetida já processada
// Após análise/aprovação humana no outro sistema:
const distribution = await fetch(`${base}/releases/${draft.id}/distribute`, {
  method: "POST", headers,
  body: JSON.stringify({ label: "FLUXO DE RUA", onerpmId: "1234567" })
}); // exige token separado com distribution:submit

Campos mínimos para iniciar automação

Além do título obrigatório na criação, o comando de automação valida todos estes campos. Use os nomes exatos no JSON; data em MM/DD/AAAA, explicit como string "true"/"false", instrumento VOCALS/DJ.

{
  "releaseTitle": "Nova música",
  "releaseType": "single",
  "genre": "FUNK",
  "subgenre": "BAILE FUNK",
  "language": "PORTUGUÊS",
  "label": "CENTRAL MANDELA",
  "releaseCopyright": "2026 CENTRAL MANDELA",
  "recordingCopyright": "2026 CENTRAL MANDELA",
  "trackTitle": "Nova música",
  "trackProducer": "Nome do produtor",
  "producerRole": "Producer",
  "composer": "Nome do compositor",
  "musician": "Nome do músico",
  "instrument": "VOCALS",
  "lyrics": "Letra da música (opcional)",
  "aiMaterials": "Human Created, No AI",
  "trackLanguage": "PORTUGUÊS",
  "explicit": "false",
  "territory": "World",
  "releaseDate": "12/31/2026",
  "shortClipStart": "01:23"
}

Para Single, envie opcionalmente shortClipStart no formato MM:SS (por exemplo 01:23). Quando informado, o valor será aplicado na etapa final de envio, definindo o início do corte de 30 segundos para TikTok/ringtones; o corte precisa caber na duração da faixa.

Para um Álbum ou EP com várias faixas, envie releaseType: "album" ou "EP" e uma lista tracks com 1 a 30 objetos. Cada objeto usa os mesmos campos de faixa do exemplo acima; o primeiro item também alimenta os campos de faixa legados para manter compatibilidade. Envie cada WAV para o índice correspondente em assets/track-audio-{index}, uma única capa em assets/cover e uma data compartilhada no lançamento. A versão alternativa é configurada individualmente em cada objeto de tracks: inclua "alternateVersion": true e "alternateVersionOther": "Slowed Reverb" somente nas faixas que terão essa versão. As demais faixas podem omitir esses campos, como no exemplo abaixo.

{
  "releaseTitle": "Meu álbum",
  "releaseType": "album",
  "mainArtist": "Artista principal",
  "genre": "FUNK",
  "subgenre": "BAILE FUNK",
  "language": "PORTUGUÊS",
  "label": "CENTRAL MANDELA",
  "releaseCopyright": "2026 CENTRAL MANDELA",
  "recordingCopyright": "2026 CENTRAL MANDELA",
  "territory": "World",
  "releaseDate": "12/31/2026",
  "tracks": [
    {
      "trackTitle": "Faixa 1",
      "trackProducer": "Nome do produtor",
      "producerRole": "Producer",
      "composer": "Nome do compositor",
      "musician": "Nome do músico",
      "instrument": "VOCALS",
      "lyrics": "Letra da primeira faixa (opcional)",
      "aiMaterials": "Human Created, No AI",
      "trackLanguage": "PORTUGUÊS",
      "explicit": "false"
    },
    {
      "trackTitle": "Faixa 2",
      "alternateVersion": true,
      "alternateVersionOther": "Slowed Reverb",
      "trackProducer": "Nome do produtor",
      "producerRole": "Producer",
      "composer": "Nome do compositor",
      "musician": "Nome do músico",
      "instrument": "VOCALS",
      "lyrics": "Letra da segunda faixa (opcional)",
      "aiMaterials": "Human Created, No AI",
      "trackLanguage": "PORTUGUÊS",
      "explicit": "false"
    }
  ]
}

import { createReadStream, statSync } from "node:fs";
import { basename, extname } from "node:path";

const base = "https://api.fluxoderua.com/api/v1";
const token = process.env.FLUXO_API_TOKEN;
const jsonHeaders = {
  Authorization: `Bearer ${token}`,
  "Content-Type": "application/json"
};

async function uploadAsset(releaseId, kind, filePath) {
  const size = statSync(filePath).size;
  const isAudio = kind === "audio";
  const response = await fetch(
    `${base}/releases/${releaseId}/assets/${kind}`,
    {
      method: "PUT",
      headers: {
        Authorization: `Bearer ${token}`,
        "Content-Length": String(size),
        "X-File-Name": encodeURIComponent(basename(filePath)),
        "Content-Type": isAudio ? "audio/wav" :
          (extname(filePath).toLowerCase() === ".png" ? "image/png" : "image/jpeg")
      },
      body: createReadStream(filePath),
      duplex: "half"
    }
  );
  if (!response.ok) throw new Error(`Upload ${kind} falhou: ${await response.text()}`);
  return response.json();
}

const response = await fetch(`${base}/releases`, {
  method: "POST", headers: jsonHeaders,
  body: JSON.stringify(releaseMetadata)
});
if (!response.ok) throw new Error(await response.text());
const { data: release } = await response.json();

// A automação só começa depois que ambos os arquivos foram armazenados.
await Promise.all([
  uploadAsset(release.id, "audio", audioPath),
  uploadAsset(release.id, "cover", coverPath)
]);
const started = await fetch(
  `${base}/releases/${release.id}/automation`,
  { method: "POST", headers: jsonHeaders }
); // 202 Accepted
if (!started.ok) throw new Error(await started.text());

// Consulte GET /releases/{id}: status, step, progresso, erros,
// onerpmId, assets locais e oneRpmAssetStatus.

PRE SAVES e retorno ao sistema integrador

POST/api/v1/presaves

Enfileira a busca do Smart Link nas contas ONErpm habilitadas e retorna 202 com a posição e o endereço de status. Quando encontrar, grava nome/link no SQLite; se o ID não existir, o status termina em failed com presave_release_not_found.

POST/api/v1/presaves/batch

Enfileira até 100 IDs em onerpmIds; busca até três lançamentos simultaneamente em páginas separadas e retorna um status URL por ID. Exige presaves:fetch.

GET/api/v1/presaves/status?onerpmId={id}

Acompanha a fila e a busca (queued, searching, found ou failed), incluindo nome/link encontrados e mensagem do selo atual; exige presaves:read.

GET/api/v1/presaves/status?onerpmIds={id1},{id2}

Consulta em uma resposta os estados de vários IDs; exige presaves:read.

GET/api/v1/presaves?onerpmId={id}

Consulta um PRE SAVE salvo; sem ID, lista os resultados.

GET/api/v1/health

Verifica se a API v1 está disponível.

const base = "https://api.fluxoderua.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.FLUXO_API_TOKEN}`,
  "Content-Type": "application/json"
};
const response = await fetch(
  `${base}/presaves`,
  { method: "POST", headers,
    body: JSON.stringify({ onerpmId: "9222000" }) }
);
// data retorna onerpmId, trackName, smartLink e updatedAt.

O estado do catálogo devolve ID interno e ONErpm, status, step, progresso/erro, data e metadados de áudio/capa local. oneRpmAssetStatus.audio e .cover informam uploading, uploaded, manual_required, failed ou unknown. Status da automação: draft, queued, running, waiting_for_manual_action, waiting_for_manual_assets, needs_attention ou login_required.

Códigos HTTP

Status	Significado
200	OK — solicitação concluída
201	Criado — recurso criado
202	Aceito — enfileirado para processamento assíncrono; consulte o recurso
204	Sem conteúdo — sucesso sem corpo de resposta
400	Solicitação inválida — corpo ou consulta malformada
401	Não autorizado — token ausente, inválido ou revogado
403	Proibido — token válido, sem permissão exigida
404	Não encontrado — recurso inexistente ou indisponível
409	Conflito — tarefa ONErpm ocupada ou sessão não pronta
413	Carga muito grande — arquivo excede o limite
422	Entidade não processável — validação falhou; confira `error.details`
429	Muitas solicitações — limite atingido; respeite Retry-After
500	Erro interno; informe o cabeçalho X-Request-Id
503	Serviço temporariamente indisponível