General

🔗 Base URLs

You can use the following environments depending on your development stage:

Environment
Base URL

Production

https://link.api.datagram.network

Staging

https://link-staging.api.datagram.network

Use the appropriate base URL depending on whether you're integrating into a live environment or testing.

🧩 API Structure

All endpoints follow a consistent versioned path:

  • /api/v1/ — Public endpoints

  • /organization/api/v1/ — Private organization-level endpoints (require authentication)

All requests and responses use the JSON format unless otherwise specified.

🔐 Authentication

All /organization/api/v1/ Endpoints require a valid Organization Token in the request headers.

Where to get it:

Header Format:

makefileCopyEditAuthorization: <token>

Make sure the token is valid and associated with your organization. If the token has expired, you’ll receive an 401 Unauthorized error.

🚦 Rate Limits

To ensure fair usage and optimal performance, the Datagram API enforces rate limiting.

  • Current rate limit:60 requests per second

  • If the limit is exceeded, you may receive an 429 Too Many Requestserror. We recommend implementing retries with exponential backoff.

✅ Response Format

All successful responses will return a 200 OK or appropriate success status (e.g., 201 Created), along with a data object.

Error responses are returned with standard HTTP status codes (400, 401, 404, etc.) and contain a descriptive message.

Example:

{
  "error": {
    "message": "Unauthorized"
  }
}

Last updated