Skip to content

API Documentation

Base URL

  • Production: https://license.api.datagram.network
  • Staging: https://license-staging.api.datagram.network

General Information

  • All endpoints are versioned under /api/v1.
  • Requests and responses use JSON format unless otherwise specified.

Endpoints

1. Node register

POST /api/v1/node/register

This endpoint is used to register an external ID to the whitelist.

Request Body:

  • id (string): Identifier of the partner node (external ID).
  • secret (string): Unique identifier of partner.

Response:

  • Response Code:
    • 200 OK: Successfully registered.
    • 400 Bad request: Invalid parameters.
    • 401 Unauthorized: Invalid token.

Authentication:

  • Use a valid organization token in the Authorization header.
  • Example: Authorization: <token>.

Example Request:

http
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"
}

Example Response:

json
{
  "data": true
}