App APIs

Upload an app

This allows you to upload an single iOS, Android or macOS file.

POST /api/apps/upload

Parameters

info

Authentication required.

Attribute	Type	Required	Description
file	File	true	an App file
channel_key	String	false	Channel key Create a new App if leave it empty
name	String	false	the name of App Use app name from parsed metadata in given file if leave it empty
release_type	String	false	Eg, debug, beta, adhoc, release, enterprise 等
source	String	false	the source of upload (default is api)
changelog	String	false	Changelog Avaiables in plain text or JSON formatted struct
branch	String	false	a branch name from git
git_commit	String	false	git commit
ci_url	String	false	the build url of a C
custom_fields	String	false	JSON formatted custom fileds It could configures and display title, value and icon from fontawesome in a Release page from an App

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"
  }
]

For custom_fields attribute which it use JSON formatted struct to build from each key-value. for example, Display country name like country=China with icon 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'

Return body

{
	"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
	}
}

List apps

Get a list of app.

This function takes pagination parameters page and per_page to restrict the list of app.

GET /api/apps

Parameters

Attribute	Type	Required	Description
page	Integer	false	Page number (default: 1)
per_page	Integer	false	Number of items to list per page (default: 25, max: 100).

Return body

[
    {
        "id": 1,
        "name": "Zealot",
        "schemes": [
            {
                "id": 1,
                "name": "Adhoc",
                "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 an app

Allows you to receive information about an app like name, scheme, channel.

GET /api/apps/:id

Parameters

Attribute	Type	Required	Description
id	String	true	ID

Return body

{
    "id": 1,
    "name": "Zealot",
    "schemes": [
        {
            "id": 5,
            "name": "Test App",
            "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 versions list of app

Get a list of apps by the given channel key

GET /api/apps/versions

Parameters

Attribute	Type	Required	Description
channel_key	String	true	Channel key
page	Integer	false	Page number (default: 1)
per_page	Integer	false	Number of items to list per page (default: 25, max: 100).

Return body

{
    "app_name": "Zealot iOS",
    "bundle_id": "*",
    "git_url": null,
    "app": {
        "id": 3,
        "name": "Zealot"
    },
    "scheme": {
        "id": 5,
        "name": "AdHoc"
    },
    "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 the latest version of app

Allows you to receive the latest information about a Release version from App like app metadata, changelog, icon url, install (download) url.

GET /api/apps/latest

Parameters

Attribute	Type	Required	Description
channel_key	String	true	Channel key
release_version	String	true	Release version
build_version	String	true	Build version

Return body

{
    "app_name": "Zealot iOS",
    "bundle_id": "*",
    "git_url": null,
    "app": {
        "id": 3,
        "name": "Zealot"
    },
    "scheme": {
        "id": 5,
        "name": "AdHoc"
    },
    "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"
    }
}

Check version exists

Allows you to check the Release exists by given query, query accepts two combo group:

• bundle_id, release_version and build_verion
• bundle_id and git_commit

GET /api/apps/version_exist

Parameters

Attribute	Type	Required	Description
channel_key	String	true	Channel key
bundle_id	String	true	bundle_id or package_name
release_version	String	false	Release version
build_version	String	false	Build version
git_commit	String	false	git commit hash

Return body

• Return 200 if release existed.
• Return 404 if release not existed.

Success returns:

{
    "version": 1,
    "app_name": "Zealot iOS",
    "bundle_id": "im.ews.zealot",
    "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"
}

Not found returns:

{
    "error": "Not found release"
}