Общие условия

Система реестра туров имеет программный шлюз для автоматического добавления туров из приложений онлайн-бронирования туроператоров. Шлюз использует HTTPS-протокол и JSON-формат передачи данных с аутентификацией через переменные внутри JSON-структуры.

Подключение производится по стандартному для HTTPS-протокола порту 443/tcp (production) и HTTP-протокол 80/tcp для тестирования (для удобства отладки). В HTTP-заголовках должны присутствовать заголовки Content-Type со значением application/json и User-Agent со произвольным значением, позволяющим однозначно определить программу онлайн-бронирования и версию ПО. Используется HTTP-метод POST. Запрос производится на корень сервера. В теле запроса должна быть валидная 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/телефон, это облегчит поиск турагента в случае форс-мажоров и снизит нагрузку на сотрудников туроператора.