A Pseudonymous Key generated by an IDA and OperatorID Yes String associated with the Operator to be resumed. Content of the response body JSON object in the case of an error: Key Type Description Required An OPTIONAL description of why the request Reason String No failed. Example Example request message: POST service-provider/resumeOperator {"OperatorID": "00000000-0000-0000-0000-000000000000"} Example response message: HTTP/1.1 200 OK Service Provider: Register Devices All Devices associated with a Service Provider are registered in advance of assigned to a Consumer. Register Devices associates one or more Devices with Service Provider, assigns each a device type (Personal or IoT), and validates the Pseudonymous Key of the Device. A Device SHALL be registered only once. Only Operators associated with the registering Service Provider MAY assign the Device to a Consumer. If successful, an HTTP status code of 200 OK MUST be returned. If unsuccessful, an HTTP error code SHOULD be returned and a JSON object MAY be returned providing some explanation of the failure. If validation of the DeviceIDs fails, with a 410 (Gone) error from the IDA, an error 410 (Gone) SHOULD be returned. If any of the DeviceIDs is already in use for another Service Provider, Operator, Consumer or Device, an error 410 (Gone) SHOULD be returned. Method Request Response Status Response Response Body Body Content-Type POST JSON 200 (OK) None None <ManagementURI>/ Object Error code application/json JSON Object Content of the request body JSON object: Key Type Description Required An array of Pseudonymous Keys associated Array of DeviceIDs Yes with the Devices and generated by an IDA. String Time stamp, in DateTime format, indicating TimeStamp when the IDA created these Pseudonymous Yes String Keys.
OperatorID String A Pseudonymous Key generated by an IDA and associated with the Operator to be resumed. Yes Content of the response body JSON object in the case of an error: Key Type Description Required Reason String An OPTIONAL description of why the request failed. No Example Example request message: POST service-provider/resumeOperator {"OperatorID": "00000000-0000-0000-0000-000000000000"} Example response message: HTTP/1.1 200 OK Service Provider: Register Devices All Devices associated with a Service Provider are registered in advance of assigned to a Consumer. Register Devices associates one or more Devices with Service Provider, assigns each a device type (Personal or IoT), and validates the Pseudonymous Key of the Device. A Device SHALL be registered only once. Only Operators associated with the registering Service Provider MAY assign the Device to a Consumer. If successful, an HTTP status code of 200 OK MUST be returned. If unsuccessful, an HTTP error code SHOULD be returned and a JSON object MAY be returned providing some explanation of the failure. If validation of the DeviceIDs fails, with a 410 (Gone) error from the IDA, an error 410 (Gone) SHOULD be returned. If any of the DeviceIDs is already in use for another Service Provider, Operator, Consumer or Device, an error 410 (Gone) SHOULD be returned. Method Request Body Response Status Response Content-Type Response Body POST <ManagementURI>/ JSON Object 200 (OK) None None Error code application/json JSON Object Content of the request body JSON object: Key Type Description Required DeviceIDs Array of String An array of Pseudonymous Keys associated with the Devices and generated by an IDA. Yes TimeStamp String Time stamp, in DateTime format, indicating when the IDA created these Pseudonymous Keys. Yes
COEL-v1.0-csprd02.docx