Afiliados
Crear Afiliado
Aprende a crear un afiliado usando el endpoint POST /stores//affiliates.
POST
Create affiliate
📌 Endpoint
POST /stores/{storeId}/affiliates
Crea un nuevo afiliado en la tienda.
El code (slug) se usa para armar el enlace de divulgación:
https://TU_DOMINIO.com.br/l/{code}.
🔐 Autenticación
- Ruta privada.
- Requiere el header
Authorizationcon tu API key y plan activo.
🧾 Parámetros de ruta
📤 Body (JSON)
✅ Ejemplo de solicitud
📦 Respuesta exitosa (201)
⚠️ Posibles errores
400 INVALID_DATA→ body inválido400 INVALID_DATA_NAME→nameausente o fuera de 1 a 56 caracteres400 INVALID_DATA_EMAIL→emailausente, inválido o mayor de 120 caracteres400 INVALID_DATA_CODE→codeausente, fuera de 3 a 50 caracteres o fuera del patrón slug400 INVALID_DATA_IMAGE→imageinválida (URLhttp/httpsinválida o mayor de 512 caracteres)400 INVALID_DATA_METADATA→metadatainválido (no es un objeto o excede 64 claves)400 INVALID_DATA_RULES→commissionRulesinválido (no es un array)400 INVALID_COMMISSION_RULES→commissionRulesvacío400 INVALID_COMMISSION_RULE_TYPE→typeinválido400 INVALID_COMMISSION_RULE_POSITION→positioninválida/duplicada400 INVALID_COMMISSION_VALUE→commissionfuera de 1 a 100400 COMMISSION_RULE_DEFAULT_REQUIRED→ falta exactamente una reglaDEFAULT400 INVALID_COMMISSION_RULE_TARGET→DEFAULTcontargetId, oPRODUCT/CATEGORY/COUPONsintargetId400 RELATION_NOT_FOUND→targetIdde producto/categoría/cupón inexistente en la tienda401 API_KEY_NOT_PROVIDED→ headerAuthorizationno enviado401 INVALID_API_KEY→ API key inválida401 UNAUTHENTICATED→ usuario no autenticado403 USER_DISABLED→ usuario deshabilitado403 NO_ACTIVE_SUBSCRIPTION→ sin plan activo404 STORE_NOT_FOUND→ tienda no encontrada409 AFFILIATE_ALREADY_EXISTS→codeya existente409 AFFILIATE_EMAIL_ALREADY_EXISTS→ correo ya registrado por otro afiliado en la tienda429 RATE_LIMIT_EXCEEDED→ límite de solicitudes por minuto excedido500 INTERNAL_SERVER_ERROR→ error interno503 SERVICE_UNAVAILABLE→ servicio no disponible
Cuerpo
application/json
Affiliate details (name, email, code, commissionRules).