Ariya Sarrafzadeh Monogram
ARIYA SARRAFZADEH
فا
Home/Developer Portal & Agent APIs
DEVELOPER DOCUMENTATION & AGENT PROTOCOLS

API Reference & Agent Documentation

This platform exposes fully documented, machine-readable interfaces for autonomous agents, LLM tool runners, and technical evaluators. Every endpoint follows OpenAPI 3.1, RFC 7807 problem details, and standard HTTP rate-limiting headers.

Spec Version: OpenAPI 3.1.0
Base URL: https://ariya-sarrafzadeh.xyz
Rate Limit: 60 req/min (RFC 6585)
Error Standard: RFC 7807 Problem Details

01.Agent Discovery Manifests

Standard Specifications
application/json/openapi.json

OpenAPI 3.1 Specification (JSON)

Canonical machine-readable API definition with 8 operations and complete schemas.

Inspect Raw File→
application/yaml/openapi.yaml

OpenAPI 3.1 Specification (YAML)

YAML mirror of the OpenAPI schema for Swagger UI and CLI tooling.

Inspect Raw File→
application/json/api/tools.json

Agent Tools Manifest (Function Calling)

OpenAI / Anthropic tool-calling schema definitions ready for LLM function execution.

Inspect Raw File→
text/plain/llms.txt

Agent Context (llms.txt)

Standard llmstxt.org brief agent summary and authoritative link directory.

Inspect Raw File→
text/plain/llms-full.txt

Deep System Context (llms-full.txt)

Complete architectural blueprints, throughput figures, and system limits for LLMs.

Inspect Raw File→
text/markdown/index.md

Homepage Markdown Feed

Direct markdown alternative to the HTML homepage for text-only agent ingestion.

Inspect Raw File→
application/json/.well-known/agent.json

Agent-to-Agent Manifest

A2A discovery manifest declaring autonomous agent protocols and capabilities.

Inspect Raw File→

02.REST Endpoints & Mock Services

Static Deterministic JSON
GET/api/v1/health.json

Liveness, readiness, uptime, and edge node health telemetry.

None (Public)Execute
GET/api/v1/profile.json

Principal architect biography, core competencies, verified contact channels.

None (Public)Execute
GET/api/v1/dictionary.json

Curated 70+ fintech & telecom infrastructure terms with Iranian regulatory mappings.

None (Public)Execute
GET/api/v1/dossiers.json

Production incident post-mortems, root-cause analyses, and mitigation patterns.

None (Public)Execute
GET/api/v1/specs.json

Authoritative engineering specifications for payment switches, ledgers, and eKYC.

None (Public)Execute
GET/api/v1/error.json

Standard RFC 7807 Problem Details error response template.

None (Public)Execute
03. INTEGRATION EXAMPLE

LLM Tool Calling Usage (cURL / Python)

To load these capabilities into an autonomous agent framework (LangChain, AutoGen, LlamaIndex, Claude tool use), point your schema parser to /api/tools.json:

# 1. Fetch tool declarations
curl -s https://ariya-sarrafzadeh.xyz/api/tools.json
# 2. Query fintech term directly
curl -s https://ariya-sarrafzadeh.xyz/api/v1/dictionary.json | jq '.[] | select(.id == "idempotency")'
# 3. Content negotiation via HTTP Accept header
curl -s -H "Accept: text/markdown" https://ariya-sarrafzadeh.xyz/