Aller au contenu

Edita uma oferta de downsell

PUT/api/subscription-groups/{groupId}/downsell-offers/{offerId}

Auth
Jeton requis
Qui peut l’appeler:
owner
admin
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 ou admin. Campos parciais, com as mesmas recusas da criação; o adicional da oferta não muda (400 `productId`). Vale para as exibições criadas daí em diante: quem já recebeu a oferta paga o que leu. Desligar (`isActive: false`) cancela as exibições ainda não mostradas.

Paramètres

NomEmplacementTypeDescription
groupIdobligatoirepathstring
offerIdobligatoirepathstring

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
discountPercentfacultatifnumber
timingfacultatifIMMEDIATE | DELAYED
delayMinutesfacultatifinteger
priceDurationfacultatifFOREVER | FIRST_CHARGE | CYCLES
priceCyclesfacultatifinteger
ttlMinutesfacultatifinteger
isActivefacultatifboolean

Réponses

StatutDescription
200Oferta atualizada.
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`).
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
500Erro interno do servidor.

Exemple curl

curl -X PUT "https://api.memberfy.net/api/subscription-groups/<groupId>/downsell-offers/<offerId>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{}'