Aller au contenu

Cria ou executa publish

POST/api/products/{id}/publish

Auth
Jeton requis
Qui peut l’appeler:
owner
admin
finance
Clé d’API:
store:write
X-CommunityId
X-CommunityId Envoyez le X-CommunityId de la communauté où l’opération a lieu.
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.

Owner, admin ou financeiro. Coloca o produto no ar (`DRAFT` ou `INACTIVE` → `ACTIVE`): a partir daí ele aparece na loja, no link direto e nas opções do plano, e pode ser comprado. Exige informações comerciais `APPROVED` para **todo** produto (antes valia só quando `requiresApproval` era verdadeiro). Recusas: 403 sem aprovação, com a mensagem traduzida dizendo que o rascunho continua editável e onde preencher as informações comerciais (Configurações › Informação Comercial); 400 quando o país aprovado não tem provedor de pagamento ativo (tabela país → provedor; hoje só o Brasil); 400 quando a moeda do produto difere da moeda do país aprovado (`param = currency`) — o preço não é convertido nem reinterpretado: ajuste `currency` e `price` com `PUT` e publique de novo; 400 quando o país aprovado não tem moeda suportada; 400 se já está `ACTIVE`. Publicar um plano é publicar as suas opções, uma a uma, por esta rota. **Aviso por e-mail:** a primeira publicação de um produto avulso próprio (não plano, nem o produto de um curso, evento ou download, que avisam com o item) agenda o aviso da categoria "Novidades da loja" para quem abre um espaço de loja que mostra o produto (`notifyByEmail`, padrão ligado; 10 minutos depois). A resposta traz `data.emailNotice`. Despublicar e publicar de novo não reenvia.

Paramètres

NomEmplacementTypeDescription
idobligatoirepathstring

En-têtes

NomTypeDescription
X-CommunityIdfacultatifstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Corps de la requête application/json

NomTypeDescription
notifyByEmailfacultatifboolean"Avisar por e-mail". Padrão ligado. Só vale na **primeira** publicação do item por owner, admin ou moderador (conteúdo de membro nunca avisa): o aviso sai 10 minutos depois, para quem tem acesso ao espaço e ao item e tem a categoria ligada, menos quem publicou, no máximo 3 avisos por pessoa por dia na comunidade, fora da cota de campanhas. Desligado, o item fica marcado e nunca avisa depois. Editar, despublicar e publicar de novo não reenviam. Data retroativa e importação não avisam.

Réponses

StatutDescription
201Operação realizada com sucesso.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`).
403Sem papel de owner/admin, ou a comunidade ainda não tem informações comerciais aprovadas.
404Recurso não encontrado.
500Erro interno do servidor.

Exemple curl

curl -X POST "https://api.memberfy.net/api/products/<id>/publish" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'