Jump to

• Request
• Response

v1.0

put

/ec-ors-svc/rest/v1.0/studies/{studyId}/{mode}/subjects/{subjectId}/devices/{inventoryId}/access-code

Recreates the access ID and OTP (one-time password) for a bootstrap device. Required if the password (OTP) has already expired. The device cannot be bootstrapped using expired or invalid credentials. Rights: DeviceActionsPost.

Request

Path Parameters

• inventoryId(required): string
  ID of the inventory.

  Example:

  B1B8327AFAA6412287106192AB5984EF

• mode(required): string
  Indicates the operational mode of the study. Accepted values: active, test, or training.

  Example:

  test

• studyId(required): string(uuid)
  Unique identifier of the study. Uses UUID in a 32-character uppercase hexadecimal string format.

  Example:

  1BC29B36F5D64B1B95F4BDBBCEA481BE

• subjectId(required): string
  Unique identifier of the subject. Used to represent a participant enrolled in a study. Uses UUID in a 32-character uppercase hexadecimal string format.

  Example:

  0A1B2C3D4E5F67890123456789ABCDEF

Query Parameters

• mSubjectId(required): string
  ID of the subject in mHealth.

  Example:

  MSUBJECT-001

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : BootStrapCredResponseDto

Type: object

Contains details about bootstrap device.

Show Source

• accessId: string
  Client access code generated for a bootstrap device.

  Example: ABC123
• id: string
  Device instance identifier.

  Example: B1B8327AFAA6412287106192AB5984EF
• otp: string
  Time-sensitive, one-time authorization code generated by the mHealth Connector Cloud application to bootstrap a device.

  Example: ABCD1234

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Device instance identifier.",
            "example":"B1B8327AFAA6412287106192AB5984EF"
        },
        "accessId":{
            "type":"string",
            "description":"Client access code generated for a bootstrap device.",
            "example":"ABC123"
        },
        "otp":{
            "type":"string",
            "description":"Time-sensitive, one-time authorization code generated by the mHealth Connector Cloud application to bootstrap a device.",
            "example":"ABCD1234"
        }
    },
    "description":"Contains details about bootstrap device."
}

Examples

Select an example Refresh access code response

400 Response

Invalid subject ID OR Device is not dispensed to the subject OR Device is dispensed to a different subject OR Invalid device ID OR mHealth device is not registered OR Device does not have any connection type OR Vendor code is missing for cloud-to-cloud connection type devices OR Device has a no-connection connection type.

Body ()

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

• errorData: object ErrorResponseData
• result: object result
  Result Object
• status: string
  Status of request

  Example: Success
• version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Show Source

• details: object details
• errorCode: string
• errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : result

Type: object

Result Object

Nested Schema : details

Type: object

Examples

Select an example Bad request

404 Response

Invalid study ID or version

Body ()

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

• errorData: object ErrorResponseData
• result: object result
  Result Object
• status: string
  Status of request

  Example: Success
• version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Show Source

• details: object details
• errorCode: string
• errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : result

Type: object

Result Object

Nested Schema : details

Type: object

Examples

Select an example Not found

500 Response

Internal server error OR mHealth settings are not found.

Body ()

Root Schema : ORSResponse

Type: object

Common response object.

Show Source

• errorData: object ErrorResponseData
• result: object result
  Result Object
• status: string
  Status of request

  Example: Success
• version: integer (int32)

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of request",
            "example":"Success"
        },
        "result":{
            "type":"object",
            "description":"Result Object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        },
        "version":{
            "type":"integer",
            "format":"int32"
        }
    },
    "description":"Common response object."
}

Nested Schema : ErrorResponseData

Type: object

Show Source

• details: object details
• errorCode: string
• errorMessage: string

{
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string"
        },
        "errorMessage":{
            "type":"string"
        },
        "details":{
            "type":"object"
        }
    }
}

Nested Schema : result

Type: object

Result Object

Nested Schema : details

Type: object

Examples

Select an example Server error

Back to Top