REST Resources


The following operation is supported on this resource:

  • POST - Acknowledge Device Fingerprint Rest API
POST /acknowledge-device-fingerprintVersion 2

This API will perform the following operations:

  1. Acknowledge the specified fingerprint value - Blindly accepted the fingerprint from the device on first connection or reconnection.
  2. Resolve the fingerprint conflict - Mismatch between fingerprint stored in database and in device.
This API is only supported for device with authentication status of:
  • Credentials Based – Unverified
  • Key Based – Unverified
  • Key Conflict – Unverified
  • Fingerprint Conflict
    • .

      Sample Usage

      This API makes an asynchronous method call; so, you can optionally specify queue and schedule parameters:

      POST /acknowledge-device-fingerprint?queue=<queue>&schedule=<schedule>

      Note: The queue URL denoted by <queue> must have been created already.

      • Parameters:
        NameTypeURI TypeDescriptionRequired
        queueQueue URLQueryA fully qualified queue URL, where job progress notifications will be sent (See Asynchronous API Usage)N
        schedulecron-like-expressionQuerySchedule this API in the future, by specifying a cron-like-expression (See Job Scheduling)N
    • Sample Input XML:
                     <device href="/api/space/device-management/devices/2228241"/>

    • Sample Output XML:
      <task href="/api/space/job-management/jobs/1081350">

    • Sample Input JSON:
         "acknowledge-device-fingerprint-request" : {
           "acknowledge-devices" : [
               "acknowledge-device" : {
                 "device" : {
                   "@href" : "/api/space/device-management/devices/2228241"
                 } ,
                 "fingerprint" : "15:88:53:a6:b1:97:85:68:4c:11:9d:b8:2a:8a:0f:b7"

    • Sample Output JSON:

    • Access Control

      The following capabilities are required to access this API: AcknowledgeDeviceFingerprint