---
title: REST API
description: Atlas by Friendlym REST API'si. Her MCP aracı /api/v1 altında bir POST uç noktası; OpenAPI 3.1 tanımı, JSON hatalar, hız sınırı başlıkları ve sürümleme politikası.
canonical: https://tilqui-atlas.pages.dev/docs/api/
lang: tr
last_updated: 2026-10-08
alternate_html: https://tilqui-atlas.pages.dev/docs/api/
---

# REST API

MCP sunucusundaki her araç aynı ad, girdi ve sonuçla bir REST uç noktasıdır da:

```sh
curl -s https://tilqui-atlas.pages.dev/api/v1/tools/list_projects \
  -H "authorization: Bearer $ATLAS_TOKEN" -H 'content-type: application/json' -d '{}'
```

- Temel adres: `https://tilqui-atlas.pages.dev/api/v1`
- Tanım: [OpenAPI 3.1](https://tilqui-atlas.pages.dev/openapi.json); [API kataloğunda](https://tilqui-atlas.pages.dev/.well-known/api-catalog) (RFC 9727) da listelenir
- Kimlik: OAuth 2.1 bearer belirteçleri (bkz. [kimlik doğrulama](https://tilqui-atlas.pages.dev/docs/auth/)) ya da bir eşleştirme belirteci
- Her işlemin bir `operationId` değeri, tipli istek ve yanıt şemaları ve ipuçları (salt okunur, eş güçlü) vardır

`GET /api/v1/me` bir belirtecin kimin adına çalıştığını ve hangi kapsamlara sahip olduğunu söyler.

## Sonuçlar ve hatalar

Bir araç `200` ile `{"ok": true, "data": …}` döner. Hatalar, sabit bir kod ve ne yapılacağını söyleyen bir cümle içeren JSON'dur:

```json
{ "ok": false, "error": { "code": "scope_missing", "message": "This token has no ask scope. …" } }
```

| Durum | Kod | Ne yapmalı |
|---|---|---|
| 400 | `invalid_input` | Girdiyi düzeltin; mesaj alanı söyler |
| 401 | `unauthorized` | Yeniden giriş yapın; `WWW-Authenticate` üst veriyi gösterir |
| 403 | `scope_missing` | Kişiden kapsamı onaylamasını isteyin |
| 404 | `not_found` | Araç adını ya da kimliği kontrol edin |
| 429 | `rate_limited` | `Retry-After` saniye bekleyin |
| 503 | `unavailable` | Biraz sonra yeniden deneyin |

## Hız sınırları

Her ajanın MCP ve REST arasında paylaşılan saatlik bir araç çağrısı bütçesi vardır (varsayılan 300) ve `ask_atlas` için günlük bir sınır vardır. Yanıtlar IETF hız sınırı alanlarını taşır:

```text
RateLimit-Policy: "hour";q=300;w=3600
RateLimit: "hour";r=297;t=3600
```

Bir `429`, `Retry-After` taşır.

## Sürümleme ve kullanımdan kaldırma

Yol ana sürümü taşır: `/api/v1`. Ekleme niteliğindeki değişiklikler (yeni bir araç, yeni isteğe bağlı bir alan, yeni bir sonuç alanı) sürümü korur. Uyumu bozan bir değişiklik `/api/v2` olur ve `/api/v1` en az 90 gün `Deprecation` ve `Sunset` başlıklarıyla ve bu sayfada bir notla çalışmaya devam eder. MCP araçları da aynı kurala uyar.