Register Node ID

Request

This endpoint registers an external ID to the Node ID whitelist. It supports requests using the following identifiers: secret and id.

Endpoint:

GET /api/v1/node/register

URL:

https://license.api.datagram.network

Request Parameters

Parameter	Type	Required	Description	Example
secret	string	✅ Yes	Unique secret token identifying partner.	"pt_sec_abc123XYZ*"
id	string	✅ Yes	Unique identifier of the external partner node.	"partner_98765zyxw"

You must provide both secret and id identifiers.

Authentication

Use a valid organization token in the request header.

Authorization: Bearer <organization-token>

Example Request

POST /api/v1/node/register HTTP/1.1
Host: license.api.datagram.network
Authorization: <organization-token>
Content-Type: application/json

{
  "id": "external_id",
  "secret": "partner_secret_key"
}

Responses

200

When the request is valid and successful, the API returns the boolean (true or false).

Example Response

{
  "data": true
}

400

Returned when required parameters are missing or invalid or the time range exceeds 7 days.

Response Body

Field	Type	Description	Example
message	string	Description of the issue.	INVALID_PARAMETERS
status	integer	HTTP status code.	400

Example Response

{
  "error": {
    "message": "INVALID_PARAMETERS",
    "status": 400
  }
}

401

Returned when the authorization token is missing or invalid.

Response Body

Field	Types	Description	Example
message	string	Explanation of the auth failure.	"UNAUTHORIZED"
status	integer	HTTP status code.	401

Example Response

{
  "error": {
    "message": "UNAUTHORIZED",
    "status": 401
  }
}