Información del hotel

Datos que completan la estructura de las páginas del motor de reservas: datos de contacto y ubicación, enlaces a redes sociales, textos del pie de página (textos legales, información del hotel, fragmentos de Analytics/Ads) y configuración SMTP para los correos de confirmación.

GET/external/hotel/{hotelID}/contact/infoDatos de contacto GET/external/online/social/mediaEnlaces a redes sociales GET/external/online/footerTextos del pie de página GET/external/online/mail/hostConfiguración del servidor de correo

Datos de contacto#

GET/external/hotel/{hotelID}/contact/info

Autenticación: Authorization: Bearer

Parámetros de ruta

hotelIDintegerobligatorio

ID del hotel.

Respuesta

200 Operación correcta.

Respuestas de error

404 Hotel no encontrado.

Solicitud

curl "https://test.hms.gen.tr/external/hotel/1000/contact/info" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/hotel/1000/contact/info", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/hotel/1000/contact/info');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Respuesta · 200

{
    "title": "Demo Otel",
    "phone": "+90 258 000 00 00",
    "cellPhone": "+90 555 000 00 00",
    "email": "[email protected]",
    "www": "https://www.demootel.com",
    "address": "Kumsal Cad. No: 12",
    "country": "Türkiye",
    "countryIng": "Turkey",
    "city": "Antalya",
    "district": "Muratpaşa",
    "latitude": "36.8841",
    "longitude": "30.7056"
}

Enlaces a redes sociales#

GET/external/online/social/media

Autenticación: Authorization: Bearer

Parámetros de consulta

hotelIDintegerobligatorio

ID del hotel.

limitintegerpredeterminado: 20

Registros por página.

pageintegerpredeterminado: 1

Número de página.

orderstring

id o -id.

Respuesta

200 Operación correcta.

Solicitud

curl "https://test.hms.gen.tr/external/online/social/media?hotelID=1000" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/online/social/media?hotelID=1000", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/online/social/media?hotelID=1000');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Respuesta · 200

{
    "success": true,
    "count": 2,
    "items": [
        {
            "url": "https://www.instagram.com/demootel",
            "SosyalMedyaKategori": {
                "icon": "fa-instagram",
                "iconsvg": null
            }
        },
        {
            "url": "https://www.facebook.com/demootel",
            "SosyalMedyaKategori": {
                "icon": "fa-facebook",
                "iconsvg": null
            }
        }
    ]
}

Textos del pie de página#

GET/external/online/footer

Autenticación: Authorization: Bearer

Devuelve los textos multilingües que se introducen en el panel, en “Online Booking → Footer”. section selecciona el bloque: 0 textos legales (privacidad, venta a distancia…), 1 información del hotel, 2 fragmento de Analytics, 3 fragmento de Ads.

Parámetros de consulta

hotelIDintegerobligatorio

ID del hotel.

sectioninteger

Sección.

0123

Respuesta

200 Operación correcta.

Solicitud

curl "https://test.hms.gen.tr/external/online/footer?hotelID=1000&section=0" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/online/footer?hotelID=1000&section=0", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/online/footer?hotelID=1000&section=0');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Respuesta · 200

{
    "success": true,
    "count": 1,
    "items": [
        {
            "id": 5,
            "title": "Contrato de venta a distancia",
            "status": 1,
            "section": 0,
            "items": [
                {
                    "title": "Mesafeli Satış Sözleşmesi",
                    "text": "<p>…</p>",
                    "language": "Türkçe",
                    "languageID": 1,
                    "languageCode": "tr"
                },
                {
                    "title": "Distance Sales Agreement",
                    "text": "<p>…</p>",
                    "language": "English",
                    "languageID": 2,
                    "languageCode": "en"
                }
            ]
        }
    ]
}

Configuración del servidor de correo#

GET/external/online/mail/host

Autenticación: Authorization: Bearer

Devuelve la configuración SMTP que el hotel ha definido para los correos de confirmación de las reservas online. Incluye una contraseña; llama a este endpoint solo desde el servidor.

Parámetros de consulta

hotelIDintegerobligatorio

ID del hotel.

Respuesta

200 Operación correcta.

Respuestas de error

200 mail_host_is_not_found — no hay ningún SMTP configurado; hotel_id_is_not_found.

Solicitud

curl "https://test.hms.gen.tr/external/online/mail/host?hotelID=1000" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/online/mail/host?hotelID=1000", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/online/mail/host?hotelID=1000');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Respuesta · 200

{
    "success": true,
    "data": {
        "transport": "smtp",
        "encryption": "tls",
        "port": 587,
        "host": "smtp.demootel.com",
        "user": "[email protected]",
        "password": "********"
    }
}

Última actualización: 21 de septiembre de 2026¿Has encontrado un error? Avísanos