Informações do hotel

Dados que preenchem a estrutura das páginas do motor de reservas: contato e localização, links de redes sociais, textos do rodapé (textos legais, sobre o hotel, códigos de analytics/anúncios) e configurações SMTP para os e-mails de confirmação.

GET/external/hotel/{hotelID}/contact/infoDados de contato GET/external/online/social/mediaLinks de redes sociais GET/external/online/footerTextos do rodapé GET/external/online/mail/hostConfigurações do servidor de e-mail

Dados de contato#

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

Autenticação: Authorization: Bearer

Parâmetros de caminho

hotelIDintegerobrigatório

ID do hotel.

Resposta

200 Sucesso.

Respostas de erro

404 Hotel não encontrado.

Requisição

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

Resposta · 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"
}

Links de redes sociais#

GET/external/online/social/media

Autenticação: Authorization: Bearer

Parâmetros de consulta

hotelIDintegerobrigatório

ID do hotel.

limitintegerpadrão: 20

Registros por página.

pageintegerpadrão: 1

Número da página.

orderstring

id ou -id.

Resposta

200 Sucesso.

Requisição

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

Resposta · 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 do rodapé#

GET/external/online/footer

Autenticação: Authorization: Bearer

Retorna os textos multilíngues cadastrados no painel em “Online Booking → Footer”. section seleciona o bloco: 0 textos legais (privacidade, venda a distância…), 1 sobre o hotel, 2 código do Analytics, 3 código do Ads.

Parâmetros de consulta

hotelIDintegerobrigatório

ID do hotel.

sectioninteger

Seção.

0123

Resposta

200 Sucesso.

Requisição

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

Resposta · 200

{
    "success": true,
    "count": 1,
    "items": [
        {
            "id": 5,
            "title": "Contrato de Venda a Distância",
            "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"
                }
            ]
        }
    ]
}

Configurações do servidor de e-mail#

GET/external/online/mail/host

Autenticação: Authorization: Bearer

Retorna as configurações SMTP que o hotel definiu para os e-mails de confirmação de reservas online. Contém uma senha; use somente no servidor.

Parâmetros de consulta

hotelIDintegerobrigatório

ID do hotel.

Resposta

200 Sucesso.

Respostas de erro

200 mail_host_is_not_found — nenhum SMTP configurado; hotel_id_is_not_found.

Requisição

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

Resposta · 200

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

Última atualização: 21 de setembro de 2026Encontrou um erro? Avise-nos