Link relation taxonomies:entry-by-entryid-bulk

Overview

A bulk call that gets a set of entries given.

HTTP method

POST

URL template parameters

-

Query parameters

embed

A comma-separated list of sub resources to embed. Possible values:

Request body

A JSON string array with the ids of the requested entries:

[
  "id1",
  "id2",
  "id3"
]

HTTP response

200 OK

Response body

-

An array with one entry for each requested id. For each successfully requested entry:

For each requested entry that caused an error:

  • success: false

  • httpStatus: same response code as for the taxonomies:entry-by-entryid link rel. Typical example: 404.

  • errorCode (string, optional): machine-readable error code that the non-bulk call would return for this item

  • errorMessage (optional, string): human-readable error message that the non-bulk call would return for this item

Example response if "id1" is valid, "id2" doesn’t exist, and "id3" is valid again:

[
  {
    "success": true,
    "data": {
       ... same as for taxonomies:entry-by-entryid for "id1"
    }
  },
  {
    "success": false,
    "httpStatus": 404,
    "errorCode": "avid.mam.assets.access/NOT_FOUND",
    "errorMessage": "entry id2 not found in AVID_RIGHTS_INDICATORS"
  },
  {
    "success": true,
    "data": {
      ... same as for taxonomies:entry-by-entryid for "id3"
    }
  }
]

Available in

Description

A bulk call that gets a set of entries given.