Tutoriel d'accès au catalogue
Introducción
Esta documentación tiene como objetivo guiar a los desarrolladores en la integración del catálogo de ventas y la realización de pedidos, con o sin pago, utilizando la API Yoplanning.pro. El objetivo es habilitar la venta de actividades de Yoplanning dentro de su sistema. Asumimos que ya ha leído la documentación de la API y que es propietario de su token de API.
Pasos del flujo de trabajo de integración
1. Recuperación de los Datos de tu Equipo
Punto final:
/api/v3.1/teams/Información esencial:
team_idyvendor_idUso: El
team_ides necesario para casi todas las solicitudes de API. Elvendor_ides necesario si desea utilizar el Administrador de pagos.
2. Obtención de la lista de productos
Punto final:
/api/v3.1/teams/[teamId]/online-products/Función: Recupera la lista de productos que se pueden vender online.
Parámetros adicionales:
lang: (cadena) Indica el idioma de los campos traducibles (como título, descripción, etc.). Utilice un código ISO2. Predeterminado:
en(inglés). Posibles opciones:fr(francés),de(alemán).start_date: (fecha) Filtra los resultados para devolver solo aquellos con disponibilidad después de esta fecha. Formato de fecha:
AAAA-MM-DD.end_date: (fecha) Filtra los resultados para devolver solo aquellos con disponibilidad antes de esta fecha. Formato de fecha:
AAAA-MM-DD.categoría: (cadena) Filtra productos por categoría específica.
3. Recuperación de la Disponibilidad del Producto
Punto final:
/api/v3.1/teams/[teamId]/online-products/[productId]/availabilities/Función: Muestra las sesiones disponibles para un producto específico.
Filtrado: Fecha, precio, número de entradas, personal (instructor), etc.
4. (Opcional) Recuperación de Opciones Disponibles (Equipo)
Punto final:
/api/v3.1/teams/[teamId]/availability-details/[pk]/Función: Recupera detalles de las opciones disponibles para una sesión específica.
5. (Opcional) Verificación de disponibilidad
Punto final:
/api/v3.1/teams/[teamId]/order-validationFunción: Permite comprobar si el contenido de la cesta aún está disponible antes de finalizar el pedido.
6. (Opcional) Crear un pago a través del Administrador de pagos
Punto final:
https://paid.yoplanning.pro/api/create-paidFunción: Crea un pago y recupera el enlace de pago.
Gestión de IPN: Gestión de notificación de pago instantáneo en la URL de devolución de llamada proporcionada.
7. Realizar el pedido
Punto final:
/api/v3.1/teams/[teamId]/orders/Función: Registra el pedido en Yoplanning, actualiza el cronograma, muestra el pedido y los participantes en Yoplanning, notifica al personal y actualiza la disponibilidad.
Ejemplo de uso con cURL
Recuperación de Productos:
curl https://yoplanning.pro/api/v3.1/teams/5a90332e-568f-4980-9859-88a984844a4d/online-products -H 'Authorization: Token 4504c2cb0d87a93106d4de029f407c86149f2ada'* **Recuperación de disponibilidad del producto**: ```bash curl https://yoplanning.pro/api/v3.1/teams/5a90332e-568f-4980-9859-88a984844a4d/online-products/f16ed6c6-e972-4232-b452-ecd393e61642/availabilities -H 'Authorization: Token 4504c2cb0d87a93106d4de029f407c86149f2ada' ``` * **Realizar el pedido**: ```bash curl -H "Content-Type: application/json" -X POST -d '{"external_reference" : "956", "items" : [{"session_group" : "4f655815-58d9-4c7c-b1c9-2ea152073371", "price" : {"amount" : 51.25}, "client" : {"id" : "71ea849f-226c-4302-a433-528179634aa7", "first_name" : "John", "last_name" : "Doe", "email" : "[email protected]"}}], "payments" : [{"amount" : 51.25, "client" : {"first_name" : "Framold", "last_name" : "Doe", "email" : "[email protected]"}}]}' https://yoplanning.pro/api/v3.1/teams/5a90332e-568f-4980-9859-88a984844a4d/orders -H 'Authorization: Token 4504c2cb0d87a93106d4de029f407c86149f2ada' ```
Asegúrate de reemplazar los ID y tokens con los de tu equipo para todas las solicitudes.
Nota: Esta documentación es un ejemplo básico de integración. Para obtener detalles más específicos y casos de uso avanzados, consulte la documentación oficial de la API de Yoplanning.pro.
Last updated