Si su sitio web tiene membresías, programas o productos, puede decidir a qué grupos de usuarios del foro pertenece cada miembro. Tu sitio web establece las reglas y transfiere los ID de grupo al foro, de modo que el acceso de un miembro al foro siempre coincide con su membresía en tu sitio web.
¿Cómo funciona
- Qué grupos asignar. Tu sitio web determina los grupos correctos para cada miembro y los envía al foro.
- Si se debe iniciar un inicio de sesión único. Si los productos o programas de los miembros han caducado, su sitio web simplemente no los registra en el foro.
El foro nunca lee por sí mismo tus registros de membresía. Todo está impulsado por su sitio web.
Antes de empezar
- Obtenga su clave de API. La necesitas para todas las solicitudes de este artículo.
- Obtenga el ID de cada grupo de usuarios que quiera asignar, por ejemplo, un grupo por programa.
Asigne grupos cuando se cree una cuenta
Incluye el parámetro UserGroups en tu solicitud de inicio de sesión único. Si la cuenta aún no existe, se crea con esos grupos.
Separe los ID múltiples con comas. Estos grupos se aplican cuando se crea la cuenta por primera vez. Para cambiar de grupo más adelante, usa las solicitudes de API de la siguiente sección.
Actualice los grupos cuando cambie la membresía
Cuando un miembro compre, actualice o pierda un programa en tu sitio web, actualiza sus grupos de foros con la API Website Toolbox. Estas solicitudes se ejecutan desde tu servidor, por lo que puedes realizarlas en el momento en que se produzca el cambio. No es necesario que el miembro inicie sesión.
Actualiza todos los grupos de un miembro en una sola solicitud
Para realizar varios cambios a la vez, como añadir a un miembro a dos grupos y eliminarlo de uno, envía una solicitud al terminal del miembro con cada grupo al que debería pertenecer. Los grupos que envías sustituyen a los grupos actuales del miembro, por lo que debes incluir los grupos que quieras que conserven.
Para ver los grupos actuales de los miembros antes de reemplazarlos, envía una solicitud GET a la misma dirección.
La respuesta incluye los grupos de usuarios actuales del miembro.
Agregar o eliminar un grupo
Cuando solo necesites conceder o revocar un único grupo, usa el punto final del grupo en su lugar para no tener que enviar la lista completa.
USER_ID es el ID de usuario del foro del miembro, que la solicitud de inicio de sesión devuelve cuando se crea la cuenta. Puedes introducir nombres de usuario o direcciones de correo electrónico en lugar de identificadores de usuario. En su lugar, una dirección de correo electrónico para alguien que no tiene una cuenta en el foro le envía una invitación al grupo.
Decidir quién tiene acceso
Tu sitio web comprueba la membresía del miembro antes de iniciar el inicio de sesión único. Si aún tiene acceso, inicie sesión con el token, tal y como se describe en Inicio de sesión único: autenticación basada en un token. Si sus productos han caducado, no inicies el inicio de sesión único y no podrán iniciar sesión en el foro.
Preguntas frecuentes
¿Debo actualizar los grupos de los miembros o usar el punto final del grupo?
Envía la lista completa de grupos al terminal del miembro cuando cambies varios grupos a la vez. Usa el punto final del grupo cuando solo agregues o elimines un grupo.
¿Cuándo debo actualizar los grupos de usuarios de un miembro?
Actualiza los grupos cada vez que cambie la membresía del miembro en tu sitio web, por ejemplo, al realizar una compra, una mejora o una fecha de caducidad. No es necesario esperar a la próxima vez que el miembro inicie sesión.
¿Es necesario que el miembro inicie sesión para que los grupos se actualicen?
¡No!. La actualización es una solicitud de API de tu servidor, por lo que funciona independientemente de que el miembro haya iniciado sesión o visite el foro o no.
¿Qué es curl?
Curl es una herramienta de línea de comandos para enviar solicitudes HTTP que se incluye en macOS, Linux y las versiones recientes de Windows, por lo que los ejemplos de este artículo están escritos como comandos curl. Puedes enviar exactamente las mismas solicitudes desde cualquier lenguaje de programación con sus herramientas HTTP estándar, con los mismos parámetros en todos los idiomas. Consulta el código de ejemplo para realizar una solicitud HTTP para ver ejemplos en varios idiomas.
¿Por qué falla una solicitud de API?
Comprueba que la clave de API coincide con la clave de API de tu foro, que el ID de grupo y el ID de usuario son correctos y que el miembro ya tiene una cuenta en el foro.
¿Cómo puedo encontrar el ID de un grupo de usuarios?
Consulte Recuperar el ID de un grupo de usuarios.