Register new profile

Overview

The profile registration API uses an asynchronous pattern. When you register a new profile, you receive an identifier to track the request status rather than an immediate success or failure response.

Registration Process

Register Profile
Endpoint: POST /profile/register-profile
Submit a username and password to initiate profile registration.

The API performs basic validation immediately. If validation fails, you'll receive an error response. However, business logic validation occurs asynchronously after the initial response.

Check Registration Status
Endpoint: GET /request-status/{identifier}
Use the identifier from the registration response to check the processing status.

Implementation Flow

Client calls register endpoint

Client receives identifier

Client polls status endpoint using identifier

Client checks status

Best Practices

Poll the status endpoint at reasonable intervals (e.g., every 2-3 seconds)

Implement a timeout mechanism for status checks

Handle all possible status values in your client code

Store the identifier immediately after registration for status tracking

Check command status

[
   "profile.profile_registered"
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢202Success

application/json

Command accepted.
Use utility endpoint /request-status/{commandId} to retrieve command id status.
Upon obtaining authorization token in next request (/profile/authenticate), subscribe to your profile channel on DPT CAB websocket server via profile authorization token and receive command status messages more conveniently in real time.

Headers

Body

Example

[
    "string"
]

🟠422422

Register new profile

Overview#

Registration Process#

Implementation Flow#

Best Practices#

Check command status#