Blackboard Logo

Retrieve the feedback for multiple files

The batch endpoint allows you to retrieve content for more than one content hash

Endpoint

GET /api/v2/clients/:clientId/content/batch

Path Parameters

Body Parameters

The request body is a JSON encoded request of the form:

{
  "references": [
    { "hash": "a1b2c3d..." },
    { "hash": "QWxseSs..." },
    { "hash": "e1f2123..." }
  ]
}

Query Parameters

Expected response

The values in the JSON array will follow the same order as in the submitted request. If no information could be retrieved for a content reference, the null value will be returned.

formats=true

{
  "reports": [
    null,
    {
      "hash": "QWxseSs...",
      "feedback": null,
      "formats": {
        "availableFormats": ["Beeline", "Tts", "Epub", "Braille", "Html"],
        "canToggleAvailability": false,
        "available": true,
        "visibility": true
      },
      "metadata": {
        "name": "Ally+-+One+Pager+-+Higher+Ed+-+General.pdf",
        "decorative": null,
        "description": null,
        "fileType": "pdf",
        "mimeType": "application/pdf",
        "isVersioned": false,
        "isSeizureInducing": false,
        "libraryReference": null
      }
    },
    null
  ]
}

Testing with cURL

curl \
  -H "Authorization: Bearer myJwtToken" \
  -H "Content-Type: application/json" \
  -d '{"references": [{"hash": "a1b2c3d..."},{"hash": "QWxseSs..."},{"hash": "e1f2123..."}]}' \
  https://prod.ally.ac/api/v2/clients/:clientId/content/bash