Afiliados
Atualizar Afiliado
Aprenda a atualizar um afiliado usando o endpoint PUT /stores//affiliates/.
PUT
Update affiliate
📌 Endpoint
PUT /stores/{storeId}/affiliates/{affiliateId}
Atualiza os dados de um afiliado (nome, e-mail, código, imagem, status, metadata e regras de comissão).
Todos os campos são opcionais — apenas os enviados são alterados.
🔐 Autenticação
- Rota privada.
- Requer header
Authorizationcom sua API key e plano ativo.
🧾 Parâmetros de rota
📤 Body (JSON)
✅ Exemplo de requisição
📦 Resposta de sucesso (200)
⚠️ Possíveis erros
400 INVALID_DATA→ body inválido400 INVALID_DATA_NAME→namefora de 1 a 56 caracteres400 INVALID_DATA_EMAIL→emailinválido ou maior que 120 caracteres400 INVALID_DATA_IMAGE→imageinválida (URLhttp/httpsinválida ou maior que 512 caracteres)400 INVALID_DATA_CODE→codefora de 3 a 50 caracteres ou fora do padrão slug400 INVALID_DATA_STATUS→statusinválido (deve serativoouinativo)400 INVALID_DATA_METADATA→metadatainválido (não é objeto ou excede 64 chaves)400 INVALID_DATA_RULES→commissionRulesinválido (não é um array)400 INVALID_COMMISSION_RULES→commissionRulesvazio400 INVALID_COMMISSION_RULE_TYPE→typeinválido400 INVALID_COMMISSION_RULE_POSITION→positioninválida/duplicada400 INVALID_COMMISSION_VALUE→commissionfora de 1 a 100400 COMMISSION_RULE_DEFAULT_REQUIRED→ falta exatamente uma regraDEFAULT400 INVALID_COMMISSION_RULE_TARGET→DEFAULTcomtargetId, ouPRODUCT/CATEGORY/COUPONsemtargetId400 RELATION_NOT_FOUND→targetIdde produto/categoria/cupom inexistente na loja401 API_KEY_NOT_PROVIDED→ headerAuthorizationnão enviado401 INVALID_API_KEY→ API key inválida401 UNAUTHENTICATED→ usuário não autenticado403 USER_DISABLED→ usuário desativado403 NO_ACTIVE_SUBSCRIPTION→ sem plano ativo404 STORE_NOT_FOUND→ loja não encontrada404 AFFILIATE_NOT_FOUND→ afiliado não encontrado409 AFFILIATE_ALREADY_EXISTS→codejá usado por outro afiliado409 AFFILIATE_EMAIL_ALREADY_EXISTS→ e-mail já cadastrado por outro afiliado na loja429 RATE_LIMIT_EXCEEDED→ limite de requisições por minuto excedido500 INTERNAL_SERVER_ERROR→ erro interno503 SERVICE_UNAVAILABLE→ serviço indisponível
Parâmetros de caminho
Corpo
application/json
Affiliate fields to update.