马蜂窝开放平台

获取出行人信息

根据订单号获取“出行人信息”
注意：目前出行人模板中新增境内手机号字段 mainland_phone 如果在出行人模板中配置了境内手机号，那么需要去取字段：mainland_phone 的值，来获取客户填写的境内手机号

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.order.traveler.get

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	是	2253512201801093938917	旅行商城业务订单号
traveler_id	int	否	12315	出行人ID

响应参数

参数名称	参数类型	示例	描述
order_id	string	2124976201711275278834	旅行商城业务订单号
travel_people	object	{}	出行人信息购买的产品不同，返回的信息也不同，文档中所列的属性可能不全以后台设置字段返回为准
traveler	array	[]	出行人信息
{}	object	0
└ name	string	小蜂	出行人姓名
└ id_type	string		证件类型如：当 id_type = 身份证；会返回id_card 目前会返回的类型：身份证/护照/港澳通行证/台湾通行证
└ birthday	string		出生年月日
└ gender	string		性别
└ nationality	string		国籍
└ height	number		身高(cm)
└ weight	number		体重(kg)
└ shoe_size	number	42	鞋码(欧码)
└ left_eye_sight	number		左眼视力
└ right_eye_sight	number		右眼视力
└ date_of_expiry	string		有效期
└ cellphone	string		联系电话
└ family_name	string	ma	姓（拼音）
└ mainland_phone	string	13012341234	境内手机号
└ traveler_id	int	123123	出行人ID
└ laissez_passer_tw	string		台湾通行证
└ laissez_passer	string		港澳通行证
└ passport	string		护照证件号
└ id_card	string	110101200001019736	身份证号码
└ first_name	string	xiaofeng	名（拼音）
trip	object	{}	出行信息
└ pick_up_time	string	11:00	接人时间
└ pick_up_place	string		接人地点
└ send_to	string		送达地点
└ pick_up_place_en	string		接人地点(英文)
└ send_to_en	string		送达地点(英文)
└ hotel_name_pick_up	string		接人酒店名称
└ hotel_address_pick_up	string		接人酒店地址
└ hotel_name_en_pick_up	string		接人酒店名称(英文)
└ hotel_address_en_pick_up	string		接人酒店地址(英文)
└ hotel_name_send_to	string		送达酒店名称
└ hotel_address_send_to	string		送达酒店地址
└ hotel_name_en_send_to	string		送达酒店名称(英文)
└ hotel_address_en_send_to	string		送达酒店地址（英文）
└ hotel_name_over_night	string		过夜酒店名称(英文)
└ flight_no_arrival	string		接机航班号
└ flight_time_arrival	string		航班抵达时间
└ flight_no_departure	string		送机航班号
└ flight_time_departure	string		航班起飞时间
└ luggage	string		行李数
└ hotel_name_en	string		接送酒店名称(英文)
└ hotel_address_en	string		接送酒店地址(英文)
└ hotel_phone	string		接人酒店电话
└ hotel_telephone	string		送达酒店电话
└ using_time	string		用车时间
└ using_place	string		用车地点
└ flight_number	string		接机/送机航班号
└ flight_time	string		降落/起飞时间
└ place	string		接人/送达地点
└ return_hotel	string		返回酒店名称(英文)
└ hotel_adress	string		返回酒店地址(英文)
└ return_hotel_phone	string		返回酒店电话
└ pick_and_send_hotel_phone	string		接送酒店电话
└ schedule	string		行程计划
└ back_hotel	string		返程送回酒店名称（英文）
└ back_adress	string		返程送回酒店地址（英文）
└ back_phone	string		返程送回酒店电话
└ hotel_name	string		酒店名称（英文）
└ hotel_address	string		酒店地址（英文）
└ hotel_phone_number	string		酒店联系电话
└ check_in_date	string		入住酒店日期
└ check_out_date	string		离开酒店日期
└ return_flight_number	string		返程航班号/火车列次
└ return_flight_time	string		返程航班/列次时间
└ arrival_date	string		航班抵达日期
└ departure_date	string		航班起飞日期
└ departure_hotel_name	string		出发酒店名称(英文)
└ departure_hotel_adress	string		出发酒店地址(英文)
└ departure_hotel_number	string		出发酒店电话
└ back_date	string		返程日期
└ over_night_hotel_address	string		过夜酒店地址(英文)
└ get_device_adress	string		取还设备地址
└ departure_hotel_name_cn	string		出发酒店名称（中文）
└ time	string		预约时间
└ number	string		用车人数
└ phone	string		境外联系电话
└ wechat	string		微信号
└ estimated_travel_date	string		预计出行日期
└ train_number	string		到达火车车次
└ train_station	string		到达车站
└ departure_time	string		出发时间(单选)
└ departure_frequency	string		出发班次
└ departure_hotel_area	string		出发酒店所在区域
└ meal_time	string		用餐时间
└ tourists_number	string	2	出行人个数
ts_address	object	{}	取还地址
└ pick_up_address	string	北京市	取件地址
└ return_address	string		还件地址
address	object	{}	地址信息
└ adress	string	北京市	收货地址
└ receiver_name	string	小蜂	收件人姓名
└ receiver_phone	string	15811267833	收货人电话

响应示例

{
    "order_id":"2124976201711275278834",
    "travel_people":{
        "traveler":[
            {
                "name":"小蜂",
                "id_type":"",
                "birthday":"",
                "gender":"",
                "nationality":"",
                "height":"",
                "weight":"",
                "shoe_size":"42",
                "left_eye_sight":"",
                "right_eye_sight":"",
                "date_of_expiry":"",
                "cellphone":"",
                "family_name":"ma",
                "mainland_phone":"13012341234",
                "traveler_id":"123123",
                "laissez_passer_tw":"",
                "laissez_passer":"",
                "passport":"",
                "id_card":"110101200001019736",
                "first_name":"xiaofeng"
            }
        ],
        "trip":{
            "pick_up_time":"11:00",
            "pick_up_place":"",
            "send_to":"",
            "pick_up_place_en":"",
            "send_to_en":"",
            "hotel_name_pick_up":"",
            "hotel_address_pick_up":"",
            "hotel_name_en_pick_up":"",
            "hotel_address_en_pick_up":"",
            "hotel_name_send_to":"",
            "hotel_address_send_to":"",
            "hotel_name_en_send_to":"",
            "hotel_address_en_send_to":"",
            "hotel_name_over_night":"",
            "flight_no_arrival":"",
            "flight_time_arrival":"",
            "flight_no_departure":"",
            "flight_time_departure":"",
            "luggage":"",
            "hotel_name_en":"",
            "hotel_address_en":"",
            "hotel_phone":"",
            "hotel_telephone":"",
            "using_time":"",
            "using_place":"",
            "flight_number":"",
            "flight_time":"",
            "place":"",
            "return_hotel":"",
            "hotel_adress":"",
            "return_hotel_phone":"",
            "pick_and_send_hotel_phone":"",
            "schedule":"",
            "back_hotel":"",
            "back_adress":"",
            "back_phone":"",
            "hotel_name":"",
            "hotel_address":"",
            "hotel_phone_number":"",
            "check_in_date":"",
            "check_out_date":"",
            "return_flight_number":"",
            "return_flight_time":"",
            "arrival_date":"",
            "departure_date":"",
            "departure_hotel_name":"",
            "departure_hotel_adress":"",
            "departure_hotel_number":"",
            "back_date":"",
            "over_night_hotel_address":"",
            "get_device_adress":"",
            "departure_hotel_name_cn":"",
            "time":"",
            "number":"",
            "phone":"",
            "wechat":"",
            "estimated_travel_date":"",
            "train_number":"",
            "train_station":"",
            "departure_time":"",
            "departure_frequency":"",
            "departure_hotel_area":"",
            "meal_time":"",
            "tourists_number":"2"
        },
        "ts_address":{
            "pick_up_address":"北京市",
            "return_address":""
        },
        "address":{
            "adress":"北京市",
            "receiver_name":"小蜂",
            "receiver_phone":"15811267833"
        }
    }
}

异常错误码

异常码	异常信息
10010030	该订单版本不支持
10010025	订单账号异常
10010024	没有操作权限