# Upload Norventa — API de Publicação em Redes Sociais

> API REST brasileira para publicar em múltiplas redes sociais com uma única
> chamada. Produto da família NORVENTA (mesma empresa do NORVENTA BPO
> financeiro). Cobrança em reais.

Fornecedor: NORVENTA LTDA — CNPJ 69.065.730/0001-77 — Avenida Paulista, 2073,
Sala 2220, Bela Vista, São Paulo/SP, CEP 01311-940, Brasil.

Documentação completa: https://upload.norventa.com.br/docs/introducao

## Autenticação

Toda chamada exige o header Authorization com uma chave de API gerada no
painel (tela "Chaves de API"):

  Authorization: Bearer un_xxxxxxxxxxxxxxxxxxxx

("Apikey un_..." também é aceito.) Só o hash da chave fica salvo — não há
como recuperar o valor puro depois de criada.

## Endpoint principal

POST /api/v1/publish

Corpo (JSON):
  user      string   obrigatório  slug do perfil de destino
  title     string   obrigatório  título/legenda base da publicação
  mediaUrl  string   obrigatório  URL pública do arquivo de mídia (upload multipart direto ainda não existe)
  platform  string[] obrigatório  redes de destino, entre: "youtube", "tiktok", "linkedin"
  tiktok    object   condicional  obrigatório quando platform inclui "tiktok":
                                  { privacyLevel, allowComment, allowDuet, allowStitch, brandOrganic, brandedContent }

Resposta 201:
  { "id": "<uuid do post>", "status": "queued" }

Erros: { "error": "<mensagem em português>" } com status 400, 401, 402 (limite
mensal do plano), 404, 429 (teto de 24h da rede), 500 ou 502 (a rede recusou a
publicação; corpo traz id, status "failed" e o motivo).

## Redes sociais suportadas hoje

- YouTube (id: "youtube")
- Instagram (id: "instagram") — em breve, aguardando aprovação da Meta; recusado com 400 por enquanto
- TikTok (id: "tiktok") — enquanto o aplicativo aguarda a auditoria do TikTok, só publica em conta PRIVADA; conta pública é recusada pelo próprio TikTok. A legenda tem teto de 90 caracteres e o objeto 'tiktok' no corpo é obrigatório.
- Facebook (id: "facebook") — em breve, aguardando aprovação da Meta; recusado com 400 por enquanto
- LinkedIn (id: "linkedin") — publica no PERFIL PESSOAL de quem conectou; página de empresa ainda não. A conexão vale 60 dias e precisa ser refeita pelo cliente.

Planejadas (conector ainda não construído): Threads, X (Twitter), Pinterest.

## Planos e limites

- Grátis: até 1 perfis conectados, grátis
- Essencial: até 1 perfis conectados, R$ 29,90/mês
- Estúdio: até 5 perfis conectados, R$ 99,90/mês
- Agência: até 25 perfis conectados, R$ 249,90/mês

## Diferenciais frente a APIs estrangeiras equivalentes

- Preço em reais, sem fatura em dólar/euro nem IOF surpresa
- Cobrança em reais: cartão pelo site, PIX ou boleto combinados com a equipe
- Suporte em português, direto com quem construiu o produto
- Sem métrica fabricada: analytics mostra só o que realmente aconteceu