MCP · OPENAPI 3.1 · LLMS.TXT

AI ajanları için, doğuştan makine-okur.

ServiceBox APIs makine-okur önce tasarlandı: her API sabit adreste OpenAPI 3.1 speci yayınlar, tüm dokümanlar Markdown olarak da sunulur ve kataloğun tamamı tek MCP sunucusu olarak bağlanır.

MCPMCP sunucusu

Claude, ChatGPT ve ajan çatıları tek konfigürasyon satırıyla API'lerin tamamını yerel araç olarak çağırır. Her araç çağrısı, aynı REST çağrısıyla birebir aynı şekilde ölçülür.

JSON

{
  "mcpServers": {
    "servicebox-apis": {
      "url": "https://mcp.servicebox.io/mcp",
      "headers": { "Authorization": "Bearer sbx_live_…" }
    }
  }
}

LLMS.TXTllms.txt + Markdown

Gateway'in kökündeki llms.txt tüm API'lere işaret eder; her API'nin dokümanı /docs/<api>.md adresinde düz Markdown olarak da sunulur.

GET https://api.servicebox.io/llms.txt

llms.txt

# ServiceBox APIs

> Turkish data APIs behind one API key: REST over HTTPS with Bearer auth, pay-per-call credits, Markdown docs and an OpenAPI document for every API and programmatic signup for agents.

## APIs

- [Pharmacy on duty (SBX-ECZ)](https://api.servicebox.io/docs/pharmacy.md): OpenAPI: https://api.servicebox.io/v1/pharmacy/openapi.json

OAS 3.1OpenAPI 3.1 spesifikasyonları

Ajanlar endpoint ve parametreleri doğrudan spec üzerinden öğrenir — kazıma yok, tahmin yok.

GET https://api.servicebox.io/v1/pharmacy/openapi.json

AUTHAjan dostu kimlik doğrulama

✓Basit bearer anahtarı veya ?apikey= parametresi — OAuth dansı yok
✓Ajan, API üzerinden kapsamlı ve kısa ömürlü anahtar üretir: POST /v1/keys/ephemeral
✓429 ve 402 yanıtları limiti ve yükseltme yolunu makine-okur bildirir
✓CAPTCHA'sız programatik kayıt: POST /v1/accounts

POSTProgramatik kayıt

Ajan, bir e-posta adresi ve ihtiyaç duyduğu API'lerle hesap ister. E-posta sahibi tek tıkla onaylar; ajanın bir sonraki sorgusu bu API'lerle sınırlı, 7 gün geçerli bir anahtar döndürür.

cURL

# 1. Ask for an account — the mailbox owner approves it by email
curl -X POST https://api.servicebox.io/v1/accounts \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","apis":["pharmacy"],"agent_name":"my-agent"}'
# → 202 {"signup_id":"…","poll_token":"sbx_poll_…","poll_url":"…","retry_after":5}

# 2. Poll until approved → 200 {"api_key":"sbx_live_…","expires_at":"…"}
curl https://api.servicebox.io/v1/accounts/<signup_id> \
  -H "Authorization: Bearer sbx_poll_…"

# 3. Mint a short-lived key for a sub-agent → 201 {"api_key":"sbx_live_…"}
curl -X POST https://api.servicebox.io/v1/keys/ephemeral \
  -H "Authorization: Bearer sbx_live_…" \
  -H "Content-Type: application/json" \
  -d '{"ttl_seconds":3600,"apis":["pharmacy"]}'