蒲公英文档中心

API 2.0

接口说明

利用蒲公英提供的接口,第三方开发者可以把蒲公英提供的应用上传托管、安装等功能,接入到自己的应用中,并且可以根据数据接口,获取蒲公英提供的各种应用数据,以方便开发者更容易的进行内测应用的分发。
  1. 除特别说明,所有数据API的请求方式均为HTTP POST方式。
  2. 获取图片等资源文件接口的请求方式为HTTP GET。
  3. API接口返回数据格式为JSON。
  4. 所有接口请求时,必须包含参数_api_key,以便识别接口身份。 点击获取_api_key
蒲公英现已推出API 2.0,推荐开发者使用,API 1.0版本将不再维护和更新。

常规参数说明

参数 别称 说明
_api_key API Key API Key,用来识别API调用者的身份,如不特别说明,每个接口中都需要含有此参数。对于同一个蒲公英的注册用户来说,这个值在固定的。点击获取_api_key
userKey User Key 用户Key,用来标识当前用户的身份,对于同一个蒲公英的注册用户来说,这个值在固定的。 点击获取userKey
appKey App Key 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
buildKey Build Key Build Key是唯一标识应用的索引ID,可以通过 获取App所有版本取得

示例代码

PHP调用接口示例(查看广场的应用):

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'http://www.pgyer.yunhuiju.com/apiv2/app/listAll');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, 'type=ios&_api_key=&page=1');
$response = curl_exec($curl);
if(curl_errno($curl)){
    echo curl_error($curl);
}
curl_close($curl);
$jsonData = json_decode($response, true);
print_r($jsonData);

上传App

通过该接口,开发者可以直接上传 App 到蒲公英。上传时,请使用 HTTP POST 方式,其中 enctype 为 'multipart/form-data'

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/upload

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
file File (必填) 需要上传的ipa或者apk文件
buildInstallType Integer (选填)应用安装方式,值为(1,2,3)。1:公开,2:密码安装,3:邀请安装。默认为1公开
buildPassword String (选填) 设置App安装密码,如果不想设置密码,请传空字符串,或不传。
buildUpdateDescription String (选填) 版本更新描述,请传空字符串,或不传。

返回数据

参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildType Integer 应用类型(1:iOS; 2:Android)
buildIsFirst Integer 是否是第一个App(1:是; 2:否)
buildIsLastest Integer 是否是最新版(1:是; 2:否)
buildFileSize Integer App 文件大小
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildIdentifier String 应用程序包名,iOS为BundleId,Android为包名
buildIcon String 应用的Icon图标key,访问地址为 http://www.pgyer.yunhuiju.com/image/view/app_icons/[应用的Icon图标key]
buildDescription String 应用介绍
buildUpdateDescription String 应用更新说明
buildScreenShots String 应用截图的key,获取地址为 http://www.pgyer.yunhuiju.com/image/view/app_screenshots/[应用截图的key]
buildShortcutUrl String 应用短链接
buildQRCodeURL String 应用二维码地址
buildCreated String 应用上传时间
buildUpdated String 应用更新时间

上传App示例

使用Linux下的crul命令上传App示例:

curl -F 'file=@/tmp/example.ipa' -F '_api_key=' http://www.pgyer.yunhuiju.com/apiv2/app/upload

请根据开发者自己的账号,将其中的 _api_key 的值替换为相应的值。

安装App

通过该接口可以直接使用手机安装 App,请使用 HTTP GET 方式。该接口仅在手机上可用,使用手机浏览器请求该地址即可开始安装。

API地址

GET http://www.pgyer.yunhuiju.com/apiv2/app/install

GET参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (选填, 但buildKey和appKey不能同时为空) App Key (值显示在应用详情—应用概述--App Key),也可以输入应用短链接。(安装最新版本)
buildKey String (选填, 但buildKey和appKey不能同时为空) Build Key (Build Key是唯一标识应用的索引ID,可以通过 获取App所有版本取得)(安装具体buildKey对应版本)
buildPassword String (选填) 当应用需要安装密码时,请传入应用安装密码

返回数据

接口会根据应用的类型(iOS或Android),自动使用相应的的安装方式来安装应用。

示例代码

http://www.pgyer.yunhuiju.com/apiv2/app/install?_api_key=&buildKey={buildKey}&buildPassword={buildPassword}

iOS应用内安装

iOS应用内安装接口,可以实现用户安装应用时,无需打开浏览器,即可直接安装的效果。接口地址:

itms-services://?action=download-manifest&url=https://www.pgyer.com/app/plist/{buildKey}

请将其中的{buildKey}换成App的buildKey,不包含大括号。

示例代码

Web:

<a href="itms-services://?action=download-manifest&url=https://www.pgyer.com/app/plist/{buildKey}">安装</a>

iOS:

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@'itms-services://?action=download-manifest&url=https://www.pgyer.com/app/plist/{buildKey}']];

或者:

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@'https://www.pgyer.com/apiv2/app/install?_api_key=&buildKey={buildKey}&buildPassword={buildPassword}']];

获取App详细信息

该接口可以获取某个 App 的某个具体版本的详细信息。

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/view

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (必填) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
buildKey String (选填) Build Key是唯一标识应用的索引ID,可以通过 获取App所有版本取得

返回数据

应用详情返回参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildType Integer 应用类型(1:iOS; 2:Android)
buildIsFirst Integer 是否是第一个App(1:是; 2:否)
buildIsLastest Integer 是否是最新版(1:是; 2:否)
buildFileSize Integer App 文件大小
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildIdentifier String 应用程序包名,iOS为BundleId,Android为包名
buildIcon String 应用的Icon图标key,访问地址为 http://www.pgyer.yunhuiju.com/image/view/app_icons/[应用的Icon图标key]
buildDescription String 应用介绍
buildUpdateDescription String 应用更新说明
buildScreenShots String 应用截图的key,获取地址为 http://www.pgyer.yunhuiju.com/image/view/app_screenshots/[应用截图的key]
buildShortcutUrl String 应用短链接
buildQRCodeURL String 应用二维码地址
buildCreated String 应用上传时间
buildUpdated String 应用更新时间
otherApps array 历史版本
otherAppsCount int 历史版本数量
历史版本返回参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildCreated String 应用上传时间
buildUpdated String 应用更新时间

修改App组详细信息(更新所有版本)

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/update

POST参数

参数 类型 说明
_api_key String (必填)API Key 点击获取_api_key
appKey String (必填) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
screenshot file (选填) 应用截图
buildName String (选填) 应用名称
buildShortcutUrl String (选填) 应用短链接地址
buildUpdateDescription String (选填,传值为空则更新为空) 应用更新说明
buildDescription String (选填,传值为空则更新为空) 应用说明
buildVersion String (选填) 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildInstallType Integer (选填) 应用安装方式
buildPassword String (选填,传值为空则更新为空) 设置应用密码

返回数据

返回参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildType Integer 应用类型(1:iOS; 2:Android)
buildIsFirst Integer 是否是第一个App(1:是; 2:否)
buildIsLastest Integer 是否是最新版(1:是; 2:否)
buildFileSize Integer App 文件大小
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildIdentifier String 应用程序包名,iOS为BundleId,Android为包名
buildIcon String 应用的Icon图标key,访问地址为 http://www.pgyer.yunhuiju.com/image/view/app_icons/[应用的Icon图标key]
buildDescription String 应用介绍
buildUpdateDescription String 应用更新说明
buildScreenShots String 应用截图的key,获取地址为 http://www.pgyer.yunhuiju.com/image/view/app_screenshots/[应用截图的key]
buildShortcutUrl String 应用短链接
buildQRCodeURL String 应用二维码地址
buildCreated String 应用上传时间
buildUpdated String 应用更新时间

修改App详细信息

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/updateApp

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
userKey User Key (必填) 用户Key,用来标识当前用户的身份,对于同一个蒲公英的注册用户来说,这个值在固定的。 点击获取userKey
buildKey String (必填) Build Key是唯一标识应用的索引ID,可以通过 获取App所有版本取得
screenshot file (选填) 应用截图
buildName String (选填) 应用名称
buildShortcutUrl String (选填) 应用短链接地址
buildUpdateDescription String (选填,传值为空则更新为空) 应用更新说明
buildDescription String (选填,传值为空则更新为空) 应用说明
buildPassword String (选填,传值为空则更新为空) 设置应用密码
buildVersion String (选填) 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildInstallType Integer (选填) 应用安装方式

返回数据

返回参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildType Integer 应用类型(1:iOS; 2:Android)
buildIsFirst Integer 是否是第一个App(1:是; 2:否)
buildIsLastest Integer 是否是最新版(1:是; 2:否)
buildFileSize Integer App 文件大小
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildIdentifier String 应用程序包名,iOS为BundleId,Android为包名
buildIcon String 应用的Icon图标key,访问地址为 http://www.pgyer.yunhuiju.com/image/view/app_icons/[应用的Icon图标key]
buildDescription String 应用介绍
buildUpdateDescription String 应用更新说明
buildScreenShots String 应用截图的key,获取地址为 http://www.pgyer.yunhuiju.com/image/view/app_screenshots/[应用截图的key]
buildShortcutUrl String 应用短链接
buildCreated String 应用上传时间
buildUpdated String 应用更新时间

获取App所有版本

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/builds

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (选填, 但appKey和buildKey不能同时为空) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
buildKey String (选填, 但appKey和buildKey不能同时为空) Build Key是唯一标识应用的索引ID
page Integer (选填) 历史版本分页页数

返回数据

返回参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildType Integer 应用类型(1:iOS; 2:Android)
buildFileSize Integer App 文件大小
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildIdentifier String 应用程序包名,iOS为BundleId,Android为包名
buildIcon String 应用的Icon图标key,访问地址为 http://www.pgyer.yunhuiju.com/image/view/app_icons/[应用的Icon图标key]
buildCreated String 应用上传时间

通过短链接获取App信息

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/getByShortcut

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
buildShortcutUrl String (必填) 应用短链接,例如pgyer.com/PgY8,只需要传入PgY8参数即可

返回数据

应用详情返回参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildIsFirst Integer 是否是第一个App(1:是; 2:否)
buildIsLastest Integer 是否是最新版(1:是; 2:否)
buildType Integer 应用类型(1:iOS; 2:Android)
buildFileName String 上传的应用文件名
buildFileSize Integer App 文件大小
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildIdentifier String 应用程序包名,iOS为BundleId,Android为包名
buildCreated String 应用上传时间
buildDescription String 应用介绍
buildUpdateDescription String 应用更新说明
buildShortcutUrl String 应用短链接
buildScreenshots String 应用截图的key,获取地址为 http://www-apiopt.pgyer.yunhuiju.com/image/view/app_screenshots/[应用截图的key]

查看自己上传的应用

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/listMy

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
page Integer (选填) 填写数字页数

返回数据

返回参数 类型 说明
buildKey String Build Key是唯一标识应用的索引ID
buildType Integer 应用类型(1:iOS; 2:Android)
buildFileSize Integer App 文件大小
buildName String 应用名称
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildIdentifier String 应用程序包名,iOS为BundleId,Android为包名
buildIcon String 应用的Icon图标key,访问地址为 http://www.pgyer.yunhuiju.com/image/view/app_icons/[应用的Icon图标key]
buildCreated String 应用上传时间

检测App是否有更新

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/app/check

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (必填) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
buildVersion String (选填) 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildBuildVersion Integer (选填) 蒲公英生成的用于区分历史版本的build号

返回数据

返回参数 类型 说明
buildVersion String 版本号, 默认为1.0 (是应用向用户宣传时候用到的标识,例如:1.1、8.2.1等。)
buildVersionNo String 上传包的版本编号,默认为1 (即编译的版本号,一般来说,编译一次会变动一次这个版本号, 在 Android 上叫 Version Code。对于 iOS 来说,是字符串类型;对于 Android 来说是一个整数。例如:1001,28等。)
buildBuildVersion Integer 蒲公英生成的用于区分历史版本的build号
buildUpdateDescription String 应用更新说明
buildShortcutUrl String 应用短链接
buildHaveNewVersion Boolean 是否有新版本
downloadURL String 应用安装地址

列出用户的App分组

这里说的分组,指的是开发者在「应用管理」-「我的分组」中设置的App分组。

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/appGroup/listAll

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key

返回数据

返回参数 类型 说明
appGroupName String App分组名称
appGroupKey String App分组唯一标识Key
appGroupShortcutURL String App分组的短链接
appGroupDescription String App分组的描述
appGroupCount String App分组中App的数量
appCreated String App分组的创建时间

查看用户的App分组

这里说的分组,指的是开发者在「应用管理」-「我的分组」中设置的App分组。 这个接口会返回某个App分组的详细信息,同时也返回这个分组里面包含的App信息(只列出最新版本)。

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/appGroup/view

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appGroupKey String (必填) 用户App分组的Key。可以通过 appGroup/listAll 接口获取。

返回数据

返回参数 类型 说明
appGroupName String App分组名称
appGroupKey String App分组唯一标识Key
appGroupShortcutURL String App分组的短链接
appGroupDescription String App分组的描述
appGroupCount String App分组中App的数量
appCreated String App分组的创建时间
apps Array 包含的app信息(返回最新版本信息)

查看App反馈信息列表

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/feedback/listAll

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (必填) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
page Integer (选填) 分页页数

返回数据

返回参数 类型 说明
feedbackContent String 反馈内容
feedbackImages Array 反馈信息中图片地址
feedbackVoice String 录音文件地址
feedbackFrom String 反馈信息来源
feedbackProcess Integer 反馈处理状态(1:已处理; 2:未处理)
feedbackCreated String 反馈创建时间
feedbackKey String feedbackKey

查看App反馈信息详情

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/feedback/view

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (必填) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
feedbackKey String (必填) 反馈信息的Key,可以通过feedbackListAll接口得到

返回数据

返回参数 类型 说明
feedbackContent String 反馈内容
feedbackImages Array 反馈信息中图片地址
feedbackVoice String 录音文件地址
feedbackDeviceName String 设备名称
feedbackOSVersion String 手机系统版本
feedbackOSType Integer 手机系统类型(1:iOS; 2:Android)
feedbackOSJailBroken Integer 手机是否越狱或ROOT(1:是; 2:否)
feedbackFreeRam String 手机剩余内存大小
feedbackFreeSpace String 手机剩余磁盘空间大小
feedbackNetwork String 手机网络
feedbackSDKVersion String SDK 版本
feedbackFrom String 反馈信息来源
feedbackProcess Integer 反馈处理状态(1:已处理; 2:未处理)
buildType Integer 应用类型 (1:iOS; 2:Android)
buildName String 应用名称
feedbackCreated String 反馈创建时间

查看应用Crash Log 列表

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/crash/listAll

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (必填) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
page Integer (选填) 分页页数

返回数据

返回参数 类型 说明
crashCount Integer Crash 数量
crashTitle String Crash 标题
crashPattern String Crash Pattern
crashDescribe String Crash 描述
crashAppVersion String Crash App 版本
crashProcess String Crash 处理状态
crashId Integer CrashGroupId
crashCreated String Crash 创建时间

查看应用Crash Log 详情

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/crash/view

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
appKey String (必填) 表示一个App组的唯一Key。例如,名称为'微信'的App上传了三个版本,那么这三个版本为一个App组,该参数表示这个组的Key。这个值显示在应用详情--应用概述--App Key。
crashId Integer (必填) crashId, 可以通过crashListAll获得某条crash的crashId

返回数据

返回参数 类型 说明
crashLog String Crash Log
crashCount Integer Crash 数量
crashTitle String Crash 标题
crashPattern String Crash Pattern
crashDescribe String Crash 描述
crashAppVersion String Crash App 版本
crashIsSymbolicated String Crash Log 是否符号化
crashIsReaded String Crash 是否已读
crashProcess String Crash 处理状态
crashViewStatus String Crash 查看状态
deviceAffectList Array 影响设备情况
crashCreated String Crash 创建时间

检测证书信息

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/check/certificate

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
file file (必填)证书文件
password String (选填) 证书密码

返回数据

返回参数 类型 说明
status String 证书状态
expired String 过期时间
name String 证书名称
explain String 证书状态详细解释

证书列表

通过该接口,开发者可以直接查看自己的证书管理。请使用 HTTP POST 方式

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/certificate/index

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
userKey String (必填) 用户的 userKey 点击获取userKey

返回数据

参数 类型 说明
certificateID Integer 证书的索引ID
certificateName String 证书名称
certificateExpired Date 证书的过期时间
certificateCreated Date 证书的上传时间
certificateStatus String 证书的状态

示例

使用Linux下的crul命令上传App示例:

curl  -F '_api_key=' -F 'userKey={#$u_key#$}' http://www.pgyer.yunhuiju.com/apiv2/certificate/index

请根据开发者自己的账号,将其中的 _api_key、userKey 替换为相应的值。

添加证书

通过该接口,开发者可以直接添加证书。请使用 HTTP POST 方式

API地址

POST http://www.pgyer.yunhuiju.com/apiv2/certificate/add

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
userKey String (必填) 用户的 userKey 点击获取userKey
fileCert File (必填) 请上传 p12 文件
fileProvision File (必填) 请上传 mobildprovision 文件
password File (选填) 证书的密码,如果没有密码时留空

返回数据

参数 类型 说明
certificateID Integer 证书的索引ID

示例

使用Linux下的crul命令上传App示例:

curl  -F 'fileCert=@ p12文件地址' -F 'fileProvision=@ mobileprovision文件地址' -F 'password=证书密码' -F '_api_key=' -F 'userKey={#$uKey#$}' http://www.pgyer.yunhuiju.com/apiv2/certificate/add

请根据开发者自己的账号,将其中的 _api_key、userKey 替换为相应的值。

重签名

POST参数

参数 类型 说明
_api_key String (必填) API Key 点击获取_api_key
userKey String (必填) 用户的 userKey 点击获取userKey
appKey App Key String | (选填) 表示一个App组的唯一Key。这个值显示在应用详情--应用概述--App Key。
buildKey Build Key String | (选填) Build Key是唯一标识应用的索引ID,可以通过 获取App所有版本取得 ,appKey 与 buildKey 不能同时为空
certificateID Integer (选填) 证书的 ID
isPublish Integer (选填) 是否重签成功后立即发布的蒲公英,1 为发布,0为不发布

返回数据

参数 类型 说明
syncToPgyer Bool 是否已发布到蒲公英
downloadUrl String 签名包下载地址

示例

使用Linux下的crul命令上传App示例:

curl  -F 'certificateID=证书的ID' -F 'isPublish=1' -F 'buildKey=应用的索引ID' -F 'appKey=App组的唯一Key' -F '_api_key=' -F 'userKey={#$uKey#$}' http://www.pgyer.yunhuiju.com/apiv2/certificate/add

请根据开发者自己的账号,将其中的 _api_key、userKey 替换为相应的值。

错误码含义

错误码 说明
1001 _api_key 不能为空
1002 _api_key 错误
1003 同步用户信息到Tracup出错信息
1007 搜索词太短
1008 Build Key 和 appKey 不能同时为空
1009 没有找到该App相关信息
1010 App Key 不能为空
1011 Build Id 不能为空
1012 User key 不能为空
1013 没有找到该用户
1014 应用类型不能为空
1015 文件或App类型错误
1016 无效的包名
1017 短链接已被使用或者不符合规范
1018 App 数量超过套餐的上限
1019 未实名认证
1020 用户被禁止上传
1021 文件无效
1022 文件过大
1023 build key 不能为空
1024 发布范围超过限制
1025 文件上传失败
1026 无效文件,文件类型错误
1027 应用名称长度不符合规范
1028 未找到应用的标识符
1029 短链接已被使用或不符合规范
1030 发布企业签名数量超过套餐最大值
1031 短链接不能为空
1032 短链接无效
1033 只能修改自己的应用
1035 修改的字段超过限制
1036 修改内容不能为空
1037 图片必须以数组的形式上传
1038 图片数据不能为空
1039 应用截图最多不能超过5张
1040 应用截图上传失败
1041 应用截图key不能为空
1042 反馈内容不能为空
1043 反馈内容过长,不能超过200字
1044 添加反馈出错
1045 无效的 user Key
1047 该应用收费,请使用手机进行安装
1048 应用已过期
1049 应用下载次数已用完
1050 密码错误
1051 应用违规
1052 应用仅认证用户可以下载
1053 下载速度超过限制
1054 今日下载次数已用完
1055 无效的 api key
1056 请在 iOS 系统中打开该链接
1057 同步专家测试企业签名应用参数错误
1058 解析应用出错
1059 废弃的方法
1060 请输入你的邮箱
1061 请输入你的密码
1062 用户名或者密码不正确
1063 该邮箱已存在
1064 请输入你的用户名
1065 用户名不能超过15个字符
1066 请输入你的姓名
1067 请输入你的公司
1068 请输入你的职业
1069 该手机号码已存在
1070 请输入验证码
1071 验证码无效
1072 该邮箱不存在
1073 请输入正确的账户信息
1075 App group key 不能为空
1076 App key 不正确
1079 录音上传失败
1080 反馈失败
1081 非法请求
1082 Feedback Key 不能为空
1083 反馈信息未找到
1084 日志信息不能为空
1085 系统类型不正确
1086 crash id 不能为空
1087 crash 信息没有找到
1089 获取平台参数不能为空
1090 平台参数为windows或者mac
1091 版本参数不对
1092 版本信息没有找到
1093 没有找到信息
1094 app group key 不正确
1095 应用名称过长
1096 错误的方法
1097 签名错误
1098 Api 请求达到每小时的上限
1099 更新 App 失败
1100 没有找到 App 分组信息
1102 请输入邮箱验证码
1103 您输入的验证码不正确
1104 您输入的邮箱地址无效
1105 该账号已存在
1106 真实姓名的长度必须小于15
1107 请填写密码
1108 请正确填写您的手机号码
1109 请输入您的6位验证码
1110 注册失败
1111 请输入你的账号
1112 该手机号码绑定多个账号,请使用密码进行登录
1113 请填写邮箱地址
1115 用户不存在
1116 手机号码或密码不正确
1117 邮箱地址或密码不正确
1118 请输入手机号码
1120 每次发送短信的间隔必须在30秒以上
1121 验证失败
1213 仅支持 iOS 应用证书检测
1214 服务器异常,稍后再试