Eventos simple
El primer paso de nuestra integración es enviar una solicitud a menta para crear un evento en su plataforma. Esto incluye toda la información relevante del evento que deseas gestionar. Asegúrate de que los datos sean completos y precisos para garantizar que el evento se cree correctamente.
¿Qué información del evento necesita menta para funcionar?
Información Necesaria
Para conocer qué información necesita menta para crear un evento, consulta el apartado Eventos en nuestra sección de Datos. Allí encontrarás los requisitos específicos y el formato esperado para los datos del evento.
Recuerden reemplazar "YOUR_API_KEY" por su clave de API Privada
Ejemplos de Solicitudes
Selecciona el lenguaje de programación que prefieras para ver un ejemplo de cómo enviar una solicitud para crear un evento.
- cURL
- Python
- Java
- PHP
curl -X POST "https://api.mentatickets.com/v1/events"
-H "Authorization: YOUR_API_KEY"
--data-raw "{
'title': 'The Lion King',
'description': 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
'externalReferenceId': 'the-lion-king-broadway',
'shows': [
{
'title': 'The Lion King in Broadway theatre',
'primarySalesUrl': 'https://yourplatform.com/event/the-lion-king-broadway/show/4726',
'status': 'LIVE',
'images': [{
'url': 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
'kind': 'main'
}],
'showId': '4726',
'date': '2022-04-02T14:00:00.000-04:00',
'ticketOptions': [
{
'title': 'Asiento Estándar',
'ticketId': '0001',
'description': 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
'price': 5500,
'currency': 'ARS'
},
{
'title': 'Asiento Premium',
'ticketId': '0002',
'description': 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
'price': 13800,
'currency': 'ARS'
}
]
}
],
'location': {
'city': 'New York City',
'state': 'New York',
'venueName': 'Broadway theatre',
'address': '200 W 45th Street',
'country': 'United States'
}
}"
import requests
import json
url = "https://api.mentatickets.com/v1/events"
api_key = "YOUR_API_KEY"
headers = {"Authorization": api_key}
data = {
'title': 'The Lion King',
'description': 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
'externalReferenceId': 'the-lion-king-broadway',
'shows': [
{
'title': 'The Lion King in Broadway theatre',
'primarySalesUrl': 'https://yourplatform.com/event/the-lion-king-broadway/show/4726',
'status': 'LIVE',
'images': [{
'url': 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
'kind': 'main'
}],
'showId': '4726',
'date': '2022-04-02T14:00:00.000-04:00',
'ticketOptions': [
{
'title': 'Asiento Estándar',
'ticketId': '0001',
'description': 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
'price': 5500,
'currency': 'ARS'
},
{
'title': 'Asiento Premium',
'ticketId': '0002',
'description': 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
'price': 13800,
'currency': 'ARS'
}
]
}
],
'location': {
'city': 'New York City',
'state': 'New York',
'venueName': 'Broadway theatre',
'address': '200 W 45th Street',
'country': 'United States'
}
}
response = requests.post(url, headers=headers, json=data)
import okhttp3.*;
import java.io.IOException;
OkHttpClient client = new OkHttpClient();
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
String json = "{
'title': 'The Lion King',
'description': 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
'externalReferenceId': 'the-lion-king-broadway',
'shows': [
{
'title': 'The Lion King in Broadway theatre',
'primarySalesUrl': 'https://yourplatform.com/event/the-lion-king-broadway/show/4726',
'status': 'LIVE',
'images': [{
'url': 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
'kind': 'main'
}],
'showId': '4726',
'date': '2022-04-02T14:00:00.000-04:00',
'ticketOptions': [
{
'title': 'Asiento Estándar',
'ticketId': '0001',
'description': 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
'price': 5500,
'currency': 'ARS'
},
{
'title': 'Asiento Premium',
'ticketId': '0002',
'description': 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
'price': 13800,
'currency': 'ARS'
}
]
}
],
'location': {
'city': 'New York City',
'state': 'New York',
'venueName': 'Broadway theatre',
'address': '200 W 45th Street',
'country': 'United States'
}
}";
RequestBody requestBody = RequestBody.create(JSON, json);
Request request = new Request.Builder()
.url("https://api.mentatickets.com/v1/events")
.addHeader("Authorization", "YOUR_API_KEY")
.post(requestBody)
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.body().string());
} catch (IOException e) {
e.printStackTrace();
}
<?php
$url = "https://api.mentatickets.com/v1/events";
$api_key = "YOUR_API_KEY";
$headers = array("Authorization: {$api_key}");
$data = array(
'title' => 'The Lion King',
'description' => 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
'externalReferenceId' => 'the-lion-king-broadway',
'shows' => array(
array(
'title' => 'The Lion King in Broadway theatre',
'primarySalesUrl' => 'https://yourplatform.com/event/the-lion-king-broadway/show/4726',
'status' => 'LIVE',
'images' => array(
array(
'url' => 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
'kind' => 'main'
)
),
'showId' => '4726',
'date' => '2022-04-02T14:00:00.000-04:00',
'ticketOptions' => array(
array(
'title' => 'Asiento Estándar',
'ticketId' => '0001',
'description' => 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
'price' => 5500,
'currency' => 'ARS'
),
array(
'title' => 'Asiento Premium',
'ticketId' => '0002',
'description' => 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
'price' => 13800,
'currency' => 'ARS'
)
)
)
),
'location' => array(
'city' => 'New York City',
'state' => 'New York',
'venueName' => 'Broadway theatre',
'address' => '200 W 45th Street',
'country' => 'United States'
)
'producers' => array(
array(
'name' => 'New York Events Producer',
'emails' => array('nyproductions@gmail.com'),
'producerId' => '819'
)
)
);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>
Respuesta JSON
{
"status": 200,
"data": {EVENTDATA},
"errors": null
}
Consideraciones Adicionales
Autenticación y Autorización: Asegúrate de que tu clave de API sea válida y tenga los permisos necesarios para crear eventos. Si encuentras errores de autenticación, verifica tu clave y los permisos asociados.
Formato de Fechas y Horas: La fecha y hora del evento deben estar en el formato correcto y en la zona horaria adecuada. (Ejemplo: '2022-04-02T14:00:00.000-04:00')
Manejo de Errores: Maneja adecuadamente los errores que pueden surgir al realizar la solicitud, como errores de red, errores de validación de datos o problemas con la API. Implementa lógica para capturar y manejar estos errores en tu aplicación.
Validación de Datos: Asegúrate de que todos los datos proporcionados en la solicitud sean válidos y cumplan con los requisitos de menta. Esto incluye validaciones para campos obligatorios y formatos específicos.
Actualización de Eventos: Si necesitas actualizar un evento después de crearlo, consulta la seccion de modificación de eventos para obtener mas detalles.
Revisión de la Respuesta: Revisa la respuesta de la API para confirmar que el evento se ha creado correctamente. La respuesta generalmente incluirá un ID de evento o un mensaje de éxito que puedes usar para confirmar la creación.
¡Listo! Con sólo proporcionarnos esta información, ya podremos continuar al siguiente paso.