Developer Documentation & API

Tools, APIs, and integration guides for building and connecting AI-native websites.

Quick Start

Get started with the current Digital Karma Constellation v7.1 profile in 5 minutes.

Create manifest.json
{ "name": "Your Site Name", "description": "Site description", "url": "https://yoursite.com", "federation_version": "7.1", "updated_utc": "2026-04-22T00:00:00Z", "contact": { "email": "admin@yoursite.com" }, "endpoints": { "manifest": "/ai/manifest.json", "health": "/ai/health.json", "catalog": "/ai/catalog.json", "karma": "/ai/karma.json", "federation": "/ai/federation.json", "llm_txt": "/llm.txt", "sitemap": "/sitemap.xml" }, "related_sites": ["https://www.aiwebsitesystems.com"] }
Publish the remaining required files
/ai/health.json /ai/catalog.json /ai/karma.json /ai/federation.json /llm.txt /robots.txt /sitemap.xml
Add Schema.org markup
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebSite", "name": "Your Site Name", "url": "https://yoursite.com" } </script>
Validate your implementation
$ curl https://yoursite.com/ai/manifest.json $ curl https://yoursite.com/robots.txt $ curl https://yoursite.com/sitemap.xml $ jq . ./ai/manifest.json
Submit to the constellation
Fill out the submission form when you want optional registry review.

Public API Endpoints

Machine-readable data endpoints for AI agents and developers.

GET /ai/manifest.json

Site Identity and Discovery - Returns site metadata, available endpoints, and constellation information.

curl https://www.digitalkarmaweb.com/ai/manifest.json

GET /ai/health.json

System Health Status - Real-time health metrics and operational status.

curl https://www.digitalkarmaweb.com/ai/health.json

GET /ai/catalog.json

Content Catalog - Complete inventory of site content and resources.

curl https://www.digitalkarmaweb.com/ai/catalog.json

GET /ai/karma.json

Digital Karma Score - Trust and quality scoring with signal breakdown.

curl https://www.digitalkarmaweb.com/ai/karma.json

GET /ai/federation.json

Constellation Topology - Complete map of constellation sites and alignments (federated architecture).

curl https://www.digitalkarmaweb.com/ai/federation.json

GET /llm.txt

LLM-Optimized Summary - Plain text site overview optimized for language models.

curl https://www.digitalkarmaweb.com/llm.txt

GET /robots.txt

Root Discovery Rules - Crawler directives plus the canonical root sitemap reference.

curl https://www.digitalkarmaweb.com/robots.txt

GET /sitemap.xml

Canonical Crawl Sitemap - The primary XML sitemap for crawlers and discovery tooling.

curl https://www.digitalkarmaweb.com/sitemap.xml

Developer Tools

Constellation Validator

Fetch each required artifact directly and confirm the JSON parses cleanly where applicable.

$ jq . ./ai/manifest.json

Karma Score Calculator

Populate /ai/karma.json using the published weights in /specs/scoring-spec.md.

$ jq . ./ai/karma.json

Schema Validator

Validate your Schema.org JSON-LD with validator.schema.org.

https://validator.schema.org/

Link Checker

Check that every declared endpoint, dataset, and related site URL resolves correctly.

$ curl -I https://yoursite.com/llm.txt

Constellation Audit

Need a fast before-and-after proof point?

Run the constellation audit against any public host to get a current version check, priority fixes, and downloadable upgrade artifacts you can hand to a developer or agent.

Public URLs only. Instant results. Exportable upgrade package.

Launch the Audit Review the Standards

Integration Examples

Python: Fetch Constellation Data

import requests

response = requests.get('https://www.digitalkarmaweb.com/ai/manifest.json')
manifest = response.json()
print(f"Site: {manifest['name']}")
print(f"Version: {manifest['federation_version']}")

JavaScript: Validate Karma Score

async function checkKarmaScore(siteUrl) {
  const response = await fetch(`${siteUrl}/ai/karma.json`);
  const karma = await response.json();
  console.log(`Karma Score: ${karma.digital_karma_score}`);
  return karma.digital_karma_score >= 0.70;
}

Bash: Automated Health Check

#!/bin/bash
health=$(curl -s "https://www.digitalkarmaweb.com/ai/health.json")
status=$(echo $health | jq -r '.status')
if [ "$status" = "ok" ]; then echo "Site is healthy"; fi

CORS & Cross-Origin Access

All API endpoints support CORS and can be accessed from any origin:

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, OPTIONS
Access-Control-Allow-Headers: Content-Type

Need Help?

Have questions about integration or need technical support?

Browse Knowledge Base Contact Support