İçeriğe geç
Alp Yalay
API v1.0.0
Agent Ready

Alp Yalay Geliştirici Portalı & API

AI ajanları, LLM'ler ve geliştiriciler için kamuya açık REST API, Model Context Protocol (MCP) sunucusu ve araç dokümantasyonu.

OpenAPI 3.0.3 Spec
/openapi.json
LLMs.txt Context
/llms.txt & /llms-full.txt
Agent Skills Catalog
/.well-known/agent-skills

Hızlı Başlangıç

Tüm REST uç noktaları genel kullanıma açıktır ve API anahtarı gerektirmez.

1. Fetch Alp Yalay Profile
curl -s https://alpyalay.org/api/v1/profile | jq
2. List Portfolio Projects
curl -s 'https://alpyalay.org/api/v1/projects?lane=builder' | jq
3. Interactive Terminal CLI
npx alp-yalay

REST API v1 Uç Noktaları

GET
/api/v1/profile

Alp Yalay'ın biyografisini, uzmanlık alanlarını, sosyal bağlantılarını ve iletişim kanallarını döner.

curl https://alpyalay.org/api/v1/profile
GET
/api/v1/projects

Tüm portföy projelerini ve vaka çalışmalarını listeler. Parametreler: `lane` (builder | client | localization | ai-tools), `tier` (featured | supporting | archive), `q` (arama).

curl 'https://alpyalay.org/api/v1/projects?tier=featured'
GET
/api/v1/projects/:slug

Belirli bir projenin veya vaka çalışmasının detaylı bilgilerini döner. Örn: `realdex`, `battle-talent`, `heroes-of-hammerwatch-2`.

curl https://alpyalay.org/api/v1/projects/realdex
GET
/api/v1/skills

Tüm teknik becerileri, dilleri, sertifikaları ve temel uzmanlık alanlarını döner.

curl https://alpyalay.org/api/v1/skills
GET
/api/v1/health

API sistem durumu, servis sürümü ve sunucu zaman damgasını döner.

curl https://alpyalay.org/api/v1/health

Model Context Protocol (MCP) Server

Claude, Cursor, Antigravity ve diğer AI ajanları ile doğrudan entegrasyon için JSON-RPC 2.0 uyumlu MCP sunucusu.

POST /api/mcp
JSON-RPC 2.0

Supported methods: initialize, tools/list, tools/call, ping.

Example Tool Call: get_case_study
curl -X POST https://alpyalay.org/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_case_study",
      "arguments": { "slug": "realdex" }
    }
  }'

Rate Limits & Headers

The API is currently unthrottled — endpoints serve static data and are safe to poll. Every response still carries standard headers:

  • Api-Version: 1.0.0
  • Access-Control-Allow-Origin: *
  • Cache-Control: public, max-age=3600

RFC 9457 Problem Details

Errors are returned with application/problem+json and structured machine-readable codes (`INVALID_SLUG`, `PROJECT_NOT_FOUND`).

Versioning follows URL pathing (`/v1/`). Deprecations are signaled via RFC Sunset headers with a 180-day grace period.