Cómo obtener detalles de la actividad
Después de encontrar una actividad mediante la búsqueda, utilice el punto final de detalles para recuperar información completa sobre ella. Puedes solicitar todos los datos disponibles o limitar la respuesta a apartados concretos.
Punto final
GET {{api_host}}/api/ext/activity/details/{productCode}?include=all¤cy=USD
encabezados
| Encabezado | Requerido | Descripción |
|---|
x-api-key | Sí | Su clave API de Xeni |
Accept-Language | No | Idioma del contenido de la respuesta (por ejemplo, en). El valor predeterminado es inglés. |
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|
productCode | cadena | Sí | El código de producto único para la actividad, obtenido de los resultados de la búsqueda. |
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|
include | cadena | No | Especifica qué secciones incluir en la respuesta. El valor predeterminado es all. |
currency | cadena | No | Código de moneda para precios (por ejemplo, "USD"). |
Incluir opciones
| Valor | Descripción |
|---|
all | Devuelve toda la información disponible (detalles, ubicaciones, fechas). |
details | Devuelve solo la descripción de la actividad, aspectos destacados e información general. |
locations | Devuelve solo las ubicaciones de las actividades, los puntos de encuentro y la información de recogida. |
dates | Devuelve sólo las fechas disponibles y la información de programación. |
Solicitud de ejemplo
GET {{api_host}}/api/ext/activity/details/12345ABC?include=all¤cy=USD
Con el encabezado Accept-Language:
Notas de uso
- Utilice
include=all cuando muestre una página de detalles de actividad completa al usuario. Esto devuelve los datos más completos en una sola solicitud. - Utilice valores
include específicos (por ejemplo, details o dates) cuando solo necesite un subconjunto de datos, lo que puede reducir el tamaño de la respuesta y mejorar el rendimiento. - El encabezado
Accept-Language controla el idioma del texto descriptivo en la respuesta. Si no se proporciona, la respuesta predeterminada es inglés. - El parámetro
currency garantiza que todos los datos de precios se devuelvan en la moneda especificada. - Guarde el
productCode de esta respuesta; lo necesitará al verificar la disponibilidad y crear reservas.
Próximos pasos
Una vez que tengas los detalles de la actividad, consulta la disponibilidad en tiempo real para fechas específicas. Consulte Cómo verificar la disponibilidad de la actividad.