文档中心 > API类目 > 度假-签证管理API

alitrip.travel.visa.applicant.import (签证申请人导入)

签证线下申请人导入接口。供商家将线下的签证申请人信息导入,进行签证线上化办理

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
photo_file byte[] 必须 [1,2,3] 证件照文件字节流
outer_apply_id String 必须 123 外部商家申请人id
passport_file_type String 必须 jpg 护照文件类型
nation_id Number 必须 27027 国家id。目前支持越南(27027)
passport_file byte[] 必须 [1,1,1] 护照文件字节流
photo_file_type String 必须 jpg 证件照文件类型
form_data_json String 必须 {"lastNamePinyin":"拼音姓","firstNamePinyin":"拼音名","nameCh":"中文名","passportNumber":"G12345678","sex":"M","nationality":"CHN","birthday":"1900-01-01","enterDate":"2019-07-01","daibanTypeId":"1","domesticPhoneNum":"15911111111","applicantEmail":"12@qq.com"} 申请人信息。字段注释:1.sex(性别),值:M/F;2.nationality(国籍),值:CHN(中国大陆),HKG(中国香港),MAC(中国澳门),USA(美国),CAN(加拿大);3.daibanTypeId(代办类型):1(越南一个月单次入境),2(越南一个月多次入境),3(越南三个月单次入境),4(越南三个月多次入境)

响应参数

名称 类型 示例值 描述
outer_apply_id String 123 外部商家申请人id
apply_id String 5071_1 申请人id
last_name_pinyin String wang 拼音姓
first_name_pinyin String wu 拼音名
passport_number String G123 护照号
error_type Number 1 错误类型:1-数据重复,2-数据错误
error_msg String 上传失败 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelVisaApplicantImportRequest req = new AlitripTravelVisaApplicantImportRequest();
req.setPhotoFile(new FileItem("/tmp/file.txt"));
req.setOuterApplyId("123");
req.setPassportFileType("jpg");
req.setNationId(27027L);
req.setPassportFile(new FileItem("/tmp/file.txt"));
req.setPhotoFileType("jpg");
req.setFormDataJson("{\"lastNamePinyin\":\"拼音姓\",\"firstNamePinyin\":\"拼音名\",\"nameCh\":\"中文名\",\"passportNumber\":\"G12345678\",\"sex\":\"M\",\"nationality\":\"CHN\",\"birthday\":\"1900-01-01\",\"enterDate\":\"2019-07-01\",\"daibanTypeId\":\"1\",\"domesticPhoneNum\":\"15911111111\",\"applicantEmail\":\"12@qq.com\"}");
AlitripTravelVisaApplicantImportResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_travel_visa_applicant_import_response>
    <outer_apply_id>123</outer_apply_id>
    <apply_id>5071_1</apply_id>
    <last_name_pinyin>wang</last_name_pinyin>
    <first_name_pinyin>wu</first_name_pinyin>
    <passport_number>G123</passport_number>
    <error_type>1</error_type>
    <error_msg>上传失败</error_msg>
</alitrip_travel_visa_applicant_import_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部