General
🔗 Base URLs
You can use the following environments depending on your development stage:
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:
Production Dashboard: https://dashboard.datagram.network/sdk
Staging Dashboard: https://staging.datagram.network/sdk
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 Requests
error. 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