Note
You are viewing the Apps API whose scope is limited to Apps. If you are looking for the full API spec, check the Organizations API .
The Upload Build request endpoint is intended to upload a new Build (
.ipa
or .apk
or .aab
binary files) to Applivery.Definition #
- Method: POST
- URL:
https://api.applivery.io/v1/integrations/builds
- Authentication: required
- Headers:
Authorization: bearer <your_app_token>
Params #
Param | Type | Description |
---|---|---|
build
| File |
.ipa or .apk or .aab binary file
|
versionName
| String |
Human readable version name for this build. E.g.: RC-1
|
tags
| Array |
Comma separated tags. E.g.: tag1, tag2, tag3
|
changelog
| String |
Build release notes or log of changes E.g.: Bug fixing! .
|
notifyCollaborators
| Boolean |
Notify App and Organization collaborators. E.g.: true
|
notifyEmployees
| Boolean |
Notify App and Organization employees. E.g.: true
|
filter
| Nested array of strings |
List of groups that will be notified with support for AND / OR clauses. Each element within the same array will be considered as AND while each array will be an OR clause. E.g.: To notify users in group1 AND group2 OR in group3 use: [["group1", "group2"],["group3"]] .
|
notifyMessage
| String |
Notification message to send in the email. E.g.: Enjoy the App! .
|
notifyLanguage
| String |
"es" "en" "fr" "ge" "it" "zh" "pt" "ru"
|
deployer.name
| String |
Custom deployer display name. E.g.: Jenkins CI
|
deployer.info.commitMessage
| String |
Git commit message. E.g.: Fixed issue #123
|
deployer.info.commit
| String |
Git commit. E.g.: f52ace0
|
deployer.info.branch
| String |
Git branch. E.g.:develop
|
deployer.info.tag
| String |
Git tag. E.g.: RC-1
|
deployer.info.triggerTimestamp
| String |
CI trigger date/time. E.g.: 1558359012580
|
deployer.info.buildUrl
| String |
CI build URL. E.g.: https://...
|
deployer.info.ciUrl
| String |
CI platform URL. E.g.: https://...
|
deployer.info.repositoryUrl
| String |
Version control repository URL. E.g.: https://...
|
deployer.info.buildNumber
| String |
CI platform build number. E.g.: 73
|
Example request #
curl 'https://api.applivery.io/v1/integrations/builds' \
-X POST \
-H 'Authorization: bearer xyz...xyz' \
-F build=@'file.ipa' \
-F 'versionName=My awesome app version' \
-F 'tags=tag1, tag2, tag3' \
-F 'changelog=Bug fixing' \
-F notifyCollaborators=false \
-F notifyEmployees=false \
-F 'notifyMessage=Enjoy the App' \
-F 'notifyLanguage=en' \
-F 'filter[0][]=group1' \
-F 'filter[0][]=group2' \
-F 'filter[1][]=group3' \
-F 'deployer.name=Custom CI PLatform' \
-F 'deployer.info.commitMessage=Fixed issue 123' \
-F 'deployer.info.commit=f52ace0' \
-F 'deployer.info.branch=develop' \
-F 'deployer.info.tag=RC-1' \
-F 'deployer.info.triggerTimestamp=1558359012580' \
-F 'deployer.info.buildUrl=http://www.applivery.io/build/73' \
-F 'deployer.info.ciUrl=http://www.applivery.io/ci' \
-F 'deployer.info.repositoryUrl=https://github.com/applivery/applivery-ios-sdk' \
-F 'deployer.info.buildNumber=173'
Responses #
200 - Success
400 - Bad request
401 - Unauthorized
404 - Not found
Content type:
application/json
{
"status":true,
"data":{
"id":"string",
"status":"pending",
"tags":["string"],
"versionName":"string",
"application":"string",
"changelog":"string",
"file":{
"originalName":"string",
"mimetype":"string",
"size":0,
"bucket":"string",
"key":"string",
"location":"string"
},
"info":{
"icon":"string",
"android":{
"targetSdkVersion":"string",
"minSDKVersion":"string",
"packageName":"string",
"platformBuildVersionName":"string",
"platformBuildVersionCode":"string",
"versionName":"string",
"versionCode":"string",
"icon":"string"
},
"ios":{
"plist":{
"CFBundleDisplayName":"string",
"CFBundleSupportedPlatforms":[
"string"
],
"MinimumOSVersion":"string",
"CFBundleIdentifier":"string",
"CFBundleShortVersionString":"string",
"CFBundleVersion":"string",
"CFBundleName":"string",
"CFBundleIcons":[
"string"
]
},
"mobileprovision":{
"TeamIdentifier":"string",
"ProvisionsAllDevices":true,
"TeamName":"string",
"ProvisionedDevices":"string"
}
}
},
"size":"string",
"os":"ios",
"deployer":{
"name":"string",
"info":{
"git_branch":"string"
},
"build_trigger_timestamp":"string",
"build_url":"string",
"app_url":"string",
"git_repository_url":"string",
"build_number":"string",
"commit":"string",
"tag":"string"
},
"counts":{
"downloads":"string"
},
"uploadedBy":"string",
"createdAt":"string"
}
}
Content type:
application/json
{
"status": false,
"error": {
"code": 5006,
"message": "No File Found in request"
}
}
Content type:
application/json
{
"status": false,
"error": {
"code": 4002,
"message": "No auth token"
}
}
Content type:
application/json
{
"status": false,
"error": {
"code": 3001,
"message": "Entity not found"
}
}