REST API

Suggest Edits

If you're not already using the Fastlane Plugin, Gradle Plugin, or GitHub Action, you can upload manually your build using our REST API. The process looks like this:

Make a GET request to our /upload endpoint to retrieve a signed URL
Make a PUT request to the signed URL with the upload file contents

Getting a Signed URL

Using the /upload endpoint you can create a new upload and retrieve a signed URL to upload your uploaded file. The full documentation for this API endpoint is available here.

Emerge supports many common iOS & Android builds, see Supported Artifacts for a comprehensive list of all build types Emerge supports for iOS & Android.

Uploading to the signed URL

With the signed URL, you can make a PUT request to upload your app's build file.

If uploading a .zip file, the request should include the Content-Type: application/zip header. For example:

curl -v -H 'Content-Type: application/zip' -T MyArchive.xcarchive.zip "SIGNED_URL"

A complete example of a manual upload using shell commands is below:

#!/bin/bash

API_KEY=<YOUR_API_KEY>
PATH_TO_BUILD_ARTIFACT=<PATH_TO_YOUR_BUILD.xcarchive.zip>

json_body='{
  "filename":"your_build.xcarchive.zip",
  "branch":"example_branch_name",
  "repoName":"example_repo_name",
  "buildType":"release",
  "prNumber": "123",
  "sha":"123456",
  "baseSha":"654321",
  "previousSha":"123455"}'

upload_response=$(curl \
                     --url "https://api.emergetools.com/upload" \
                     --header 'Accept: application/json' \
                     --header 'Content-Type: application/json' \
                     --header "X-API-Token: $API_KEY" \
                     --data "$json_body")

# Pull the uploadURL field from the response using jq
upload_url=$(echo "$upload_response" | jq -r .uploadURL)

curl -v -H 'Content-Type: application/zip' -T "$PATH_TO_BUILD_ARTIFACT" "$upload_url"

Updated about 2 months ago