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-CommunityIdEnvoyez le X-CommunityId de la communauté où l’opération a lieu.
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
| Nom | Emplacement | Type | Description |
|---|---|---|---|
idobligatoire | path | string |
En-têtes
| Nom | Type | Description |
|---|---|---|
X-CommunityIdfacultatif | string (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
| Nom | Type | Description |
|---|---|---|
notifyByEmailfacultatif | boolean | "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
| Statut | Description |
|---|---|
201 | Operação realizada com sucesso. |
400 | Requisição inválida — falha de validação. |
401 | Token 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`). |
403 | Sem papel de owner/admin, ou a comunidade ainda não tem informações comerciais aprovadas. |
404 | Recurso não encontrado. |
500 | Erro 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 '{}'