# LiveDoc API

Bilgi tabanları oluşturun, kaynakları yönetin ve anlamsal erişim ile yönlendirmeyi çalıştırın.

Bu sayfa, **Felo hesap yetkileri ve Pro-kredi kuralları** kullanan mevcut `/v2` Felo API’lerini belgeler. Kredilerin düşülüp düşülmemesi [işleme](https://openapi.felo.ai/tr/docs/faq/billing-and-credits.md#v2-yetene-ine-g-re-kredi-kurallar) bağlıdır. Platform bakiyesiyle yapılan çağrılar için desteklenen bir [Felo OpenAPI uç noktasını](https://openapi.felo.ai/tr/docs/api-reference/openapi/overview.md) seçin; istek ve yanıt yapıları farklılık gösterebilir.

LiveDoc web URL’leri `https://felo.ai/livedoc/{short_id}` kullanır. LiveDoc’a erişimi olan bir tarayıcı oturumu gerekebilir. Her uç nokta için API’nin alan adlarını koruyun: SuperAgent `live_doc_short_id` döndürürken, mindmap ve PPT oluşturma `livedoc_short_id` döndürür.

LiveDoc API’si, belge oluşturma, dosya yükleme, URL içe aktarma ve anlamsal geri getirme dahil LiveDoc’lar ve kaynakları için tam CRUD işlemleri sağlar.

## Yapay zekâ ajanlarıyla kullanın

Bir Ajan’a LiveDoc desteği ve diğer tüm kullanılabilir Felo Skill’lerini vermek için eksiksiz `felo-ai` paketini yükleyin. Yükleyici, `SKILL.md` içeren her paket dizinini dinamik olarak keşfeder; buna gelecekteki paket eklemeleri de dahildir. Keşfedilen tüm Skill’leri Ajan’ın yerel dizinine yükleyin: Codex `~/.codex/skills`, Claude Code `~/.claude/skills`, OpenClaw `~/.agents/skills` veya Hermes Agent `~/.hermes/skills`. [manuel Yapay Zekâ Ajanı kurulum kılavuzu](https://openapi.felo.ai/tr/docs/felo-skills.md), her platform için farklı API anahtarı ve doğrulama adımlarını kapsar.


## Kimlik Doğrulama

Tüm istekler `Authorization` başlığında bir API Anahtarı gerektirir:

```
Authorization: Bearer YOUR_API_KEY
```

---

## 1. LiveDoc Oluştur

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `name` | string | Evet | LiveDoc adı |
| `description` | string | Hayır | LiveDoc açıklaması |
| `icon` | string | Hayır | LiveDoc simgesi |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "AI Research Notes",
    "description": "Collection of AI research materials"
  }'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "short_id": "PvyKouzJirXjFdst4uKRK3",
    "name": "AI Research Notes",
    "description": "Collection of AI research materials",
    "icon": null,
    "created_at": "2026-03-09T10:00:00Z",
    "modified_at": "2026-03-09T10:00:00Z"
  }
}
```
### Yanıt Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `short_id` | string | LiveDoc kimliği |
| `name` | string | LiveDoc adı |
| `description` | string | LiveDoc açıklaması |
| `icon` | string | LiveDoc simgesi |
| `created_at` | string | Oluşturma zaman damgası (ISO 8601) |
| `modified_at` | string | Son değiştirme zaman damgası (ISO 8601) |
| `is_shared` | boolean | Bu LiveDoc’un geçerli kullanıcıyla paylaşılmış olup olmadığı (onlara ait değil) |

---

## 2. LiveDoc’ları Listele

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs
```

### Sorgu Parametreleri

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `keyword` | string | Hayır | Anahtar sözcüğe göre filtrele |
| `page` | integer | Hayır | Sayfa numarası (1 tabanlı) |
| `size` | integer | Hayır | Sayfa boyutu |

### Örnek

```bash
curl 'https://openapi.felo.ai/v2/livedocs?keyword=AI&page=1&size=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "total": 2,
    "page": 1,
    "size": 20,
    "items": [
      {
        "short_id": "PvyKouzJirXjFdst4uKRK3",
        "name": "AI Research Notes",
        "description": "Collection of AI research materials",
        "icon": null,
        "created_at": "2026-03-09T10:00:00Z",
        "modified_at": "2026-03-09T10:05:00Z",
        "is_shared": false,
        "readme": {
          "summary": "AI research notes and papers collection",
          "content": "# AI Research Notes\n\nThis LiveDoc contains..."
        }
      }
    ]
  }
}
```
### Yanıt Alanları

`items` içindeki her öğe, [LiveDoc oluşturma yanıtındaki](#yan-t-alanlar) aynı alanları içerir; ayrıca:

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `readme` | object \| null | README bilgisi. README yoksa `null`. |
| `readme.summary` | string \| null | Tek satırlık proje açıklaması |
| `readme.content` | string \| null | README içeriği (Markdown) |

---

### Uç Nokta

```
PUT https://openapi.felo.ai/v2/livedocs/{short_id}
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `name` | string | Hayır | Yeni LiveDoc adı |
| `description` | string | Hayır | Yeni LiveDoc açıklaması |

### Örnek

```bash
curl -X PUT 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Updated Research Notes"
  }'
```

### Başarılı Yanıt (200)

Güncellenmiş LiveDoc nesnesini döndürür (Create ile aynı yapı).

---

## 4. LiveDoc’u Sil

### Uç Nokta

```
DELETE https://openapi.felo.ai/v2/livedocs/{short_id}
```

### Örnek

```bash
curl -X DELETE 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": null
}
```
---

## 5. Kaynakları Listele

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs/{short_id}/resources
```

### Sorgu Parametreleri

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `resource_types` | string[] | Hayır | Kaynak türlerine göre filtrele |
| `page` | integer | Hayır | Sayfa numarası (1 tabanlı) |
| `size` | integer | Hayır | Sayfa boyutu |

### Örnek

```bash
curl 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources?page=1&size=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "total": 2,
    "page": 1,
    "size": 20,
    "items": [
      {
        "id": "res_001",
        "title": "OpenAI Blog Post",
        "link": "https://openai.com/blog/...",
        "snippet": "Summary of the article...",
        "thumbnail": null,
        "resource_type": "web",
        "resource_key": "key_001",
        "status": "completed",
        "source": "url",
        "created_at": "2026-03-09T10:00:10Z",
        "modified_at": "2026-03-09T10:00:15Z"
      }
    ]
  }
}
```
### Kaynak Yanıt Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `id` | string | Kaynak kimliği |
| `title` | string | Kaynak başlığı |
| `link` | string | Kaynak bağlantısı/URL’si |
| `snippet` | string | Kaynak özeti |
| `thumbnail` | string | Küçük resim URL’si |
| `resource_type` | string | Kaynak türü (örn. `web`, `ai_doc`, `file`) |
| `resource_key` | string | Kaynak ilişkilendirme anahtarı |
| `status` | string | Kaynak durumu |
| `source` | string | Kaynak kaynağı |
| `created_at` | string | Oluşturma zaman damgası (ISO 8601) |
| `modified_at` | string | Son değiştirme zaman damgası (ISO 8601) |

---

## 6. Tek Kaynak Al

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs/{short_id}/resources/{resource_id}
```

### Örnek

```bash
curl 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/res_001' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

Liste Kaynaklar’daki öğelerle aynı yapıda tek bir kaynak nesnesi döndürür.

---

## 7. Kaynağı Güncelle

Bir kaynağın `title`, `snippet` veya `thumbnail` alanını güncelleyin. Yalnızca sağlanan alanlar güncellenir; atlanan alanlar mevcut değerlerini korur.

### Uç Nokta

```
PUT https://openapi.felo.ai/v2/livedocs/{short_id}/resources/{resource_id}
```

### İstek Gövdesi

Tüm alanlar isteğe bağlıdır.

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `title` | string | Hayır | Yeni kaynak başlığı (en fazla 500 karakter) |
| `snippet` | string | Hayır | Yeni kaynak özeti (en fazla 2000 karakter) |
| `thumbnail` | string | Hayır | Yeni küçük resim URL’si (en fazla 2000 karakter) |

### Örnek

```bash
curl -X PUT 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/res_001' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Updated Title",
    "snippet": "Updated summary of the resource."
  }'
```

### Başarılı Yanıt (200)

Liste Kaynaklar’daki öğelerle aynı yapıda güncellenmiş kaynak nesnesini döndürür.

---

## 8. Kaynak İçeriğini Güncelle

Bir `ai_doc` kaynağının Markdown içeriğini güncelleyin. Yalnızca `resource_type == ai_doc` olan kaynaklar için desteklenir. `snippet` alanı, yeni içeriğin ilk 2000 baytından otomatik olarak güncellenir.

### Uç Nokta

```
PUT https://openapi.felo.ai/v2/livedocs/{short_id}/resources/{resource_id}/content
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `content` | string | Evet | Kaynak için yeni Markdown içeriği |

### Örnek

```bash
curl -X PUT 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/res_001/content' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": "# Updated Document\n\nThis is the new content."
  }'
```

### Başarılı Yanıt (200)

Liste Kaynaklar’daki öğelerle aynı yapıda güncellenmiş kaynak nesnesini döndürür.

---

## 9. Belge Kaynağı Oluştur

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/resources/doc
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `title` | string | Hayır | Belge başlığı (varsayılan "New Document") |
| `content` | string | Evet | Markdown belge içeriği; düz metin de geçerli Markdown’dır |

Bu, bir `ai_doc` kaynağı oluşturur. Başlıkları, listeleri ve bağlantıları yeni satırlar `\n` olarak kaçırılmış biçimde bir JSON string içinde Markdown olarak gönderin. Biçimlendirilmiş belge içeriği için Markdown kullanın.

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/doc' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "My Research Notes",
    "content": "# Research Notes\n\n## Key findings\n\n- First finding\n- Second finding"
  }'
```

### Başarılı Yanıt (200)

Oluşturulan kaynak nesnesini döndürür.
---

## 10. Dosyayı Belge Olarak Yükle

Bir dosya yükleyin ve onu bir belge kaynağına (`ai_doc` türü) dönüştürün.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/resources/upload-doc
```

### İçerik Türü

`multipart/form-data`

### İstek Bölümleri

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `file` | file | Evet | Yüklenecek dosya |
| `title` | string | Hayır | Belge başlığı |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/upload-doc' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@document.pdf' \
  -F 'title=My PDF Document'
```

### Başarılı Yanıt (200)

Oluşturulan kaynak nesnesini döndürür.

---

## 11. Dosya Kaynağı Yükle

Bir dosya yükleyin ve orijinal biçimini koruyun.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/resources/upload
```

### İçerik Türü

`multipart/form-data`

### İstek Bölümleri

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `file` | file | Evet | Yüklenecek dosya |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/upload' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@report.xlsx'
```

### Başarılı Yanıt (200)

Oluşturulan kaynak nesnesini döndürür.
---

## 12. URL Kaynakları Ekle

Bir LiveDoc’a bir veya daha fazla URL’yi kaynak olarak ekleyin.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/resources/urls
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `urls` | array | Evet | Eklenecek URL öğeleri listesi (1–10). Her öğe düz bir string veya `url` ile isteğe bağlı `title` içeren bir nesne olabilir. |

#### URL Öğesi Biçimleri

`urls` içindeki her giriş şu biçimlerden biri olabilir:

- Düz bir string: `"https://example.com/article"`
- Bir nesne: `{"url": "https://example.com/article", "title": "Custom Title"}`

| Alan | Tür | Gerekli | Açıklama |
|-------|------|----------|-------------|
| `url` | string | Evet | Eklenecek URL (5–2000 karakter) |
| `title` | string | Hayır | Kaynak için özel başlık (en fazla 1000 karakter). Atlanırsa başlık sayfadan otomatik olarak oluşturulur. |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/urls' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "urls": [
      "https://example.com/article-1",
      {"url": "https://example.com/article-2", "title": "My Custom Title"}
    ]
  }'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": [
    {
      "url": "https://example.com/article-1",
      "status": "success",
      "fail_reason": null,
      "resource_id": "res_003"
    },
    {
      "url": "https://example.com/article-2",
      "status": "existed",
      "fail_reason": null,
      "resource_id": "res_004"
    }
  ]
}
```

### URL Sonuç Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `url` | string | İşlenen URL |
| `status` | string | Sonuç durumu: `success`, `failed` veya `existed` |
| `fail_reason` | string | Başarısızlık nedeni (başarılıysa null) |
| `resource_id` | string | Oluşturulan kaynak kimliği |

---

## 13. Kaynağı Sil

### Uç Nokta

```
DELETE https://openapi.felo.ai/v2/livedocs/{short_id}/resources/{resource_id}
```

### Örnek

```bash
curl -X DELETE 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/res_001' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": null
}
```

---

## 14. Geri Getir (Anlamsal Arama)

Bir LiveDoc içindeki kaynaklar üzerinde anlamsal geri getirme yapın.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/resources/retrieve
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `query` | string | Evet | Anlamsal arama için sorgu içeriği |
| `resource_ids` | string[] | Hayır | İçinde aranacak belirli kaynak kimlikleri (1-50). Atlanırsa ilgili kaynaklar sorguya göre otomatik yönlendirilir |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/retrieve' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "latest developments in large language models",
    "resource_ids": ["res_001", "res_002"]
  }'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": [
    {
      "id": "res_001",
      "title": "LLM Research Paper",
      "content": "Relevant content excerpt...",
      "score": 0.92,
      "metadata": {}
    }
  ]
}
```

### Geri Getirme Sonuç Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `id` | string | Kaynak kimliği |
| `title` | string | Kaynak başlığı |
| `content` | string | Eşleşen içerik |
| `score` | number | Alaka skoru |
| `metadata` | object | Ek meta veriler |

---

## 15. Kaynakları Yönlendir

Bir sorguya göre bir LiveDoc’tan ilgili kaynakları yönlendirin. Geri getirme uç noktasına geçirilebilecek bir kaynak kimliği listesi döndürür.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/resources/route
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `query` | string | Evet | Yönlendirme için sorgu içeriği |
| `max_resources` | integer | Hayır | Döndürülecek maksimum kaynak kimliği sayısı |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/route' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "latest developments in large language models",
    "max_resources": 5
  }'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": ["res_001", "res_003", "res_007"]
}
```

---

## 16. Kaynak Kaynak Dosyasını İndir

Bir kaynağın kaynak dosyasını alın. Önceden imzalanmış indirme URL’sine bir `302` yönlendirmesi döndürür.

Yalnızca ilişkili bir kaynak dosyası olan kaynaklar için desteklenir (örn. yüklenen belgeler).

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs/{short_id}/resources/{resource_id}/download
```

### Sorgu Parametreleri

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `expires_in` | integer | Hayır | URL’nin saniye cinsinden süresi (varsayılan: 3600) |

### Örnek

```bash
curl -L 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/res_001/download' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Yanıt

Önceden imzalanmış S3 indirme URL’sini gösteren bir `Location` başlığıyla `302 Found` döndürür. Yönlendirme desteği olan HTTP istemcileri (örn. `curl -L`) yönlendirmeyi izleyecek ve dosyayı doğrudan indirecektir.

---

## 17. Kaynak İçeriğini Al

Bir kaynağın çıkarılmış metin içeriğini getirir. Çoğu kaynak türü için desteklenir (belge, web, video, ai_doc, ai_ppt, text, voice, mindmap vb.). `image` gibi desteklenmeyen türler için 400 döndürür.

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs/{short_id}/resources/{resource_id}/content
```

### Örnek

```bash
curl 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/res_001/content' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "title": "Q4 Financial Report",
    "type": "document",
    "content": "Full extracted text content of the resource..."
  }
}
```

### Yanıt Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `title` | string | Kaynak başlığı |
| `type` | string | Kaynak türü |
| `content` | string | Kaynak içeriği; yorumlama aşağıda açıklandığı gibi `type`’a bağlıdır |

### Kaynak içerik biçimleri

`data.content` bir string’dir. Nasıl okunacağını seçmek için `data.type` kullanın:

| Kaynak türü | İçerik biçimi | Okuma adımları |
|---|---|---|
| `ai_doc` | Markdown | String’i bir belge olarak işleyin veya saklayın; buna SuperAgent araştırma raporları dahildir |
| `mindmap` | JSON olarak kodlanmış nesne | `layout` ve `text` içindeki Markdown başlık taslağını okumak için bir kez çözün |
| `ai_ppt` | `slides` içeren JSON olarak kodlanmış nesne | Bir kez çözün, ardından JSON içeriyorsa her slaytın `content` string’ini çözün |
| Diğer metin taşıyan türler | Çıkarılmış metin | Metni uygulamanızın ihtiyaçlarına göre gösterin |

Çözümlendikten sonra mindmap içeriği örneği:

```json
{
  "layout": "mindMap",
  "text": "# Topic\n## Branch\n### Leaf"
}
```

Çözümlendikten sonra PPT içeriği örneği:

```json
{
  "slides": [
    {
      "page": 1,
      "title": "Introduction",
      "content": "{\"coreIdea\":\"Introduce the topic\",\"slideOverview\":\"Overview of key points\",\"themeDescription\":\"Light background\"}",
      "theme": "light",
      "url": "https://example.com/slide-preview?signature=..."
    }
  ]
}
```

Slayt alanları oluşturucuya bağlıdır ve eksik olabilir veya ek bilgi içerebilir. `coreIdea`, `slideOverview` ve `themeDescription` alanlarını isteğe bağlı sunum meta verileri olarak değerlendirin. Bir slaytın `content` alanı düz metinse, doğrudan gösterin.

Slayt `url` değerleri geçici imzalı bağlantılardır. Yaşam süreleri verildiğinde belirlenir; bağlantı sona erdiğinde güncel kaynak içeriğini yeniden alın. PPTX indirmeleri için, yanıtında `expires_at` bulunan ayrı [PPT dışa aktarma iş akışını](https://openapi.felo.ai/tr/docs/api-reference/ppt-tasks.md#pptx-d-a-aktar) kullanın.

---

## 18. PPT Sayfası Geri Getir

Bir PPT kaynağının belirli bir sayfasında derin içerik geri getirme yapın. Slayt sayfasını tarar ve sıralanmış içerik parçaları döndürür. Yanıt biçimi [Geri Getir](#14-geri-getir-anlamsal-arama) uç noktasıyla aynıdır.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/resources/ppt-retrieve
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `resource_id` | string | Evet | PPT kaynak kimliği |
| `page_number` | integer | Evet | Geri getirilecek sayfa numarası (1’den başlar) |
| `query` | string | Evet | Ne aranacağını açıklayan sorgu içeriği |
| `max_chunk` | integer | Hayır | Döndürülecek maksimum parça sayısı (varsayılan: 3) |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/ppt-retrieve' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "resource_id": "res_001",
    "page_number": 3,
    "query": "product pricing information",
    "max_chunk": 3
  }'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": [
    {
      "id": "res_001_page_3_chunk_1",
      "title": "Q4 Product Deck",
      "content": "Relevant slide content excerpt...",
      "score": null,
      "metadata": {
        "resource_id": "res_001",
        "page_number": 3,
        "index": 1
      }
    }
  ]
}
```

### Yanıt Alanları

[Geri Getirme Sonuç Alanları](#geri-getirme-sonu-alanlar) ile aynıdır.

---

## Hata Kodları


| Kod | HTTP Durumu | Açıklama |
|------|-------------|-------------|
| `INVALID_API_KEY` | 401 | API Anahtarı geçersiz veya iptal edilmiş |
| `LIVEDOC_CREATE_FAILED` | 502 | LiveDoc oluşturma başarısız oldu |
| `LIVEDOC_UPDATE_FAILED` | 502 | LiveDoc güncelleme başarısız oldu |
| `LIVEDOC_DELETE_FAILED` | 502 | LiveDoc silme başarısız oldu |
| `LIVEDOC_NOT_FOUND` | 404 | LiveDoc bulunamadı |
| `LIVEDOC_LIST_FAILED` | 502 | LiveDoc’ları listeleme başarısız oldu |
| `LIVEDOC_RESOURCE_CREATE_FAILED` | 502 | Kaynak oluşturma başarısız oldu |
| `LIVEDOC_RESOURCE_UPLOAD_FAILED` | 502 | Kaynak yükleme başarısız oldu |
| `LIVEDOC_RESOURCE_DELETE_FAILED` | 502 | Kaynak silme başarısız oldu |
| `LIVEDOC_RESOURCE_NOT_FOUND` | 404 | Kaynak bulunamadı |
| `LIVEDOC_RESOURCE_LIST_FAILED` | 502 | Kaynakları listeleme başarısız oldu |
| `LIVEDOC_RESOURCE_RETRIEVE_FAILED` | 502 | Kaynakları geri getirme başarısız oldu |
| `LIVEDOC_RESOURCE_ADD_URLS_FAILED` | 502 | URL kaynakları ekleme başarısız oldu |

---

## 19. README Al

Bir LiveDoc’un README içeriğini alın. README ayarlanmamışsa boş bir string döndürür.

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs/{short_id}/readme
```

### Örnek

```bash
curl 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/readme' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "summary": "A brief one-line description of the project.",
    "content": "# My LiveDoc\n\nThis is the README content in Markdown."
  }
}
```

### Yanıt Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `summary` | string \| null | Tek satırlık proje açıklaması. En fazla 2000 karakter. |
| `content` | string | README içeriği (Markdown). Ayarlı değilse boş string. |

---

## 20. README Oluştur veya Güncelle

Bir LiveDoc’un README’sini oluşturun veya güncelleyin (upsert semantiği).

### Uç Nokta

```
PUT https://openapi.felo.ai/v2/livedocs/{short_id}/readme
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `summary` | string | Hayır | Tek satırlık proje açıklaması (en fazla 2000 karakter) |
| `content` | string | Hayır | README içeriği (Markdown) |

> **Not:** `summary` veya `content` alanlarından en az biri sağlanmalıdır.

### Örnek

```bash
curl -X PUT 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/readme' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "summary": "A brief one-line description of the project.",
    "content": "# My LiveDoc\n\nThis is the README content in Markdown."
  }'
```

### Başarılı Yanıt (200)

Güncellenmiş README nesnesini döndürür (README Al ile aynı yapı).

---

## 21. README’ye Ekle

Mevcut bir README’nin sonuna içerik ekleyin. README yoksa, sağlanan içerikle yeni bir tane oluşturur.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/readme/append
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `content` | string | Evet | Eklenecek içerik (Markdown) |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/readme/append' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": "\n\n## New Section\n\nAdditional content appended to README."
  }'
```

### Başarılı Yanıt (200)

Eklemeyi takiben tam README nesnesini döndürür (README Al ile aynı yapı).

---

## 22. README’yi Sil

Bir LiveDoc’un README’sini silin.

### Uç Nokta

```
DELETE https://openapi.felo.ai/v2/livedocs/{short_id}/readme
```

### Örnek

```bash
curl -X DELETE 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/readme' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": null
}
```

---

## 23. Görevleri Listele

Bir LiveDoc’taki görevlerin sayfalandırılmış listesini alın. Sonuçlar `sort` artan, `status` artan, `created_at` azalan şekilde sıralanır.

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs/{short_id}/tasks
```

### Sorgu Parametreleri

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `status` | integer | Hayır | Duruma göre filtrele: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE |
| `labels` | string[] | Hayır | Etiketlere göre filtrele (görevler belirtilen tüm etiketleri içermelidir) |
| `page` | integer | Hayır | Sayfa numarası (1 tabanlı) |
| `size` | integer | Hayır | Sayfa boyutu |

### Örnek

```bash
curl 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/tasks?status=0&page=1&size=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "total": 1,
    "page": 1,
    "size": 20,
    "items": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "title": "Write documentation",
        "description": "Write API documentation for the new endpoints",
        "status": 0,
        "sort": 0,
        "labels": ["docs", "priority-high"],
        "created_at": "2026-03-19T10:00:00Z",
        "modified_at": "2026-03-19T10:00:00Z"
      }
    ]
  }
}
```

### Görev Yanıt Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `id` | string | Görev kimliği (UUID) |
| `title` | string | Görev başlığı |
| `description` | string | Görev açıklaması |
| `status` | integer | Görev durumu: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE |
| `sort` | integer | Sıralama düzeni (negatif olmayan) |
| `labels` | string[] | Etiket listesi |
| `operated_by` | string | Operatör imzası, ör. `claude-code`, `openclaw` |
| `created_at` | string | Oluşturma zaman damgası (ISO 8601) |
| `modified_at` | string | Son değiştirme zaman damgası (ISO 8601) |

---

## 24. Görev Oluştur

LiveDoc içinde yeni bir görev oluşturun.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/tasks
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `title` | string | Evet | Görev başlığı |
| `description` | string | Hayır | Görev açıklaması |
| `status` | integer | Evet | Görev durumu: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE |
| `sort` | integer | Evet | Sıralama düzeni (negatif olmayan tam sayı) |
| `labels` | string[] | Hayır | Etiket listesi (en fazla 10, her biri en fazla 50 karakter) |
| `operated_by` | string | Hayır | Operatör imzası, ör. `claude-code`, `openclaw` (en fazla 100 karakter) |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/tasks' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Write documentation",
    "description": "Write API documentation for the new endpoints",
    "status": 0,
    "sort": 0,
    "labels": ["docs", "priority-high"]
  }'
```

### Başarılı Yanıt (200)

Oluşturulan görev nesnesini döndürür (Görevleri Listele’deki öğelerle aynı yapı).

---

## 25. Görevi Güncelle

Bir görevi kısmen güncelleyin. Yalnızca sağlanan alanlar güncellenir; atlanan alanlar mevcut değerlerini korur.

### Uç Nokta

```
PATCH https://openapi.felo.ai/v2/livedocs/{short_id}/tasks/{task_id}
```

### İstek Gövdesi

Tüm alanlar isteğe bağlıdır.

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `title` | string | Hayır | Yeni görev başlığı |
| `description` | string | Hayır | Yeni görev açıklaması |
| `status` | integer | Hayır | Yeni durum: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE |
| `sort` | integer | Hayır | Yeni sıralama düzeni (negatif olmayan) |
| `labels` | string[] | Hayır | Yeni etiket listesi (en fazla 10, her biri en fazla 50 karakter) |
| `operated_by` | string | Hayır | Operatör imzası, ör. `claude-code`, `openclaw` (en fazla 100 karakter) |

### Örnek

```bash
curl -X PATCH 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/tasks/550e8400-e29b-41d4-a716-446655440000' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "status": 1
  }'
```

### Başarılı Yanıt (200)

Güncellenmiş görev nesnesini döndürür (Görevleri Listele’deki öğelerle aynı yapı).

---

## 26. Görevi Sil

Bir görevi yumuşak silme ile kaldırın.

### Uç Nokta

```
DELETE https://openapi.felo.ai/v2/livedocs/{short_id}/tasks/{task_id}
```

### Örnek

```bash
curl -X DELETE 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/tasks/550e8400-e29b-41d4-a716-446655440000' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": null
}
```

---

## 27. Görev Kayıtlarını Listele

Bir görev için kayıtların (yorumlar ve değişiklik geçmişi) sayfalandırılmış listesini alın; `created_at` artan şekilde sıralanır.

### Uç Nokta

```
GET https://openapi.felo.ai/v2/livedocs/{short_id}/tasks/{task_id}/records
```

### Sorgu Parametreleri

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `record_type` | string | Hayır | Kayıt türüne göre filtrele: `comment`, `edit`, `status_change` |
| `page` | integer | Hayır | Sayfa numarası (1 tabanlı) |
| `size` | integer | Hayır | Sayfa boyutu |

### Örnek

```bash
curl 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/tasks/550e8400-e29b-41d4-a716-446655440000/records' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

### Başarılı Yanıt (200)

```json
{
  "status": 200,
  "code": "OK",
  "request_id": "req_example",
  "message": null,
  "data": {
    "total": 2,
    "page": 1,
    "size": 20,
    "items": [
      {
        "id": "rec_001",
        "record_type": "comment",
        "content": "This is a comment",
        "meta": null,
        "task_id": "550e8400-e29b-41d4-a716-446655440000",
        "created_at": "2026-03-19T10:05:00Z",
        "modified_at": "2026-03-19T10:05:00Z"
      },
      {
        "id": "rec_002",
        "record_type": "status_change",
        "content": null,
        "meta": {"from": 0, "to": 1},
        "task_id": "550e8400-e29b-41d4-a716-446655440000",
        "created_at": "2026-03-19T10:10:00Z",
        "modified_at": "2026-03-19T10:10:00Z"
      }
    ]
  }
}
```

### Görev Kayıt Yanıt Alanları

| Alan | Tür | Açıklama |
|-------|------|-------------|
| `id` | string | Kayıt kimliği |
| `record_type` | string | Kayıt türü: `comment` / `edit` / `status_change` |
| `content` | string | Yorum metni (yalnızca `comment` türü için) |
| `meta` | object | Değişiklik ayrıntıları (`edit` ve `status_change` türleri için) |
| `task_id` | string | Üst görev kimliği |
| `operated_by` | string | Operatör imzası, ör. `claude-code`, `openclaw` |
| `created_at` | string | Oluşturma zaman damgası (ISO 8601) |
| `modified_at` | string | Son değiştirme zaman damgası (ISO 8601) |

---

## 28. Göreve Yorum Ekle

Bir göreve yorum ekleyin.

### Uç Nokta

```
POST https://openapi.felo.ai/v2/livedocs/{short_id}/tasks/{task_id}/comments
```

### İstek Gövdesi

| Parametre | Tür | Gerekli | Açıklama |
|-----------|------|----------|-------------|
| `content` | string | Evet | Yorum içeriği |
| `operated_by` | string | Hayır | Operatör imzası, ör. `claude-code`, `openclaw` (en fazla 100 karakter) |

### Örnek

```bash
curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/tasks/550e8400-e29b-41d4-a716-446655440000/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": "This task is now in progress."
  }'
```

### Başarılı Yanıt (200)

Oluşturulan kayıt nesnesini döndürür (Görev Kayıtlarını Listele’deki öğelerle aynı yapı).

---

## Güncellenmiş Hata Kodları

| Kod | HTTP Durumu | Açıklama |
|------|-------------|-------------|
| `INVALID_API_KEY` | 401 | API Anahtarı geçersiz veya iptal edilmiş |
| `LIVEDOC_CREATE_FAILED` | 502 | LiveDoc oluşturma başarısız oldu |
| `LIVEDOC_UPDATE_FAILED` | 502 | LiveDoc güncelleme başarısız oldu |
| `LIVEDOC_DELETE_FAILED` | 502 | LiveDoc silme başarısız oldu |
| `LIVEDOC_NOT_FOUND` | 404 | LiveDoc bulunamadı |
| `LIVEDOC_LIST_FAILED` | 502 | LiveDoc’ları listeleme başarısız oldu |
| `LIVEDOC_RESOURCE_CREATE_FAILED` | 502 | Kaynak oluşturma başarısız oldu |
| `LIVEDOC_RESOURCE_UPLOAD_FAILED` | 502 | Kaynak yükleme başarısız oldu |
| `LIVEDOC_RESOURCE_DELETE_FAILED` | 502 | Kaynak silme başarısız oldu |
| `LIVEDOC_RESOURCE_NOT_FOUND` | 404 | Kaynak bulunamadı |
| `LIVEDOC_RESOURCE_LIST_FAILED` | 502 | Kaynakları listeleme başarısız oldu |
| `LIVEDOC_RESOURCE_RETRIEVE_FAILED` | 502 | Kaynakları geri getirme başarısız oldu |
| `LIVEDOC_RESOURCE_ADD_URLS_FAILED` | 502 | URL kaynakları ekleme başarısız oldu |
| `LIVEDOC_README_GET_FAILED` | 502 | README alma başarısız oldu |
| `LIVEDOC_README_UPDATE_FAILED` | 502 | README oluşturma veya güncelleme başarısız oldu |
| `LIVEDOC_README_DELETE_FAILED` | 502 | README silme başarısız oldu |
| `LIVEDOC_README_NOT_FOUND` | 404 | README bulunamadı |
| `LIVEDOC_TASK_LIST_FAILED` | 502 | Görevleri listeleme başarısız oldu |
| `LIVEDOC_TASK_CREATE_FAILED` | 502 | Görev oluşturma başarısız oldu |
| `LIVEDOC_TASK_UPDATE_FAILED` | 502 | Görev güncelleme başarısız oldu |
| `LIVEDOC_TASK_DELETE_FAILED` | 502 | Görev silme başarısız oldu |
| `LIVEDOC_TASK_NOT_FOUND` | 404 | Görev bulunamadı |
| `LIVEDOC_TASK_RECORD_LIST_FAILED` | 502 | Görev kayıtlarını listeleme başarısız oldu |
| `LIVEDOC_TASK_COMMENT_CREATE_FAILED` | 502 | Görev yorumu oluşturma başarısız oldu |
