Upload API

Overview

This page describes the HTTP API for uploading instrumented builds to the Product Science Tool.

HTTP API

Host: productscience.app
Protocol: HTTPS
Content type: application/json
Charset: utf-8

To access the API endpoints, you must supply your productscience.token from the productscience.properties or (productscience.yaml) file as an Authorization header. For instance:

Authorization: Bearer {YOUR_TOKEN}

API

1. Submit build metadata and obtain upload URL

Call this endpoint when your build file is ready.

Request

POST /api/v1/projects/{projectName}/builds

JSON body with parameters:

• buildType (required) – INSTRUMENTED_APK (for iOS also)
• buildFileName (required) – file name, e.g. app-play-release.apk
• name – arbitrary name to distinguish the build, e.g. release-5.2.8
• description – arbitrary build description
• sourceControlId – VCS commit, e.g. git commit hash
• sourceControlIsoTimestamp – VCS commit timestamp in ISO 8601 format. To retrieve the timestamp in Git, you can use the following shell command: git show -s --format='%cI' <commit-hash>

Example:

{
  "buildType": "APK",
  "buildFileName": "app-play-release.apk",
  "name": "v5.2.8",
  "description": "Arbitrary description",
  "sourceControlId": "e3c0fedc625094db1cbb2823fd425b51ddc0932e",
  "sourceControlIsoTimestamp": "2024-03-07T14:55:43.540Z"
}

Response

JSON body with parameters:

• uploadSpec (required) – metadata to upload build to a storage
  • method (required) – HTTP method
  • url (required) – URL
  • headers (required) – map of HTTP headers
• build (required) – build metadata
  • id (required) – build ID number
  • contextId (required) – upload context ID obtained in step 1
  • buildType (required) – INSTRUMENTED_APK
  • buildFileName (required) – file name, e.g. app-play-release.apk
  • name – arbitrary name to distinguish the build, e.g. release-5.2.8
  • description – arbitrary build description
  • sourceControlId – VCS commit, e.g. git commit hash
  • sourceControlIsoTimestamp – VCS commit timestamp in ISO 8601 format
  • uploadState – UPLOADING or FINISHED or FAILED
  • dateCreated – build creation timestamp

Example:

{
  "uploadSpec": {
    "method": "PUT",
    "url": "https://storage.googleapis.com/some/path?someParams=someValue",
    "headers": {
      "Content-Type": "application/octet-stream",
      "X-Goog-Content-Length-Range": "0,1073741824"
    }
  },
  "build": {
    "id": 70,
    "contextId": 28,
    "buildType": "INSTRUMENTED_APK",
    "buildFileName": "app-play-release.apk",
    "name": "v5.2.8",
    "description": "Arbitrary description",
    "sourceControlId": "e3c0fedc625094db1cbb2823fd425b51ddc0932e",
    "sourceControlIsoTimestamp": "2024-03-07T14:55:43.540Z",
    "dateCreated": "2024-03-08T14:13:33.143Z",
    "uploadState": "UPLOADING"
  }
}

2. Upload file to the obtained URL

Use uploadSpec object from the previous response to upload a file as application/octet-stream.

{uploadSpec.method} {uploadSpec.url}
{uploadSpec.hearder1}: {uploadSpec.header1Value}
{uploadSpec.hearder2}: {uploadSpec.header2Value}
Content-Length: {YOUR_FILE_LENGTH}

{YOUR_FILE_BINARY_DATA}

cURL example

1. Submit build metadata and obtain upload URL

Request:

curl -X "POST" "https://test.productscience.app/api/v1/projects/{projectName}/builds" \
     -H 'Authorization: Bearer {YOUR_TOKEN}' \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "buildType": "INSTRUMENTED_APK",
  "buildFileName": "app-play-release.apk",
  "name": "v5.2.8"
  "description": "Arbitrary description",
  "sourceControlId": "e3c0fedc625094db1cbb2823fd425b51ddc0932e",
  "sourceControlIsoTimestamp": "2024-03-07T14:55:43.540Z",
}'

Response:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1430

{
  "uploadSpec": {
    "method": "PUT",
    "url": "https://storage.googleapis.com/some/path?someParams=someValue",
    "headers": {
      "Content-Type": "application/octet-stream",
      "X-Goog-Content-Length-Range": "0,1073741824"
    }
  },
  "build": {
    "id": 70,
    "contextId": 28,
    "buildType": "INSTRUMENTED_APK",
    "buildFileName": "app-play-release.apk",
    "name": "v5.2.8",
    "description": "Arbitrary description",
    "sourceControlId": "e3c0fedc625094db1cbb2823fd425b51ddc0932e",
    "sourceControlIsoTimestamp": "2024-03-07T14:55:43.540Z",
    "dateCreated": "2024-03-08T14:13:33.143Z",
    "uploadState": "UPLOADING"
  }
}

2. Upload file to the obtained URL

Request:

curl -X "PUT" "https://storage.googleapis.com/some/path?someParams=someValue" \
     -H 'Content-Type: application/octet-stream' \
     -H 'X-Goog-Content-Length-Range: 0,1073741824' \
     --data-binary "@{FILE_PATH}"

Response:

HTTP/1.1 200 OK
Content-Length: 0