Este endpoint permite realizar el canje de tickets en el sistema de Experticket.

1. Método de Acceso

2. Datos de Envío

Para realizar el canje de tickets, se deben proporcionar los siguientes parámetros:

3. Ejemplo de Petición

curl -X POST "{baseurl}/api/ticketexchange" \

     -H "Content-Type: application/json" \

     -d '{

        "ApiKey": "{partnerId}",

        "Exchanges": [

            {

                "TicketAccessCode": "MyAccessCode1",

                "InternalCode": "MycustomCode1"

            },

            {

                "TicketAccessCode": "MyAccessCode2",

                "InternalCode": "MycustomCode2"

            }

        ]

     }'

4. Estructura de la Respuesta

5. Ejemplo de Respuesta Exitosa

{

    "Success": true,

    "Timestamp": "2025-02-05T15:40:00.000Z"

}

6. Ejemplo de Respuesta con Error

Si el ticket ya ha sido canjeado o es inválido, la API devuelve un mensaje de error:

{

    "Success": false,

    "ErrorMessage": "El código de acceso del ticket no es válido o ya ha sido canjeado.",

    "Timestamp": "2025-02-05T15:42:00.000Z"

}

7. Consideraciones Finales

• El ApiKey debe mantenerse en secreto y solo debe usarse en el servidor.
• El TicketAccessCode es obligatorio y debe ser válido para que el canje sea exitoso.
• El InternalCode es opcional y puede ser utilizado para asignar un identificador personalizado al ticket canjeado.
• Si el Success es false, revisar ErrorMessage para entender la causa del error.

El canje de tickets puede ser irreversible dependiendo de la configuración del sistema.