内测侠自动化接口文档

通过自动化接口,可以实现第三方平台调用内测侠接口,提交 udid,ipa 编号后, 内测侠自动签名.成功签名并生成安装地址后,内测侠会将安装地址数据发送到配置的回传地址!

1. 内测侠接收 udid 自动化签名任务接口

地址: https://www.neicexia.com/public_service/create_automation_service

Post 参数

参数名称	类型	长度限制	说明	示例
udid	string	-	设备 UDID 数据,多条数据需要以换行或者";"分隔,当 gain_cer_type 为 1 时必填	00008101-001D7A381168001E; 00008101-001D7A3811680014
udid_region_pool	string	-	udid 区域池,公共池:public,独立池:private,默认值:auto(当独立池可以添加 udid 时，优先使用独立池)	auto
udid_batch	string	-	udid 批次号,当 gain_cer_type 为 2 时必填	EASC3
gain_cer_type	int	-	获取证书方式:1.udid 新签(默认使用此值);2.通过 udid 批次号重签	1
use_new_account_when_apple_processing	int	-	当使用独立池添加的 udid 设备状态为苹果处理中时:1.切换新的可用账号续继添加;0:默认报错处理	1
force_use_appleid	string	-	当使用独立池时，可以指定强制添加 udid 到这个 appleid	your_appleid@icloud.com
ipa_source_type	int	-	IPA 来源: 1.服务器 IPA;2.远程网址	-
ipa_url	string	200	ipa 来源为 2 时可用;ipa 的远程下载网址	http://www.yoursite.com/test.ipa
ipa_new_appid	string	-	ipa 来源为 2 时可用;新的 appid	com.company.testapp1
ipa_new_name	string	-	ipa 来源为 2 时可用;新的 app 名称	测试 app
ipa_no	string	-	ipa 来源为 1 时可用;ipa 编号，可以在内测侠网站的 ipa 管理中查看,如果同时签名多个 ipa，则用";"分隔	EFTU6;EFTU7
task_id	string	100	用户自定义的数据，签名完成时会回传此数据	1234
info_plist_set	string	200	设置 Info.plist 的键值对,键值之间用":"分隔,多个键值对用";"分隔	key1:value1;key2:value2
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded

返回数据(json)格式:

{
  "IsSuccess": true,
  "ErrorMessage": null,
  "Data": {
    "udid_batch_no": "RS3ZH", //udid批次号
    "cer_batch_no": "RS3ZK", //证书账号批次号,使用udid批次号重签时不返回此项
    "task_batch_no": "CAS3A", //签名任务批次号（2018/1/18新增)
    "cer_appleid": "test_mail@sina.com", //仅使用独立池账号时返回，使用udid批次号重签时不返回此项
    "team_identifier": "73BSYFTSAF"
  },
  "ErrorCode": 0
}

调用接口前，请确保 udid 及在线签名余额充足。

2. 内测侠签名完成之后回传数据到用户网站

地址：用户在内测侠网站配置的回传地址

Post 参数:

参数名称	类型	长度限制	说明	示例
task_id	string	100	用户在前面接口传入的数据	1234
install_url	string	-	签名完成之后生成的内测侠安装地址,如果有多个 ipa，则地址之间用;隔开	https://www.neicexia.com/v/ABNAD; https://www.neicexia.com/v/ABNAE
plist_url	string	-	签名完成之后生成的内测侠 plist 文件地址,如果有多个 ipa，则地址之间用;隔开	https://www.neicexia.com/PlistFile/Get/ABNAD; https://www.neicexia.com/PlistFile/Get/ABNAE
file_name	string	-	签名完成之后生成的云存储文件名,如果有多个 ipa，则文件名之间用;隔开	uploaddata/test1.ipa; uploaddata/test2.ipa

内测侠会检查回传请求响应的结果，如果状态码为 200 则表示回传并处理成功。如果不是 200 的状态码，内测侠会连续重试三次。

3. 查询 udid 对应的 udid 批次号

地址: https://www.neicexia.com/public_service/query_cer

Post 参数:

参数名称	类型	长度限制	说明	示例
udid	string	-	设备 UDID 数据	00008101-001D7A381179001E
skip_processing_udid	string	-	"1"表示跳过审核中的 udid,"0"表示不跳过审核中的 udid,默认值为"0"	"0"
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded

返回结果:

{
  "IsSuccess": true,
  "Data": {
    "udid_batch_no": "HWS53",
    "create_date": "2021-09-28",
    "expire_date": "2021-09-27T18:46:17",
    "is_apple_processing": false,
    "mobile_provision_file_data": "base64data", //base64格式描述文件
    "p12_file_date": "base64data" //base64格式p12证书,密码为1
  },
  "ErrorMessage": null,
  "EnErrorMessage": null,
  "ErrorCode": 0,
  "ErrorID": null
}

查询时优先查询独立池，如果存在多条 udid 记录，则只返回最后添加的 udid 的批次号。

4. 查询任务批次号对应的安装地址

地址: https://www.neicexia.com/public_service/query_install_url

Post 参数:

参数名称	类型	长度限制	说明	示例
task_batch_no	string	-	任务批次号，添加签名任务后会返回此数据，也可以在内测侠的在线签名模块查看	CAS3A
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded

返回结果:

{
  "IsSuccess": true,
  "Data": [
    "https://www.neicexia.com/v/ABNAD",
    "https://www.neicexia.com/v/ABNAE"
  ],
  "ErrorMessage": null,
  "ErrorCode": 0
}

5. 提交企业证书签名任务

地址: https://www.neicexia.com/public_service/create_ent_cer_sign_task

Post 参数:

参数名称	类型	长度限制	说明	示例
ipa_source_type	int	-	IPA 来源: 1.服务器 IPA;2.远程网址	-
ipa_nos	string	-	ipa 来源为 1 时可用;ipa 编号，可以在内测侠网站的 ipa 管理中查看,如果同时签名多个 ipa，则用";"分隔	EFTU6;EFTU7
ipa_url	string	200	ipa 来源为 2 时可用;ipa 的远程下载网址	http://www.yoursite.com/test.ipa
ipa_new_appid	string	-	ipa 来源为 2 时可用;新的 appid	com.company.testapp1
ipa_new_name	string	-	ipa 来源为 2 时可用;新的 app 名称	测试 app
cer_batch_no	string	-	证书批次号	3defc
task_id	string	100	用户自定义的数据，签名完成时会回传此数据	1234
info_plist_set	string	200	设置 Info.plist 的键值对,键值之间用":"分隔,多个键值对用";"分隔	key1:value1;key2:value2
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded

返回数据(json)格式:

{
  "IsSuccess": true,
  "ErrorMessage": null,
  "Data": null,
  "ErrorCode": 0
}

调用接口前，请保证在线签名余额充足。

6. 检查 udid 批次号对应的证书是否有效

地址: https://www.neicexia.com/public_service/check_cer_validate

Post 参数:

参数名称	类型	长度限制	说明	示例
udid_batch	string	-	udid 批次号	EASC3
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded

返回结果:

{
  "IsSuccess": true,
  "Data": true,
  "ErrorMessage": null,
  "ErrorCode": 0
}

7. 创建 udid 证书(不创建在线签名任务)

地址: https://www.neicexia.com/public_service/create_udid_cer

Post 参数:

参数名称	类型	长度限制	说明	示例
udid	string	-	设备 UDID 数据,多条数据需要以换行或者";"分隔,当 gain_cer_type 为 1 时必填	00008101-001D7A381168001E; 00008101-001D7A381168031E
udid_region_pool	string	-	udid 区域池,公共池:public,独立池:private,默认值:auto(当独立池可以添加 udid 时，优先使用独立池)	auto
udid_batch	string	-	udid 批次号,当 gain_cer_type 为 2 时必填	EASC3
gain_cer_type	int	-	获取证书方式:1.新增 udid ;2.查询已有的 udid 证书	1
use_new_account_when_apple_processing	int	-	当使用独立池添加的 udid 设备状态为苹果处理中时:1.切换新的可用账号续继添加;0:默认报错处理	1
force_use_appleid	string	-	当使用独立池时，可以指定强制添加 udid 到这个 appleid	your_appleid@icloud.com
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded

返回结果:

{
  "IsSuccess": true,
  "Data": {
    "p12_file_date": "", //base64格式p12证书,密码为1
    "mobile_provision_file_data": "", //.mobileprovision文件,base64格式
    "udid_batch_no": "EASC3", //udid批次号
    "cer_appleid": "" //使用的appleid,仅限独立池
  },
  "ErrorMessage": null,
  "ErrorCode": 0
}

我会继续将剩余的 HTML 内容转换为 Markdown 格式。

8. 检查证书编号对应的证书是否有效

地址: https://www.neicexia.com/public_service/check_cer_validate_by_cerid

Post 参数:

参数名称	类型	长度限制	说明	示例
cer_id	string	-	证书编码	EASZ3
udid_region_pool	string	-	udid 区域池,公共池:public,独立池:private	-
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22

Content-type: application/x-www-form-urlencoded

返回结果:

{
  "IsSuccess": true,
  "Data": true,
  "ErrorMessage": null,
  "ErrorCode": 0
}

9. 检查 p12 证书文件是否有效

此接口接受 json 格式的 post 参数

地址: https://www.neicexia.com/public_service/check_p12_file_validate

Post 参数:

参数名称	类型	长度限制	说明	示例
p12_file_data	string	-	p12 文件数据,base64 编码格式	"MIIMHgIBA*******"
p12_password	string	-	p12 文件密码	-

Content-type: application/x-www-form-urlencoded

返回结果:

{
  "IsSuccess": true,
  "Data": true,
  "ErrorMessage": null,
  "ErrorCode": 0
}

9. 检查是否存在指定的teamid

此接口接受 json 格式的 post 参数

地址: https://www.neicexia.com/public_service/check_exist_teamid

Post 参数:

参数名称	类型	长度限制	说明	示例
token	string	-	接口 token,此数据可以内测侠网站"配置自动化接口"界面中生成	01f2dd73617e44718bb849596fa4a22
teamid	string	-	teamid,位于描述文件中TeamIdentifier字段	S6N8LJPNN8

Content-type: application/x-www-form-urlencoded

返回结果:

{
  "IsSuccess": true,
  "Data": true,
  "ErrorMessage": null,
  "ErrorCode": 0
}

重要提示: 请用户在使用接口前先认证邮箱，自动化接口在处理中出现错误时，会将具体的错误信息发送到认证的邮箱。

1. 内测侠接收 udid 自动化签名任务接口​

Post 参数​

返回数据(json)格式:​

2. 内测侠签名完成之后回传数据到用户网站​

Post 参数:​

3. 查询 udid 对应的 udid 批次号​

Post 参数:​

返回结果:​

4. 查询任务批次号对应的安装地址​

Post 参数:​

返回结果:​

5. 提交企业证书签名任务​

Post 参数:​

返回数据(json)格式:​

6. 检查 udid 批次号对应的证书是否有效​

Post 参数:​

返回结果:​

7. 创建 udid 证书(不创建在线签名任务)​

Post 参数:​

返回结果:​

8. 检查证书编号对应的证书是否有效​

Post 参数:​

返回结果:​

9. 检查 p12 证书文件是否有效​

Post 参数:​

返回结果:​

9. 检查是否存在指定的teamid​

Post 参数:​

返回结果:​

1. 内测侠接收 udid 自动化签名任务接口

Post 参数

返回数据(json)格式:

2. 内测侠签名完成之后回传数据到用户网站

Post 参数:

3. 查询 udid 对应的 udid 批次号

Post 参数:

返回结果:

4. 查询任务批次号对应的安装地址

Post 参数:

返回结果:

5. 提交企业证书签名任务

Post 参数:

返回数据(json)格式:

6. 检查 udid 批次号对应的证书是否有效

Post 参数:

返回结果:

7. 创建 udid 证书(不创建在线签名任务)

Post 参数:

返回结果:

8. 检查证书编号对应的证书是否有效

Post 参数:

返回结果:

9. 检查 p12 证书文件是否有效

Post 参数:

返回结果:

9. 检查是否存在指定的teamid

Post 参数:

返回结果: