Informations de l’hôtel

Données qui alimentent l’habillage des pages du moteur de réservation : coordonnées et localisation, liens vers les réseaux sociaux, textes de pied de page (mentions légales, présentation, extraits Analytics/Ads) et paramètres SMTP des e-mails de confirmation.

GET/external/hotel/{hotelID}/contact/infoCoordonnées GET/external/online/social/mediaLiens vers les réseaux sociaux GET/external/online/footerTextes de pied de page GET/external/online/mail/hostParamètres du serveur de messagerie

Coordonnées#

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

Authentification: Authorization: Bearer

Paramètres de chemin

hotelIDintegerobligatoire

Identifiant de l’hôtel.

Réponse

200 Succès.

Réponses d’erreur

404 Hôtel introuvable.

Requête

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);

Réponse · 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"
}

Liens vers les réseaux sociaux#

GET/external/online/social/media

Authentification: Authorization: Bearer

Paramètres de requête

hotelIDintegerobligatoire

Identifiant de l’hôtel.

limitintegerpar défaut: 20

Nombre d’enregistrements par page.

pageintegerpar défaut: 1

Numéro de page.

orderstring

id ou -id.

Réponse

200 Succès.

Requête

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);

Réponse · 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
            }
        }
    ]
}

Textes de pied de page#

GET/external/online/footer

Authentification: Authorization: Bearer

Renvoie les textes multilingues saisis dans le panneau sous « Online Booking → Footer ». section sélectionne le bloc : 0 textes légaux (confidentialité, vente à distance…), 1 présentation de l’hôtel, 2 extrait Analytics, 3 extrait Ads.

Paramètres de requête

hotelIDintegerobligatoire

Identifiant de l’hôtel.

sectioninteger

Section.

0123

Réponse

200 Succès.

Requête

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);

Réponse · 200

{
    "success": true,
    "count": 1,
    "items": [
        {
            "id": 5,
            "title": "Contrat de vente à distance",
            "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"
                }
            ]
        }
    ]
}

Paramètres du serveur de messagerie#

GET/external/online/mail/host

Authentification: Authorization: Bearer

Renvoie les paramètres SMTP configurés par l’hôtel pour les e-mails de confirmation des réservations en ligne. Contient un mot de passe : à utiliser uniquement côté serveur.

Paramètres de requête

hotelIDintegerobligatoire

Identifiant de l’hôtel.

Réponse

200 Succès.

Réponses d’erreur

200 mail_host_is_not_found — aucun SMTP configuré ; hotel_id_is_not_found.

Requête

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);

Réponse · 200

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

Dernière mise à jour: 21 septembre 2026Vous avez repéré une erreur ? Signalez-la-nous