Referência

Postman

Todas as operações da API em uma coleção, com o ambiente de teste e scripts que gravam os ids para a próxima chamada.

O que tem#

Uma pasta por grupo da API (Contas, Produtos, Gerações, Créditos, Avisos, Integração), com o nome de cada requisição igual ao resumo da referência.
Corpos de exemplo tirados do contrato OpenAPI.
Autenticação da coleção: Bearer {{chave}}.
Idempotency-Key: {{$guid}} automático em POST /galerias, POST /videos e POST /imagens/{imagemId}/edicoes.
Scripts de teste que gravam os ids nas variáveis: criar conta grava contaId; enviar a ficha grava produtoId; pedir galeria, vídeo ou edição grava geracaoId; consultar a geração grava imagemId; e assim por diante. O X-Request-Id de cada resposta vai para requestId.
Uma requisição pronta para a etapa LIMITE_429 (X-Sellume-Teste: forcar-429).
Pasta OAuth: trocar o código por tokens, renovar com o refresh token, revogar (todas em x-www-form-urlencoded) e listar a conta vinculada com o token.

Baixe os dois arquivos acima.
No Postman, clique em Import e arraste os dois arquivos.
No canto superior direito, escolha o ambiente Sellume — teste.
Abra o ambiente e cole a sua chave sk_test_ em chave (valor atual). Ela aparece uma vez no portal, em Chaves de API.
Rode na ordem: Créditos › Saldo da carteira, Contas › Criar a subconta, Produtos › Enviar a ficha e Conferir, Gerações › Criar galeria e Andamento.

Variável	Para quê
`baseUrl`	endereço da API (`https://api.sellume.com.br/v1`)
`chave`	a sua chave `sk_test_` (fica vazia até você colar)
`contaId`, `produtoId`, `geracaoId`, `imagemId`	ids gravados pelos scripts
`avisoId`, `testeId`, `entregaId`	ids dos avisos, do teste de assinatura e das entregas
`requestId`	`X-Request-Id` da última resposta, para o registro de chamadas
`codigoProduto`	o SKU usado no caminho da ficha
`tokenUrl`, `revogarUrl`	endpoints de token e de revogação do OAuth
`clientId`, `clientSecret`, `redirectUri`	dados do seu app OAuth (portal › Apps OAuth)
`codeVerifier`, `code`	PKCE e código da autorização (passo a passo manual)
`accessToken`, `refreshToken`	gravados pela troca do código e pela renovação

Na aba Authorization, escolha OAuth 2.0 e preencha:

Campo do Postman	Valor
Grant type	Authorization Code (With PKCE)
Callback URL	`{{redirectUri}}` — cadastre exatamente este endereço nas redirect URIs do app no portal (o padrão é `https://oauth.pstmn.io/v1/callback`)
Auth URL	`https://app.sellume.com.br/oauth/autorizar`
Access Token URL	`{{tokenUrl}}`
Client ID / Client Secret	`{{clientId}}` / `{{clientSecret}}` (app público: deixe o segredo vazio)
Code Challenge Method	SHA-256
Scope	`contas:ler produtos:escrever geracoes:criar`
State	um valor aleatório
Client Authentication	Send as Basic Auth header

Clique em Get New Access Token, entre com a conta Sellume do vendedor de teste e autorize. Detalhes do fluxo em Autenticação.