Upload a listing image

curl --request POST \
  --url https://api.tassyir.io/developer/apps/{appId}/listing/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file

const form = new FormData();
form.append('file', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.tassyir.io/developer/apps/{appId}/listing/media', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "<string>",
    "kind": "<string>",
    "url": "<string>",
    "contentType": "<string>",
    "width": 4503599627370496,
    "height": 4503599627370496,
    "bytes": 4503599627370496,
    "status": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "retiredAt": "2023-11-07T05:31:56Z"
  }
}

{
  "code": "BAD_REQUEST",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_TOKEN_INVALID",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_ACCOUNT_SUSPENDED",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "APP_NOT_FOUND",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "APP_READ_ONLY",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "FILE_TOO_LARGE",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_RATE_LIMITED",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>",
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_RATE_LIMIT_UNAVAILABLE",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

Listing

Upload a listing image

One image a call, as multipart/form-data: the file in file, its kind. The BYTES decide what it is: PNG, JPEG or WebP (never SVG or GIF), at most 2 MB. An icon is square, 512 to 1200 px; a desktop screenshot 16:9 from 1600x900 to 3200x1800; a mobile one 9:16 from 900x1600 to 1800x3200. An app holds at most 20 images (drafts included), and a developer uploads at most 30 every 10 minutes. An image no draft names is deleted 7 days after it was uploaded.

Takes the dashboard session or a developer token (tsy_dt_…); either way the caller is the signed-in user, and only their own account, apps and tokens are reachable.

POST

developer

apps

{appId}

listing

media

Upload a listing image

curl --request POST \
  --url https://api.tassyir.io/developer/apps/{appId}/listing/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file

const form = new FormData();
form.append('file', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.tassyir.io/developer/apps/{appId}/listing/media', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "<string>",
    "kind": "<string>",
    "url": "<string>",
    "contentType": "<string>",
    "width": 4503599627370496,
    "height": 4503599627370496,
    "bytes": 4503599627370496,
    "status": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "retiredAt": "2023-11-07T05:31:56Z"
  }
}

{
  "code": "BAD_REQUEST",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_TOKEN_INVALID",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_ACCOUNT_SUSPENDED",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "APP_NOT_FOUND",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "APP_READ_ONLY",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "FILE_TOO_LARGE",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "BAD_REQUEST",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_RATE_LIMITED",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

{
  "statusCode": 123,
  "message": "<string>",
  "path": "<string>",
  "requestId": "<string>"
}

{
  "code": "DEVELOPER_RATE_LIMIT_UNAVAILABLE",
  "message": "<string>",
  "statusCode": 123,
  "fix": "<string>",
  "errors": [
    {
      "code": "<string>",
      "path": "<string>",
      "message": "<string>",
      "fix": "<string>"
    }
  ],
  "path": "<string>",
  "requestId": "<string>"
}

Authorizations

Authorization

string

header

required

The dashboard's session token (Authorization: Bearer <JWT>), as the console sends it. Never paste it into a terminal: it opens every business the user belongs to.

Path Parameters

appId

string

required

One of your apps' ids. Another developer's app, or a malformed id, is 404 APP_NOT_FOUND.

Pattern: ^\d{1,20}$

Body

multipart/form-data

file

required

The image file (PNG, JPEG or WebP). At most 2097152 bytes.

kind

enum<string>

required

Available options:

icon,

screenshot_desktop,

screenshot_mobile

Response

The image, draft: name its id in your draft listing.

data

object

required

One listing image.

Show child attributes

Admin API

Developer API

Upload a listing image

Authorizations

Path Parameters

Body

Response