// Developer Portal

API Documentation

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

Authentication

Pass your API key via the X-API-Key header. Public endpoints (RSS, badge verification) don't require authentication but have lower rate limits.

Authenticated: 120 req/min | Unauthenticated: 30 req/min | Rate limit headers included in all responses

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