版本：5.1.0

应用接口

上传应用

上传应用，仅支持 iOS, Android 和 macOS 类型。

POST /api/apps/upload

参数

信息

需要用户认证

名称	类型	是否必须	描述
file	`File`	true	应用本地路径的内容
channel_key	`String`	false	应用具体渠道的 Key，没有传此参数会字段创建对于的应用、类型和渠道
name	`String`	false	应用名称，为空时取 App 的信息
release_type	`String`	false	应用类型，比如 debug, beta, adhoc, release, enterprise 等
source	`String`	false	上传渠道名称，默认是 api
changelog	`String`	false	变更日志，接受纯文本或 JSON 格式化的数据
branch	`String`	false	上传应用时的git branch名称
git_commit	`String`	false	上传应用时的 git commit hash
ci_url	`String`	false	CI 项目构建地址
custom_fields	`String`	false	这是一个用 JSON 字符串定义的自定义字段，可配置名称，值以及 fontawesome 图标用于在页面详情展示

For changelog attribute which it accepts both plain text and JSON formatted contents:

plain text:

message 1\nmessage 2

JSON:

[
  {
    "message": "message 1",
    "author": "admin",
    "email": "admin@zealot.com",
    "date": "2021-11-11 11:11:11"
  },
  {
    "message": "message 1",
    "author": "developer",
    "email": "developer@zealot.com",
    "date": "2021-11-11 11:11:11"
  }
]

对于 custom_fields 的用法，它是一个使用 JSON 格式的以键值对为单位的数组，比如需要自定义国家 country=China 并配置图标为 fontawesome 的 flag

curl -X POST \
  'https://YOUR_ZEALOT_URL/api/apps/upload' \
   --form 'token="token"' \
   --form 'channel_key="channel_key"' \
+  --form 'custom_fields="[{"name":"country","value":"China","icon":"fas fa-flag"}]"' \
   --form 'file=@/path/to/your/app'

返回样例

{
	"id": 50,
	"version": 7,
	"app_name": "Test Android",
	"bundle_id": "com.test.app",
	"release_version": "1.0",
	"build_version": "1",
	"source": "SOURCE",
	"branch": "master",
	"git_commit": "e9de48513dbb6abfbxxxxxxxxxxxxxxxxxxxxxxxx",
	"ci_url": "",
	"size": 1565486,
	"icon_url": "/uploads/apps/a1/r1/icons/app_icon.png",
	"release_url": "https://YOUR_ZEALOT_URL/channels/1XmpC/releases/1",
	"install_url": "https://YOUR_ZEALOT_URL/download/releases/1",
	"qrcode_url": "https://YOUR_ZEALOT_URL/channels/1XmpC/releases/1/qrcode?size=thumb",
	"changelog": [
		{
			"message": "Changelog message 1"
		},
    {
			"message": "Changelog message 2"
		}
	],
  "text_changelog": "- Changelog message 1\n- Changelog message 2",
	"custom_fields": [],
	"created_at": "2021-09-01T11:43:33.977+08:00",
	"app": {
		"id": 1,
		"name": "App name"
	},
	"scheme": {
		"id": 8,
		"name": "Test"
	},
	"channel": {
		"slug": "1XmpC",
		"name": "Android",
		"device_type": "android",
		"bundle_id": "*",
		"git_url": null,
		"has_password": false
	}
}

应用列表

获取创建的应用列表，支持分页

GET /api/apps

参数

名称	类型	是否必须	描述
page	`Integer`	false	页数
per_page	`Integer`	false	每页返回最大数目

返回样例

[
    {
        "id": 1,
        "name": "Zealot",
        "schemes": [
            {
                "id": 1,
                "name": "测试版",
                "channels": [
                    {
                        "slug": "X1IXN",
                        "name": "Android",
                        "device_type": "android",
                        "bundle_id": "*",
                        "git_url": null,
                        "has_password": false
                    },
                    {
                        "slug": "O1qHk",
                        "name": "iOS",
                        "device_type": "ios",
                        "bundle_id": "*",
                        "git_url": null,
                        "has_password": false
                    }
                ]
            },
            {
                "id": 2,
                "name": "内测版",
                "channels": [
                    {
                        "slug": "l19Tl",
                        "name": "Android",
                        "device_type": "android",
                        "bundle_id": "*",
                        "git_url": null,
                        "has_password": false
                    },
                    {
                        "slug": "8selv",
                        "name": "iOS",
                        "device_type": "ios",
                        "bundle_id": "*",
                        "git_url": null,
                        "has_password": false
                    }
                ]
            }
        ]
    }
]

应用详情

查看应用的明细：应用类型、渠道等信息

GET /api/apps/:id

参数

名称	类型	是否必须	描述
id	`Integer`	true	应用 ID

返回样例

{
    "id": 1,
    "name": "Zealot",
    "schemes": [
        {
            "id": 5,
            "name": "测试版",
            "channels": [
                {
                    "slug": "X1IXN",
                    "name": "Android",
                    "device_type": "android",
                    "bundle_id": "*",
                    "git_url": null,
                    "has_password": false
                },
                {
                    "slug": "O1qHk",
                    "name": "iOS",
                    "device_type": "ios",
                    "bundle_id": "*",
                    "git_url": null,
                    "has_password": false
                }
            ]
        }
    ]
}

应用版本列表

获取应用已上传的版本列表，按照上传时间倒序排列

GET /api/apps/versions

参数

名称	类型	是否必须	描述
channel_key	`String`	true	应用具体渠道的 Key
page	`Integer`	false	页数
per_page	`Integer`	false	每页返回最大数目

返回样例

{
    "app_name": "Zealot iOS 测试版",
    "bundle_id": "*",
    "git_url": null,
    "app": {
        "id": 3,
        "name": "Zealot"
    },
    "scheme": {
        "id": 5,
        "name": "测试版"
    },
    "releases": [
        {
            "version": 2,
            "app_name": "Zealot iOS 测试版",
            "bundle_id": "im.ews.zealot",
            "release_version": "1.0.0",
            "build_version": "10292024",
            "source": "Web",
            "branch": "",
            "git_commit": "",
            "ci_url": "",
            "size": 79712596,
            "icon_url": "https://tryzealot.ews.im/uploads/apps/a3/r21/icons/8ab13dc08321f9f3412a9fa98689d9c3.png",
            "install_url": "itms-services://?action=download-manifest&url=https://tryzealot.ews.im/api/apps/O1qHk/1/install",
            "changelog": [],
            "created_at": "2019-12-25T14:26:06.608+08:00"
        },
        {
            "version": 1,
            "app_name": "Zealot iOS 测试版",
            "bundle_id": "im.ews.zealot",
            "release_version": "1.0.0",
            "build_version": "10291524",
            "source": "Web",
            "branch": "",
            "git_commit": "",
            "ci_url": "",
            "size": 79712596,
            "icon_url": "https://tryzealot.ews.im/uploads/apps/a3/r21/icons/8ab13dc08321f9f3412a9fa98689d9c3.png",
            "install_url": "itms-services://?action=download-manifest&url=https://tryzealot.ews.im/api/apps/O1qHk/1/install",
            "changelog": [],
            "created_at": "2019-12-25T14:26:06.608+08:00"
        },
    ]
}

应用最新版本

获取指定应用的最新版本信息

GET /api/apps/latest

参数

名称	类型	是否必须	描述
channel_key	`String`	true	应用具体渠道的 Key
release_version	`String`	true	应用的发布版本
build_version	`String`	true	应用的构建版本

返回样例

{
    "app_name": "Zealot iOS 测试版",
    "bundle_id": "*",
    "git_url": null,
    "app": {
        "id": 3,
        "name": "Zealot"
    },
    "scheme": {
        "id": 5,
        "name": "测试版"
    },
    "releases": {
        "version": 1,
        "app_name": "Zealot iOS 测试版",
        "bundle_id": "im.ews.zealot",
        "release_version": "1.0.0",
        "build_version": "10291524",
        "source": "Web",
        "branch": "",
        "git_commit": "",
        "ci_url": "",
        "size": 79712596,
        "icon_url": "https://tryzealot.ews.im/uploads/apps/a3/r21/icons/8ab13dc08321f9f3412a9fa98689d9c3.png",
        "install_url": "itms-services://?action=download-manifest&url=https://tryzealot.ews.im/api/apps/O1qHk/1/install",
        "changelog": [],
        "created_at": "2019-12-25T14:26:06.608+08:00"
    }
}

检查当前版本是否存在

使用 bundle_id、release_version、build_verion 或 bundle_id、git_commit 组合检查当前版本是否存在

GET /api/apps/version_exist

参数

名称	类型	是否必须	描述
channel_key	`String`	true	应用具体渠道的 Key
bundle_id	`String`	true	应用的包名，iOS 取 bundle_id，Android 取 package_name
release_version	`String`	false	应用的发布版本
build_version	`String`	false	应用的构建版本
git_commit	`String`	false	上传应用时的 git commit hash

返回样例

版本存在返回 200 状态码并返回版本的信息
版本不存在返回 404 状态码和错误信息

版本存在的返回信息

{
    "version": 1,
    "app_name": "好好住 iOS 测试版",
    "bundle_id": "com.haohaozhu.hhz",
    "release_version": "4.1.1",
    "build_version": "10291524",
    "source": "Web",
    "branch": "",
    "git_commit": "",
    "ci_url": "",
    "size": 79712596,
    "icon_url": "https://tryzealot.ews.im/uploads/apps/a3/r21/icons/8ab13dc08321f9f3412a9fa98689d9c3.png",
    "install_url": "itms-services://?action=download-manifest&url=https://tryzealot.ews.im/api/apps/O1qHk/1/install",
    "changelog": [],
    "created_at": "2019-12-25T14:26:06.608+08:00"
}

版本不存在的返回信息：

{
    "error": "应用版本不存在"
}

上传应用​

参数​

返回样例​

应用列表​

参数​

返回样例​

应用详情​

参数​

返回样例​

应用版本列表​

参数​

返回样例​

应用最新版本​

参数​

返回样例​

检查当前版本是否存在​

参数​

返回样例​

上传应用

参数

返回样例

应用列表

参数

返回样例

应用详情

参数

返回样例

应用版本列表

参数

返回样例

应用最新版本

参数

返回样例

检查当前版本是否存在

参数

返回样例