Requesting Updates and Manifests

Instructions for requesting updates and manifests are described in the following sections:

• Requesting Updates
• Polling for Updates
• Requesting the Manifest
• Polling for Manifest

Requesting Updates

To request the updates

Make a POST call to https://siteID-ns-uat.flexnetoperations.com/uai/2.0/updates.

Body Type

Code

Request Body

{

    "updateFromPkgId":"PhotoPrintInstaller",

    "language":1033,

    "platform":"WIN64",

    "id":"PhotoPrintInstaller-V12",

    "idType":"STRING",

    "publisherName":"ABCNetworks"

}

Note:For devices that are assigned to an account, it is recommended to populate the fields id, idType, and publisherName. For anonymous devices, these fields should be left blank.

Response Body

{

    "url": "/uai/2.0/updates/67089b0f-4b8a-4e53-a970-2cb92217459e"

}

Polling for Updates

Poll for the updates using the provided polling URL. If a 202 response code is received, repeat the polling until a 200 response is received.

To poll for the updates

Make a GET call to https://siteID-ns-uat.flexnetoperations.com/uai/2.0/updates/67089b0f-4b8a-4e53-a970-2cb92217459e.

Body Type

Code

Request Body

N/A

Response Body

{

    "updateItems": [

        {

            "commandLine": "",

            "description": "Update PhotoPrint from version 12 to version 12.1",

            "expireDate": "05/01/2025",

            "fromPackageId": "PhotoPrintInstaller-V12",

            "updateId": "PhotoPrint-Update-V12.1",

            "languageCode": 1033,

            "updateName": "PhotoPrint-Update",

            "productName": "",

            "startDate": "05/01/2018",

            "title": "Update for PhotoPrint",

            "toPackageId": "PhotoPrint-Update-V12.1",

            "manifestURL": "/uai/2.0/updates/manifests/c4c8c5d6-3574-42ae-9cd9-d6aa737a1dbe"

        }

    ],

    "error": {

        "key": "",

        "message": "",

        "arguments": ""

    }

}

Requesting the Manifest

Request the manifest using the manifest UUID in the response received in Polling for Updates.

To request the manifest

Make a POST call to https://siteID-ns-uat.flexnetoperations.com/uai/2.0/updates/manifests.

Body Type

Code

Request Body

{

    "uuid": "c4c8c5d6-3574-42ae-9cd9-d6aa737a1dbe"

}

Response Body

{

    "url": "/uai/2.0/updates/manifests/16489f0c-3b34-abfa-b342-3fe2459023e1"

}

Polling for Manifest

Poll for the manifest using the provided polling URL. If a 202 response code is received, repeat the polling until a 200 response is received.

To poll for the manifest

Make a GET call to https://siteID-ns-uat.flexnetoperations.com/uai/2.0/updates/manifests/16489f0c-3b34-abfa-b342-3fe2459023e1.

Body Type

Code

Request Body

N/A

Response Body

{

    "manifestVersion": "1.0",

    "manifestFiles": [

        {

            "fileUrl": "https://example.com/filename.txt",

            "fileSize": "2781",

            "md5Hash": "624fd6479cbc870e2ed53db729827954",

            "sha256Hash":"cfffe67239921fbde19f4d1994bafb49016e7bd257f8ef81fe63501b81872346",

            "execute": "no"

        }

    ]

}

This step completes the registration.