Жалпы шарттар

Турлар тізілімі жүйесі туроператорлардың онлайн-брондау қосымшаларынан турларды автоматты түрде қосу үшін бағдарламалық шлюзге ие. Шлюз HTTPS-хаттамасын және JSON-деректерін беру форматын қолданады, аутентификация JSON-құрылымының ішіндегі айнымалылар арқылы жүзеге асырылады.

Қосылу HTTPS-хаттамасы үшін стандартты 443/tcp порты (production) және HTTP-хаттамасы үшін 80/tcp порты (тестілеу үшін) арқылы жүргізіледі (жөндеуді жеңілдету мақсатында). HTTP-тақырыптарында Content-Type тақырыбының мәні application/json болуы және User-Agent тақырыбының мәні онлайн-брондау бағдарламасы мен БҚ нұсқасын біржақты анықтауға мүмкіндік беретін кез келген мән болуы тиіс. POST HTTP-әдісі қолданылады. Сұрау сервердің түбіріне жіберіледі. Сұраудың негізгі бөлігінде жарамды JSON-сұрау құрылымы болуы тиіс.

Бір жерде болумен туркодты жасау

wget -q -O - 'http://test.fondkamkor.kz' -S --post-file=create.json --header 'Content-Type: application/json'

При этом файл create.json файлы келесіні қамтиды:

{
    "input":{
        "q_touragent":"ADIYA TRAVEL",
        "q_touragent_bin":"123456789012",
        "q_country":"Россия",
        "q_countryen":"Russia",
        "q_airport_start":"ALA",
        "q_airlines":"DV",
        "q_airport":"AAQ",
        "q_date_from":"17.11.2018",
        "q_date_to":"24.11.2018",
        "q_days":8,
        "q_remark":"tour notes here",
        "clientcounter":0,
        "c_name_0":"Client_$CID",
        "c_borned_0":"01.01.1970",
        "c_doc_date_0":"02.11.2016",
        "c_doc_number_0":"N08462365",
        "c_doc_production_0":"MIA OF RK"
    },
    "module":"voucher",
    "section":"partner",
    "object":"queries",
    "param1":"163",
    "param2":"save",
    "formid":163,
    "agentlogin":"test",
    "agentpass":"test",
    "return":"q_number"
}

Сервис жауабы шамамен келесідей болады:

  HTTP/1.1 200 OK
  Server: nginx/1.1.4
  Content-Type: application/json;charset=UTF-8
  Connection: close
  Cache-Control: no-store, no-cache, must-revalidate
  Pragma: no-cache
  Date: Sat, 19 Nov 2016 22:57:01 GMT
  FastCGI-PID: 17961{"status":200,"string":"4Ru61117-33"}

Сұрау және жауап құрылымдарын егжей-тегжейлі түсіндіру:

Сұрау

Хеш (объект) input:

Жауап

Бірнеше жерде болумен туркодты жасау

Бірнеше ұшумен күрделі турлар үшін қосымша деректер.

`input` ішіндегі қосымша өрістер

Айнымалы атауының соңындағы мәнді (_0) әрбір келесі ұшу үшін бірге арттыру қажет (_1, _2 және т.б.).

Күрделі турға арналған create.json мысалы:

{
    "input":{
        "q_touragent":"ADIYA TRAVEL",
        "q_touragent_bin":"123456789012",
        "q_country":"Россия",
        "q_countryen":"Russia",
        "q_airport_start":"ALA",
        "q_airlines":"DV",
        "q_airport":"AAQ",
        "q_date_from":"17.11.2018",
        "q_date_to":"24.11.2018",
        "q_days":8,
        "q_remark":"tour notes here",
        "clientcounter":0,
        "c_name_0":"Client_$CID",
        "c_borned_0":"01.01.1970",
        "c_doc_date_0":"02.11.2016",
        "c_doc_number_0":"N08462365",
        "c_doc_production_0":"MIA OF RK",
        
        "offercounter":1,
        "offertype_0":"flight",
        "o_date_from_0":"19.11.2018",
        "o_date_to_0":"21.11.2018",
        "o_airlines_0":"TK",
        "o_airport_0":"IST",
        "o_country_0":"Турция",
        
        "offertype_1":"flight",
        "o_date_from_1":"21.11.2018",
        "o_date_to_1":"24.11.2018",
        "o_airlines_1":"TG",
        "o_airport_1":"BKK",
        "o_country_1":"Таиланд"
    },
    "module":"voucher",
    "section":"partner",
    "object":"queries",
    "param1":"163",
    "param2":"save",
    "formid":163,
    "agentlogin":"test",
    "agentpass":"test",
    "return":"q_number"
}

Туркодты бүлдіру

Егер тур өзгерсе, ескі турдың күшін жою (оны “бүлдіру” деп белгілеу), жаңасын жасау және жаңа ТУРКОД алу қажет. Егер ескісінің күші жойылмаса, жарна екі рет есептен шығарылады.

wget -q -O - 'http://test.fondkamkor.kz' -S --post-file=bad.json --header 'Content-Type: application/json'

Бұл ретте bad.json файлы келесіні қамтиды:

{
    "input":{
        "msg":"Аннулируйте туркод - в нем неправильно указан город прилета. Верный туркод - 123456-7890",
        "replyto":"manager@touroperator.kz"
    },
    "module":"voucher",
    "section":"partner",
    "object":"queries",
    "param1":"4Ru61117-32",
    "param2":"bad",
    "agentlogin":"test",
    "agentpass":"test"
}

Сервис жауабы шамамен келесідей болады:

  HTTP/1.1 200 OK
  Server: nginx/1.1.4
  Content-Type: application/json;charset=UTF-8
  Connection: close
  Cache-Control: no-store, no-cache, must-revalidate
  Pragma: no-cache
  Date: Sat, 19 Nov 2016 22:57:01 GMT
  FastCGI-PID: 17961{"target":"/Voucher/partner/queries/33/view","status":200,
"string":"
Сіз сұралған мекенжайға бағытталасыз
..."}

Сұрау және жауап құрылымдарын егжей-тегжейлі түсіндіру:

Сұрау

Хеш (объект) input:

Жауап

ТУРКОДТЫ жасауды қайталау функциясы

Сервис қолжетімсіз болған немесе туроператордың БҚ-сында қателер болған жағдайда, ол кейінірек (біршама уақыттан кейін, бірден емес) ТУРКОДТЫ қайта алуға тырысуы немесе қызметкерлерге хабарлауы тиіс.

Анықтамалық әдістер

Тур параметрлеріндегі атауларды (елдер, әуежайлар) синхрондау үшін анықтамалықтар қажет. Белгісіз мәндері бар турлар өңделмейді.

Анықтамалық сұрауы

Хеш (объект) input:

Жауап

Елдер бойынша деректер массивін алу:

wget -q -O - 'http://test.fondkamkor.kz' -S --post-file=dict_countries.json --header 'Content-Type: application/json'

Файл dict_countries.json:

{
    "input":{
        "what":["country","countryen","currency"],
        "output":"array"
     },
     "module":"voucher",
     "section":"partner",
     "object":"dictionaries",
     "param1":"get",
     "param2":"countries",
     "agentlogin":"test",
     "agentpass":"test"
}

Сервис жауабы:

  HTTP/1.1 200 OK
  ...
  FastCGI-PID: 17961{"variants":[["Австралия","Australia","USD"],["Австрия","Austria","EUR"],...],"dictname":"countries"}

Әуежайлар бойынша деректер массивін алу:

wget -q -O - 'http://test.fondkamkor.kz' -S --post-file=dict_airports.json --header 'Content-Type: application/json'

Файл dict_airports.json:

{
    "input":{
        "what":["iata","icao","country","countryen"],
        "output":"array"
     },
     "module":"voucher",
     "section":"partner",
     "object":"dictionaries",
     "param1":"get",
     "param2":"airports",
     "agentlogin":"test",
     "agentpass":"test"
}

Авиажелілер бойынша деректер массивін алу:

wget -q -O - 'http://test.fondkamkor.kz' -S --post-file=dict_airlines.json --header 'Content-Type: application/json'

Файл dict_airlines.json:

{
    "input":{
        "what":["iata","icao","country","airline","companyname","address","airline_url"],
        "output":"array"
     },
     "module":"voucher",
     "section":"partner",
     "object":"dictionaries",
     "param1":"get",
     "param2":"airlines",
     "agentlogin":"test",
     "agentpass":"test"
}

Ұсыныс ретінде

1. Өз бағдарламаңызға “ТУРКОД” ұғымын енгізіңіз. ТУРКОДТЫ туристке/өтінімге байланыстырып, оған мәртебе (белсенді, бүлінген) және бүліну себебін берудің мағынасы бар. Осылайша, бір туристе бірнеше ТУРКОД болуы мүмкін (ескі бүлінген, жаңа қолданыстағы), және менеджер бұл процесті бағдарламадан басқара алады.
2. Қателерді өңдеуге назар аударыңыз. Маусымда менеджерлердің қателер туралы көптеген хаттарды оқуға уақыты болмайды (мысалы, “баланстағы қаражат бітті”). Критикалық немесе қайталанатын қателерді алған кезде деректерді тұрақты жіберуді өшіретін, жауапты тұлғаларға хабарлайтын қосқыш қажет.
3. Агент туралы көбірек деректерді көрсетіңіз. Егер агенттіктің атауы (q_touragent) өрісіне қала немесе email/телефонды қоссаңыз, бұл форс-мажор жағдайларында турагентті іздеуді жеңілдетеді және туроператор қызметкерлерінің жүктемесін азайтады.