// Developer Portal · REST v1

The API

Build on the constitutional standard.

Integrate DragonSource content, governance frameworks, and identity verification into your platform. RESTful endpoints with CORS support and rate limiting.

six endpoints · one standard

The Chapters

// The Key

Authentication

Every authenticated call carries your key in the X-API-Key header. Public endpoints — the RSS feed and badge verification — require no key, at reduced rate limits.

X-API-Key: ds_your_key_here

Keys are issued at registration and shown once — store them securely.

// Quickstart

Three Calls to First Light

Register

Self-service registration returns your API key in the response.

curl -X POST -H "Content-Type: application/json" \
  -d '{"name":"Acme AI","contact_email":"dev@acme.ai","tier":"technology"}' \
  "https://dragonsource.org/api/v1/partners/register"

Authenticate

Pass the key on every call via the X-API-Key header. Store it securely.

curl -H "X-API-Key: ds_your_key_here" \
  "https://dragonsource.org/api/v1/content"

Build

Pull frameworks, subscribe to webhooks, verify trust badges — the full surface is below.

curl -H "X-API-Key: ds_your_key_here" \
  "https://dragonsource.org/api/v1/content?category=framework&limit=10"

// The Endpoints

The Reference

Endpoints

GET/api/v1/content

List Content

Retrieve published guides, frameworks, and publications with pagination and filtering.

Parameters

categorystringFilter by category: guide, framework, publication, announcement

tagstringFilter by tag

searchstringFull-text search across titles and summaries

pageintegerPage number (default: 1)

limitintegerItems per page (default: 20, max: 100)

sortstringSort field: published_at, view_count, title

orderstringSort order: asc, desc

Example Request

curl -H "X-API-Key: ds_your_key_here" \
  "https://dragonsource.org/api/v1/content?category=framework&limit=10"

Example Response

{
  "data": [
    {
      "id": "...",
      "title": "Trinity Protocol v2",
      "slug": "trinity-protocol-v2",
      "category": "framework",
      "tags": ["governance", "ai-safety"],
      "summary": "...",
      "author": "DragonSource",
      "published_at": "2024-01-15T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 10,
    "total": 42,
    "totalPages": 5
  }
}

// The Law

Rate Limits

120

req/min

Authenticated — keyed partners at full rate.

req/min

Unauthenticated — public endpoints (RSS, badge verification).

100%

of responses

Rate-limit headers included on every call — no guessing.

// The Gate