{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"a8804572-32df-4710-952f-a2b4fc41535a","name":"KIU-API SandBox Agencies","description":"**HOST-URL**: [https://kiuapi-stage.kiusys.net](https://kiuapi-stage.kiusys.net)\n\n## Getting Started.\n\nThis guide will help you to understand and start using KIU-API-Public.\n\nKIU-API-Public is a POST RESTful JSON API that KIU System Solutions offers exclusively for customers in order to access different functionalities known as functional groups such as \"air\", \"smartpricing\", \"services\" and many more.\n\nTo get started, we recommend you to review this documentation in order to understand how to use this product.\n\n---\n\n## How to Access KIU-API-Public\n\nKIU-API access is validated through a KIU-API-Token. This token grants users access to consume JSON services of a specific segment and the assigned group of functionalities. To obtain a KIU-API-Token, customers have to request it from KIU System Solutions at [kiuapi@kiusys.com](https://mailto:kiuapi@kiusys.com).\n\nWe will reply with the customer segment and the KIU-API-Token that allows segment users to consume the APIS.\n\n---\n\n## Environments\n\nKIU System Solutions offers customers a Stage environment (SandBox) for development purposes and the Production environment that will operates into the live environment.\n\nEach environment is determined by the host URL. Users need a valid KIU-API-Token for each of them.\n\n- **STAGE HOST**: [https://kiuapi-stage.kiusys.net](https://kiuapi-stage.kiusys.net)\n    \n- **PRODUCTION HOST**: [https://kiuapi.kiusys.net](https://kiuapi.kiusys.net)\n    \n\n_Note:_ _This documentation is based on Stage environment. The APIs support team will first create the access to Stage environment. Access to Production environment must be requested afterwards._\n\n---\n\n## 1 - How to Get a KIU-API-TOKEN\n\nCustomers may ask for a KIU-API-Token, e-mailing our _APIs_ support team at [kiuapi@kiusys.com](https://mailto:kiuapi@kiusys.com) with the following information:\n\n- **Group of functionalities to access**: User has to inform which functional segment or group of functionalities needs to consume (see Available Functional groups below).\n    \n- **Application name**: User has to declare a short name of the application that will consume the KIU-API-Public (e.g. \"web page\", \"mobile application\", etc.).\n    \n- **User e-mail:** User has to inform a contact e-mail of the responsible for the KIU-API-Public implementation for the customer.\n    \n\n---\n\n## 2 - Available Functional groups\n\nKIU System Solutions offers a group of functionalities, based on business logic in order to give users the access to the correct functionalities to implement.\n\n- **/air**: Group of services corresponding to the reservation system.\n    \n- **/smartpricing**: Group of services that combines pricing and itinerary options.\n    \n- **/services**: This group of functionalities hold the complex services that perfom a transaction such as create a booking, issue tickets, issue emds, modify reservation, etc.\n    \n- **/miscellaneous**: This group of functionalities allows user to get the miscellaneous content such as operation origin/destination list, dates of operation for a certain origin-destination, decode Ids, etc.\n    \n\nAt the time that customers are required to access, KIU System Solutions will inform the segment-name and the KIU-API-Token assigned that will be the designator name given to the customer and the functional segments decribed here will be the sub-segments.  \nThere are many more active APIS. This guide offers those common functionalities to create an IBE integration.\n\nE.g.:\n\n```\nhttps://kiuapi-stage.kiusys.net/agencies/services/create_booking\n\n ```\n\n---\n\n## 3 - Target URL will be:\n\n- **host**: [https://kiuapi.kiusys.net](https://kiuapi.kiusys.net) - The host URL determines the environment.\n    \n- **segment**: Determines the user customer and the KIU-API-Token that will be applied.\n    \n- **sub-segment**: Determines the functional segment whose action will be executed in a specific segment or group of services.\n    \n\n---\n\n## 4 - Creating a POST Request\n\nOnce you have the KIU-API-Token for a specific group of functionalities (segment) you are ready to make a POST request.\n\n- **Method**: POST - KIU-API-Public supports HTTP POST.\n    \n- **Content-Type**: application/json - Header - The API is a RESTful JSON.\n    \n- **KIU-API-Token**: \\[api-token\\] - Header - Valid API token obtained from KIU System Solutions.\n    \n- **JSON Request**: Valid JSON - Body - The JSON request to execute based on the definitions schemas.\n    \n\n```\n{\n    \"point_of_sale\": {\n        \"user\": \"LUCHOTRAVEL\",\n        \"kiu_device_id\": \"BUEA776002\",\n        \"agent_id\": \"BUEA7760A\",\n        \"preferred_display_currency\": \"ARS\",\n        \"country\": \"AR\",\n        \"agent_preferred_language\": \"es-AR\"\n    },\n    \"record_locator\": \"IZOJDW\"\n}\n\n ```\n\n_cURL example:_\n\n```\ncurl --location 'https://kiuapi-stage.kiusys.net/air/booking/get_booking_information' \\\n--header 'Content-Type: application/json' \\\n--header 'KIU-API-Token: {{customer_token}}' \\\n--data '{\n    \"point_of_sale\": {\n        \"user\": \"LUCHOTRAVEL\",\n        \"kiu_device_id\": \"BUEA776002\",\n        \"agent_id\": \"BUEA7760A\",\n        \"preferred_display_currency\": \"ARS\",\n        \"country\": \"AR\",\n        \"agent_preferred_language\": \"es-AR\"\n    },\n    \"record_locator\": \"IZOJDW\"\n}'\n\n ```\n\n- **Target URL** :  \n    [https://kiuapi-stage.kiusys.net/[customer_segment]/air/booking/get_booking_information](https://kiuapi-stage.kiusys.net/%5Bcustomer_segment%5D/air/booking/get_booking_information)\n    \n\n**Being:**\n\n- **Host:**[https://kiuapi-stage.kiusys.net](https://kiuapi-stage.kiusys.net)\n    \n- **Segment:** /agencies\n    \n- **Sub-segments:** /air/booking\n    \n- **End-point:** /get_booking_information\n    \n\n---\n\n# **List of Functionalities**","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"25793349","collectionId":"a8804572-32df-4710-952f-a2b4fc41535a","publishedId":"2sA3BuXpQv","public":true,"publicUrl":"https://kiuapi-docs-agencies.kiusys.net","privateUrl":"https://go.postman.co/documentation/25793349-a8804572-32df-4710-952f-a2b4fc41535a","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2024-04-29T16:04:10.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":"https://kiusys.net/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://kiuapi-docs-agencies.kiusys.net/view/metadata/2sA3BuXpQv"}