Nominación

Asignación Nominal de Tickets

menta admite la integración de nominación de tickets, lo que permite asignar cada ticket a una persona específica en el momento de su emisión. Para implementar esta funcionalidad, es necesario incluir información adicional con cada ticket durante el proceso de creación. Esta información debe proporcionarse dentro de ticket.nominalTicket e incluir tanto fullName como identification.

Ejemplo de Integración

Para crear tickets con Asignación Nominal, debes utilizar el siguiente endpoint:

cURL

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, cURL.

    curl -X POST 'https://api.mentatickets.com/v1/tickets'
    -H 'Authorization: YOUR_API_KEY'
    -H 'Content-Type: application/json'
    --data-raw '[
        {
            "ticketOptionId": "0001",
            "showId": "4726",
            "externalReferenceEventId": "the-lion-king-broadway",
            "buyer": "buyer@emaildomain.com",
            "ticketId": "111",
            "ticketAccess": {
                "type": "URL",
                "locator": "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png",
                "status": "LOCKED"
            },
            "nominalTicket": {
                "fullName": "John Doe",
                "identification": "12345678"
            }
        }
    ]'

Python

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, Python.

import requests
import json

url = "https://api.mentatickets.com/v1/tickets"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json",
}

ticketOptionId = "0001"
showId = "4726"
externalReferenceEventId = "the-lion-king-broadway"
buyer = "buyer@emaildomain.com"
ticketId = "111"
ticketAccessType = "URL"
locator = "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png"
status = "LOCKED"

data = [
    {
        "ticketOptionId": ticketOptionId,
        "showId": showId,
        "externalReferenceEventId": externalReferenceEventId,
        "buyer": buyer,
        "ticketId": ticketId,
        "ticketAccess": {
            "type": ticketAccessType,
            "locator": locator,
            "status": status,
        },
        "nominalTicket": {
            "fullName": "John Doe",
            "identification": "12345678"
        }
    }
]

response = requests.post(url, headers=headers, data=json.dumps(data))

Java

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, Java.

import okhttp3.*;
import java.io.IOException;

OkHttpClient client = new OkHttpClient();
MediaType JSON = MediaType.get("application/json; charset=utf-8");

String ticketOptionId = "0001";
String showId = "4726";
String externalReferenceEventId = "the-lion-king-broadway";
String buyer = "buyer@emaildomain.com";
String ticketId = "111";
String ticketAccessType = "URL";
String locator = "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png";
String status = "LOCKED";

String json = String.format("""
        [
            {
                "ticketOptionId": "%s",
                "showId": "%s",
                "externalReferenceEventId": "%s",
                "buyer": "%s",
                "ticketId": "%s",
                "ticketAccess": {
                    "type": "%s",
                    "locator": "%s",
                    "status": "%s"
                },
                "nominalTicket": {
                    "fullName": "John Doe",
                    "identification": "12345678"
                }
            }
        ]
        """, ticketOptionId, showId, externalReferenceEventId, buyer, ticketId, ticketAccessType, locator, status);

RequestBody body = RequestBody.create(JSON, json);
Request request = new Request.Builder()
        .url("https://api.mentatickets.com/v1/tickets")
        .post(body)
        .addHeader("Authorization", "YOUR_API_KEY")
        .addHeader("Content-Type", "application/json")
        .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

PHP

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, PHP.

<?php
$url = "https://api.mentatickets.com/v1/tickets";
$headers = array(
    "Authorization: YOUR_API_KEY",
    "Content-Type: application/json",
);

$data = array(
    array(
        "ticketOptionId" => "0001",
        "showId" => "4726",
        "externalReferenceEventId" => "the-lion-king-broadway",
        "buyer" => "buyer@emaildomain.com",
        "ticketId" => "111",
        "ticketAccess" => array(
            "type" => "URL",
            "locator" => "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png",
            "status" => "LOCKED"
        ),
        "nominalTicket": {
            "fullName": "John Doe",
            "identification": "12345678"
        }
    )
);

$json_data = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Respuesta JSON

{
    "status": 200,
    "data": [{TICKETDATA}],
    "errors": null
}

Nominal Ticket Parameters

Campo	Tipo de Dato	Descripción	Ejemplo
fullName	String	User Full Name.	"John Doe"
identification	String	User Identification.	"41253482"

Para mas información detallada de Ticket y Seating diríjase a la sección de datos de ticket