API

This site exposes a small read-only JSON API for AI agents, integrations, and search/indexing workflows.

Base URLs

• API index: https://elmekki.me/api/index.json
• OpenAPI description: https://elmekki.me/openapi/site-api.json
• API catalog: https://elmekki.me/.well-known/api-catalog

Endpoints

• GET /api/index.json: service metadata and endpoint inventory.
• GET /api/profile.json: profile, contact links, research areas, and discovery URLs.
• GET /api/publications.json: structured publication metadata.
• GET /api/posts.json: structured blog post metadata.
• GET /api/search.json: static search index across pages, publications, and posts.
• GET /api/health.json: health and readiness status.

Authentication

The current site API is public and read-only. No bearer token is required for the endpoints above.

To avoid publishing misleading metadata, this site does not currently advertise an OAuth authorization server. If protected agent access is introduced later, the site can add /.well-known/oauth-authorization-server or /.well-known/openid-configuration alongside token issuance and key discovery.

Agent Discovery

Agents can discover this site through:

• HTML link rel tags on page responses
• /.well-known/api-catalog
• /.well-known/oauth-protected-resource
• /.well-known/mcp/server-card.json
• /.well-known/agent-skills/index.json

Usage Notes

• Publication records link to anchored sections on /articles/.
• Blog post URLs are stable permalinks under /blog/.
• The search index is static JSON; consumers should download it and filter locally.