API食谱:API任务

本系列API Recipes描述了与差旅管理公司(TMC)、差旅供应商和需要获取员工差旅相关预订数据的企业应用程序相关的API任务。此菜谱假设您是当前的Concur客户或平台合作伙伴。

在你开始之前

检查下面的检查表，以确保您能够执行这个食谱中的任务。要查看参考信息，请单击要点中的链接。

手动添加新的行程

手动添加新行程将为您提供一系列次要任务，如将通过租赁汽车代理商网站进行租赁汽车预订，以将旅行信息汇编为乘坐旅行信息。它可用于将该数据公开到应用程序中心的应用程序，如visage，这是一个推动国际旅行警报的应用程序。

使用以下过程，您可以轻松地在沙箱中创建用于测试的行程。

  1. 登录到您的沙箱。

  2. 点击旅行选项卡。

    添加新预订
  3. 在“旅行提醒”中，单击即将到来的旅行选项卡。
  4. 点击手动添加新行程,添加新预订对话框出现了。

  5. 选择创建新行程从下到下，添加预订到Trip．

    创造新旅行

  6. 选择从:添加航班，添加汽车，添加酒店或者增加铁路（未显示）。使用下拉功能或使用免费表单字段输入适当的测试数据。

    添加新预订

带*的字段是必需的。

  1. 点击保存并关闭保存您的数据。
  2. 点击访问图书馆查看您手工创建的行程。

请参阅以下示例获取下面的行程详细信息，以获取指导意见：

XML示例请求与分页：
得到/ api /旅游/旅行/ v1.1 / ?createdAfterDate = 2012% 2 f02 % 2 f01&includemetadata = true&ItemsPerPage = 2和页面= 1HTTP/1.1主持人：www.concursolutions.com授权：OAuth{访问令牌}
XML与分页成功响应的示例：
HTTP/1.1200.好的内容类型：应用程序/ xml．..< ConnectResponse >< >元数据分页> << TotalPages >38< / TotalPages >< TotalItems >187<当前页>2< /当前页>< ItemsPerPage >2< / ItemsPerPage >< PreviousPageURL >https://www.concursolutions.com/api/travel/trip/v1.1/?createdAfterDate=2012%2F02%2F01,itemsPerPage = 5,页面= 3,IncludeMetAdata = true< / PreviousPageURL >https://www.concursolutions.com/api/travel/trip/v1.1/?createdAfterDate=2012%2F02%2F01,itemsPerPage = 5,页面= 1,IncludeMetAdata = true分页> < /<数据>< ItineraryInfoListxmlns =“http://www.concursolutions.com/api/travel/trop/2010/06”xmlns:我=“http://www.w3.org/2001/xmlschema-instance”>< ItineraryInfo >< TripId >naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP< / TripId >< TripName >从巴尔的摩到纽约< / TripName >< StartDateLocal >2012 - 02年- 15 - t09:00:00< / StartDateLocal >< EndDateLocal >2012 - 02年- 21 - t17:30:00< / EndDateLocal >< UserLoginId >cm@example.com< / UserLoginId >2012-02-14T17：13：07< / DateModifiedUtc ><标识>https://www.concursolutions.com/api/travel/trop/v1.1/naizqj0y2dbwjciqob2shtsozwbshdkdp.< / id >< / ItineraryInfo >< ItineraryInfo >< TripId >I2UWIJJW8R7OWL3IWLSIE9WIELXHAHWIL.< / TripId >< TripName >从巴尔的摩到西雅图< / TripName >< StartDateLocal >2012-03-26T09：00：00< / StartDateLocal >< EndDateLocal >2012-03-29T17：30：00< / EndDateLocal >2012 - 03 - 24 - t19:00:00< / DateModifiedUtc >< UserLoginId >cm@example.com< / UserLoginId ><标识>https://www.concursolutions.com/api/travel/trop/v1.1/i2uwijjw8r7wl3iwlsie9wielxhahwil.< / id >< / ItineraryInfo >< / ItineraryInfoList >> < /数据< / ConnectResponse >
在选择的工具中测试API。一个成功的回应应该是这样的:
HTTP/1.1200.好的内容类型：应用程序/ xml．..<？XML Version =“1.0”编码=“UTF-8”？><行程xmlns =“http://www.concursolutions.com/api/travel/trop/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >< ClientLocator >KK-CNQ-1M1P6-5HJ< / ClientLocator >ConcurTravel< / ItinSourceName >< TripName >从达拉斯到西雅图< / TripName ><评论/>< StartDateLocal >2013-12-21T07：25：00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >EveryGDS< / BookedVia >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012 - 07 - 24 - t19:15:52< / DateBookedLocal ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港> < /状态< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >F1672664579< / ConfirmationNumber >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >海< / StartCityCode >海< / EndCityCode >海< / StartLocation >< EndLocation >海< / EndLocation ><课程>E类> < /身体< >C身体< / >< >传播米> < /传播<空调装置>R< NumCars >1< / NumCars >< DiscountCode >346660< / DiscountCode >< DailyRate >44.0000< / DailyRate >< TotalRate >44.0000< RateType >D<货币>美元< >指控<固定><描述>减费<货币>美元< >数量0.0000< / >数量< IsPrimary >假< / IsPrimary >Dropoffee< / SemanticsCode >< SemanticsVendorType >C固定> < /<货币>美元< >数量44.0000< / >数量< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< IsPrimary >真的< / IsPrimary >天< / SemanticsCode >< SemanticsVendorType >C< PerUnit >日< / PerUnit >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< / AllowanceNumUnits >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >C123456789< BookingSource >ConcurCars2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >TravelSupplier< / ItinSourceName >1< / PassengerCount >< /预订><预订><段>酒店> <<供应商>CQ> < /供应商< >状态门将> < /状态< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >3364214265< / ConfirmationNumber >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< RateCode >Lv4.< / RateCode ><名称>同意酒店< HotelPropertyId >CONQ00：00< / CheckinTime >< CheckoutTime >00：00< NumPersons >1< / NumPersons >< NumRooms >1< / NumRooms >< CancellationPolicy >到达前1天< / CancellationPolicy >< DailyRate >240.3500< / DailyRate ><货币>美元< RoomDescription >1大床可访问的房间- k1rrc< >指控<率><货币>美元< >数量240.3500< / >数量< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< IsPrimary >假< / IsPrimary >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< PerUnit >日< / PerUnit >3.0000< / NumUnits >< / >速度< / >指控> < /酒店< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >0987654321< BookingSource >ConcurHotel.2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211.< / OriginalItinLocator >ConcurTravel< / ItinSourceName >1< / PassengerCount >< /预订>< /行程>