Referencia API

Añadir miembro al equipo creador

Añade miembro mediante equipo creador y guarda relación revendedora; completa alta normal de organizador.

POSThttps://api.sparkglim.net/api/white-label/portal/reseller/members

Modelo de acceso

Modelo de acceso: Sesión SparkGlim y permisos de miembro
Permiso requerido: members:write
Disponibilidad documentada: Implementado en código

Disponibilidad verificada en el código, sin garantía de producción.

Use el flujo de miembros del equipo creador. La reventa no concede acceso ilimitado a base de datos o administración.

Encabezados

Nombre	Tipo	Validación
`Authorization`Obligatorio Sesión Bearer SparkGlim existente; la membresía y capacidades asignadas autorizan cada operación en servidor.	`string`	Validación: Token Bearer de una sesión autenticada existente.

Solicitud

Nombre	Tipo	Validación
`userId`Opcional Asociación opcional a usuario existente; no crea una cuenta de creador ilimitada.	`string\|null`	Validación: UUID solo de un usuario existente.
`creatorId`Opcional Propietario autorizado del equipo para la relación revendedora; usa el propietario configurado por defecto.	`string\|null`	Validación: UUID del propietario autorizado; creador revendedor de forma predeterminada.
`memberType`Opcional Rol de relación revendedora; capacidades y permisos de equipo se aplican por separado.	`enum`	Validación: owner \| operator \| finance \| support \| sub_creator.
`status`Opcional Estado admitido solicitado; aprobación controla publicación y acceso.	`enum`	Validación: invited \| pending \| active \| suspended \| revoked.
`displayName`Opcional Nombre visible del miembro o colaborador; no cambia propiedad de cuenta.	`string\|null`	Validación: 2–160.
`email`Opcional Correo de contacto usado por el flujo configurado; por sí solo no concede acceso.	`string\|null`	Validación: Correo electrónico.
`phone`Opcional Teléfono de miembro o solicitante usado por el flujo existente.	`string\|null`	Validación: 8–40.
`roles`Opcional Roles de revendedor admitidos por esquema, limitados por permisos del servidor.	`string[]`	Validación: Roles de revendedor admitidos.
`permissions`Opcional Capacidades admitidas solicitadas, limitadas por política de cuenta y autorización.	`string[]`	Validación: Funciones de revendedor admitidas.
`otpRequired`Opcional Define verificación admitida sin eludir controles del servidor.	`boolean`	Validación: Valor predeterminado: true.
`kycStatus`Opcional Estado de revisión de relación revendedora; no autoriza pagos por sí solo.	`enum`	Validación: not_required \| pending \| verified \| rejected.
`metadata`Opcional Metadatos JSON admitidos; nunca sustituyen autorización, precios o propiedad.	`object`	Validación: Objeto JSON.

Solicitud

Los ejemplos describen el contrato y no se ejecutan. Use registros de prueba autorizados; nunca pegue secretos reales aquí.

POST /api/white-label/portal/reseller/members

http

POST /api/white-label/portal/reseller/members HTTP/1.1
Host: api.sparkglim.net
Authorization: Bearer <EXISTING_SESSION_TOKEN>
Content-Type: application/json

{
  "displayName": "Example member",
  "email": "member@example.com",
  "memberType": "sub_creator",
  "roles": [
    "sub_creator"
  ],
  "permissions": []
}

Respuesta

Respuesta correcta · HTTP 201

json

{
  "success": true,
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "pending"
  }
}

Respuesta de error · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

Validación, permisos, registros no disponibles y fallos usan el estado HTTP y error del controlador.

Límites y reintentos

Límite predeterminado: 100 solicitudes por IP en 60 segundos. También se aplican controles específicos.

Compatibilidad del código

Las operaciones autorizadas requieren pruebas específicas de la cuenta.

server/src/api/router.ts
server/src/api/routes/white-label.ts
server/src/white-label/reseller-service.ts
server/src/white-label/schemas.ts

Modelo de acceso

Encabezados

Solicitud

Solicitud

Respuesta

Límites y reintentos

Compatibilidad del código

Seguir desarrollando