Pular para o conteúdo
sellumeDOCS · INTEGRADORES Portal do integrador

Referência

Mudanças

O que mudou na API, com data, e como as mudanças chegam até você.

Política de mudanças e descontinuação#

  • Mudanças compatíveis podem entrar a qualquer momento: campo novo na resposta, endpoint novo, evento novo de aviso, valor novo de lista documentado. O seu sistema deve ignorar campos desconhecidos e tratar valores novos sem quebrar.
  • Mudança que quebra (tirar ou renomear campo, mudar tipo, mudar o sentido de algo) só numa nova versão da API (/v2). A /v1 continua igual.
  • Descontinuação de uma versão ou recurso é anunciada com pelo menos 6 meses de antecedência, nesta página e por e-mail aos contatos técnicos, com lembretes 6, 3 e 1 mês antes do desligamento. As respostas do recurso que vai sair passam a trazer os cabeçalhos Deprecation e Sunset (a data do fim).
  • Correção de segurança urgente pode ter prazo menor, sempre com aviso.

14/10/2026 — Lista de avatares oficiais#

  • Novo GET/avatares: avatares ativos da Apresentação com codigo, nome, genero, idadeAparente, foto e previaAnimada, para o seu sistema montar a escolha do cliente (Avatares). Grátis.
  • POST/videos passa a conferir o avatar: código que não existe ou não está ativo responde 400 VALIDATION_ERROR (campo avatar, código AVATAR_INDISPONIVEL), também no teste simulado. automatico continua igual.

14/10/2026 — Endereço oficial: api.sellume.com.br#

  • O endereço oficial da API passa a ser https://api.sellume.com.br/v1, e o do OAuth2, https://api.sellume.com.br/oauth/token e /oauth/revogar. A autorização do vendedor continua em https://app.sellume.com.br/oauth/autorizar.
  • O endereço técnico anterior (o que esta documentação mostrava até 13/10/2026, para /v1 e /oauth/...) continua aceito, com os mesmos caminhos, respostas, chaves e tokens. Nada quebra: troque só a base quando puder.
  • Tokens OAuth e chaves emitidos antes valem nos dois endereços.

14/10/2026 — Créditos de teste e geração real no teste#

  • Novo campo opcional modo (simulado | real) em POST/galerias e POST/videos, só com a chave sk_test_: real gera de verdade e gasta os créditos de teste liberados pelo Sellume (Créditos de teste). Sem o campo, nada muda.
  • Novo creditosDeTeste em GET/saldo; novo tipo creditos_de_teste no GET/extrato; novo campo modo nas gerações e nos avisos.
  • Política de descontinuação: lembretes por e-mail 6, 3 e 1 mês antes do desligamento (Política).

13/10/2026 — Fila: nenhum pedido recusado por capacidade#

  • Galerias e vídeos acima do que o plano roda ao mesmo tempo esperam na fila em vez de responder 503: a geração fica na_fila com fila.posicao, fila.naFrente e fila.esperaEstimadaSegundos (Galerias).
  • Novo aviso geracao.iniciada, quando a geração sai da fila (Avisos).
  • Novo: POST/geracoes/{geracaoId}/cancelar, só enquanto a geração está na fila (Galerias).

11/10/2026 — Fase 5: documentação pública, Postman e OAuth2#

  • Documentação pública da API, com catálogo de erros e este histórico.
  • Coleção Postman e ambiente de teste (Postman).
  • OAuth2 com PKCE para contas vinculadas: apps OAuth no portal, autorização pelo vendedor, token, refresh rotativo e revogação (Autenticação).
  • Campo error.documentation nas respostas de erro, com o link do código no catálogo.

11/10/2026 — Embed para agências#

  • Novo tipo de integrador: a agência revende o Sellume inteiro com a marca e o domínio dela (Embed para agências).
  • App do Mercado Livre da agência, com 4 verificações automáticas.
  • Domínio próprio com HTTPS automático e marca com contraste conferido.
  • Clientes da agência com convite por link, planos próprios e distribuição real de créditos.
  • Planos Embed pagos antes.
  • O antigo componente embutido (POST /sessoes-embutidas) saiu da API.

11/10/2026 — Planos de API pagos antes#

  • Planos Sellume API Base, Growth, Business e Enterprise, pagos antes; os créditos do plano são a cota e o teto do mês (Planos e cobrança).
  • Bateu o teto: 402 INSUFFICIENT_CREDITS sem cobrar, até um pacote avulso (que não vence) ou o próximo ciclo.
  • Novos: GET/plano, GET/planos, GET/cota-do-mes e POST/recargas, com o escopo creditos:comprar.
  • Aviso cota.alerta em 70%, 90% e no teto.
  • Saiu a cota com excedente cobrado depois.

11/10/2026 — Fase 2: vídeos e avisos#

  • POST/videos: Apresentação e CinePremium com fala automática (Vídeos).
  • Avisos assinados com HMAC-SHA256, entregas com retentativas, reenvio e troca de segredo (Avisos e assinatura).
  • Teste de assinatura em três entregas (POST/avisos/teste).
  • Status da integração com as 8 etapas (vídeo e avisos entraram).

10/10/2026 — Fase 1: núcleo da API#

  • Subcontas (POST/contas) e ficha do produto como única fonte.
  • Conferência obrigatória antes de gerar (POST/produtos/{produtoId}/conferencia).
  • Galerias de 3, 6 ou 10 imagens e edição de imagem.
  • Saldo e extrato da carteira do integrador.
  • Status da integração e registro de chamadas.
  • Catálogo de erros com como corrigir.
  • Ambiente de teste com a chave sk_test_.