← Return to Portfolio / API & Agent Discovery Catalog
[ MACHINE-READABLE DISCOVERY // RFC STANDARDS ]

API Catalog & Agent Registration

Autonomous AI agents, automated security scanners, and programmatic scrapers can discover, inspect, and query Ali Naim's technical portfolio, vulnerability disclosures, and certifications using open web standards.

RFC 9727 // LINKSET JSON

API Catalog

Standardized catalog describing all available service endpoints, documentation, OpenAPI schemas, and health status probes.

/.well-known/api-catalog
View Linkset JSON →
RFC 8288 & RFC 9727 §3

Link Response Headers

HTTP Link headers sent with root responses advertise machine-readable resources: api-catalog, service-desc, service-doc, and describedby.

curl -I https://alinaim.dev/
✓ Active on Homepage
AUTH.MD SPECIFICATION

Agent Registration (Auth.md)

Full authentication guide for AI agents. Documents the anonymous access model, scopes, and automated registration endpoints.

/auth.md
Read Auth.md →
OPENAPI 3.0.3 // SCHEMA

OpenAPI Specification

Complete machine-readable OpenAPI 3.0.3 specification available in both JSON and YAML formats.

OpenAPI JSON OpenAPI YAML
RFC 9728 // PRM

Protected Resource Metadata

Standardized JSON document advertising resource boundaries, trusted authorization servers, and bearer methods.

/.well-known/oauth-protected-resource
View PRM JSON →
CLOUDFLARE STANDARD

Markdown for Agents

Full content negotiation via Accept: text/markdown or explicit path /index.md for low-latency LLM context ingestion.

/index.md
View Markdown Dossier →
DRAFT-MOZLEYWILLIAMS-DNSOP-DNSAID-02

DNS for AI Discovery (DNS-AID)

Decentralized agent discovery over DNS via RFC 9460 SVCB/HTTPS service bindings under the _agents.alinaim.dev namespace.

/dns-aid
View DNS-AID Specs →

Developer & Agent Quick Start

# 1. Inspect RFC 8288 Link Headers:
curl -I https://alinaim.dev/
# 2. Fetch RFC 9727 API Catalog Linkset:
curl -H "Accept: application/linkset+json" https://alinaim.dev/.well-known/api-catalog
# 3. Read Full Markdown Dossier for LLMs:
curl -H "Accept: text/markdown" https://alinaim.dev/
# 4. Fetch Structured Portfolio JSON:
curl -H "Accept: application/json" https://alinaim.dev/api/data