---
title: "API Genel Bakış"
description: "Mind ve bilgi yönetimine programatik erişim için Minds API'sine giriş."
---

# API Genel Bakış

Minds API dokümantasyonuna hoş geldiniz. API'miz, AI mind'ları programatik olarak oluşturup yönetmenizi, bilgi yüklemenizi ve onlarla etkileşim kurmanızı sağlar.

## Başlarken

Minds API, REST prensipleri etrafında düzenlenmiştir. API'miz öngörülebilir kaynak odaklı URL'lere sahiptir, JSON kodlanmış istek body'leri kabul eder, JSON kodlanmış yanıtlar döndürür ve standart HTTP yanıt kodları, kimlik doğrulama ve verbler kullanır.

### Base URL

**Production:** `https://getminds.ai/api/v1` veya `https://api.getminds.ai/v1`

**Yerel Geliştirme:** `http://localhost:3000/api/v1`

Her iki production base URL'i tamamen eşdeğerdir. Daha temiz entegrasyon URL'leri için `api.getminds.ai` subdomain'i önerilir.

### Kimlik Doğrulama

Tüm API endpoint'leri API key ile kimlik doğrulaması gerektirir. API key'lerinizi [Settings → API Keys](/settings/api-keys) sayfasında oluşturup yönetebilirsiniz.

API key'inizi `Authorization` header'ına ekleyin:

```bash
Authorization: Bearer minds_your_api_key_here
```

### OpenAPI Spesifikasyonu

Makine tarafından okunabilir bir OpenAPI 3.1.0 spesifikasyonu [`/_openapi.json`](/_openapi.json) adresinde yayımlanır. Spesifikasyonu tip güvenli istemciler (TypeScript, Python vb.) üretmek veya tek seferlik entegrasyon kodu için bir LLM'e bırakmak amacıyla kullan. Örnekler için [OpenAPI](/docs/api/openapi) sayfasına bak.

### Content Type

Veri gönderen tüm istekler `Content-Type` header'ını içermelidir:

```bash
Content-Type: application/json
```

Dosya yüklemeleri için şunu kullanın:

```bash
Content-Type: multipart/form-data
```

## Mevcut Endpoint'ler

### Minds

Özel yapılandırmalarla AI mind'lar (ajanlar) oluşturun ve yönetin.

- `GET /api/v1/minds` - Tüm Mind'ları listele
- `GET /api/v1/minds/{mindId}` - Mind detaylarını al
- `POST /api/v1/minds` - Yeni bir Mind oluştur
- `PUT /api/v1/minds/{mindId}` - Bir Mind'ı güncelle
- `DELETE /api/v1/minds/{mindId}` - Bir Mind'ı sil
- `POST /api/v1/minds/{mindId}/regenerate-prompt` - Bilgilerden system prompt'u yeniden oluştur

### Knowledge

Mind'larınız için bilgi yönetin.

- `GET /api/v1/minds/{mindId}/knowledge` - Bilgi öğelerini listele
- `POST /api/v1/minds/{mindId}/knowledge` - Bilgi ekle (bağlantılar, dosyalar veya anahtar kelime araması)
- `PUT /api/v1/minds/{mindId}/knowledge/{itemId}` - Bir bilgi öğesini güncelle
- `DELETE /api/v1/minds/{mindId}/knowledge/{itemId}` - Bir bilgi öğesini sil
- `POST /api/v1/minds/{mindId}/knowledge/enrich` - Anahtar kelime araması ile zenginleştir (kısayol)
- `GET /api/v1/minds/{mindId}/knowledge/patterns` - Çerçeveye göre bilgi örüntülerini al

### Chat

Chat tamamlamaları aracılığıyla mind'larınızla etkileşim kurun.

- `POST /api/v1/minds/{mindId}/completion` - Mesaj gönder ve yanıt al

### Studies

Mind audiencesını anketlemek için AI studyler oluşturun ve yönetin.

- `GET /api/v1/studies` - Tüm studyleri listele
- `POST /api/v1/studies` - Yeni bir study oluştur
- `GET /api/v1/studies/{studyId}` - Mesaj geçmişiyle birlikte study detaylarını al
- `POST /api/v1/studies/{studyId}/ask` - Studydeki tüm mind'lara bir soru sor (SSE stream)
- `POST /api/v1/studies/{studyId}/export` - Study sonuçlarını rapor olarak dışa aktar
- `GET /api/v1/studies/{studyId}/export-status` - Dışa aktarma job durumunu kontrol et
- `GET /api/v1/studies/{studyId}/export-download` - Dışa aktarılan PDF'i indir

### User

Kullanıcıyla ilgili endpoint'ler.

- `GET /api/v1/auth/me` - Şu anki kimliği doğrulanmış kullanıcıyı al
- `GET /api/v1/user/shareable-sparks` - Paylaşım için uygun mind'ları listele

### API Keys

Kimlik doğrulama için API key'lerinizi yönetin.

- `GET /api/v1/api-keys` - API key'lerinizi listele
- `POST /api/v1/api-keys` - Yeni bir API key oluştur
- `DELETE /api/v1/api-keys/{keyId}` - Bir API key'i sil

## Hızlı Örnek

Bir mind oluşturup onunla sohbet etmenin hızlı bir örneği:

```bash
# 1. Bir mind oluştur (keywords modu)
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Expert",
    "description": "Expert in digital marketing strategies",
    "mode": "keywords",
    "type": "expert",
    "discipline": "Marketing",
    "keywords": ["SEO", "content marketing", "social media", "analytics"]
  }'

# Response: { "data": { "id": "mind-id", ... }, "processing": { "queued": true, ... } }

# 2. Sosyal profilden bir mind oluştur (clone modu)
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Influencer Clone",
    "description": "AI trained on influencer social presence",
    "mode": "clone",
    "type": "creative",
    "discipline": "Social Media Marketing",
    "personaContext": "https://twitter.com/username"
  }'

# 3. Mind ile sohbet et
curl -X POST "https://getminds.ai/api/v1/minds/mind-id/completion" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "What are the top social media trends for 2025?"
      }
    ]
  }'
```

## Sonraki Adımlar

- [Authentication](/docs/api/authentication) hakkında bilgi edinin
- [Minds endpoint'lerini](/docs/api/minds) keşfedin
- [Bilgi yönetimi](/docs/api/knowledge) hakkında okuyun
- [Chat tamamlamalarını](/docs/api/chat) anlayın
- Çoklu mind anketleri için [Studies](/docs/api/studies) oluşturun
- [Latency ve Performans](/docs/api/latency) bölümünü inceleyin
- [MCP Entegrasyonu](/mcp/overview) üzerinden bağlanın
- [Hatalar ve Limitler](/docs/api/errors) bölümünü inceleyin

## Plan Limitleri

API ve MCP erişimi desteklenen ücretli planlarda sunulur. Entegrasyonunuzda limitleri sabit kodlamak yerine yapılandırılmış `plan_limited` ve `429` yanıtlarını işleyin. Individual planı API payload'larında `"premium"` olarak görünür.

Aşağıdaki herkese açık varsayılanlar, ürünün kullandığı plan limiti ve özellik erişimi sözleşmesinden oluşturulur. Üründe gösterilen hesaba veya Enterprise sözleşmesine özel geçersiz kılmalar önceliklidir.

:plan-limits-table[Planları Görüntüle](/settings?tab=subscription)

## Yardıma mı İhtiyacınız Var?

API ile ilgili sorularınız varsa veya destek gerekiyorsa:

- [Rehberimizi](/guide) inceleyin
- Geri bildirim formu aracılığıyla bize ulaşın
- Topluluk tartışmalarımıza katılın