Integraciones
Conecta una web de confianza a grupos, contactos y acceso de estudiantes.
Usa una integración si tu web necesita mostrar grupos disponibles, enviar una consulta o dar acceso a un estudiante después de una compra. Estas peticiones deben salir del servidor de tu web. Una clave en el código del navegador sería visible para los visitantes.
Un propietario de la organización crea la clave en Ajustes → Acceso a la API:
- Dale un nombre que indique qué web la usa. Elige solo los permisos necesarios para las tareas de abajo y pulsa Crear clave API.
- Copia la clave cuando aparezca y guárdala en la configuración segura del servidor. Taskpipe solo muestra la clave completa al crearla.
- Envía una petición de prueba desde tu servidor con la clave en la cabecera
x-api-key. Comprueba la respuesta antes de conectar un formulario o pago real.
La Referencia de la API indica rutas, campos, respuestas y errores. La API externa solo cubre las tres tareas de abajo; no da acceso a las rutas privadas de gestión o de estudiantes.
Elegir permisos
| Tarea | Permiso |
|---|---|
| Listar grupos | cohort:read |
| Registrar un contacto | lead:write |
| Dar acceso | student:write |
Cuando una web deje de usar una clave, revócala en Ajustes → Acceso a la API y quítala del servidor. Las peticiones con esa clave fallarán; sustitúyela primero en cualquier servidor que aún la necesite.