Felo API PlatformFelo API Platform

Felo APIs

LiveDoc API

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

POST/v2/livedocs

Kimlik doğrulama

Bearer API key

İçerik türü

application/json or multipart/form-data

Hız sınırı notları

Endpoint bazında sınırlar geçerli olabilir.

Bu sayfa, Felo hesap yetkileri ve Pro-kredi kuralları kullanan mevcut /v2 Felo API’lerini belgeler. Kredilerin düşülüp düşülmemesi işleme bağlıdır. Platform bakiyesiyle yapılan çağrılar için desteklenen bir Felo OpenAPI uç noktasını 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, 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

ParametreTürGerekliAçıklama
namestringEvetLiveDoc adı
descriptionstringHayırLiveDoc açıklaması
iconstringHayırLiveDoc simgesi

Örnek

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)

{
  "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ı

AlanTürAçıklama
short_idstringLiveDoc kimliği
namestringLiveDoc adı
descriptionstringLiveDoc açıklaması
iconstringLiveDoc simgesi
created_atstringOluşturma zaman damgası (ISO 8601)
modified_atstringSon değiştirme zaman damgası (ISO 8601)
is_sharedbooleanBu 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

ParametreTürGerekliAçıklama
keywordstringHayırAnahtar sözcüğe göre filtrele
pageintegerHayırSayfa numarası (1 tabanlı)
sizeintegerHayırSayfa boyutu

Örnek

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)

{
  "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 aynı alanları içerir; ayrıca:

AlanTürAçıklama
readmeobject | nullREADME bilgisi. README yoksa null.
readme.summarystring | nullTek satırlık proje açıklaması
readme.contentstring | nullREADME içeriği (Markdown)

Uç Nokta

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

İstek Gövdesi

ParametreTürGerekliAçıklama
namestringHayırYeni LiveDoc adı
descriptionstringHayırYeni LiveDoc açıklaması

Örnek

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

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

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

{
  "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

ParametreTürGerekliAçıklama
resource_typesstring[]HayırKaynak türlerine göre filtrele
pageintegerHayırSayfa numarası (1 tabanlı)
sizeintegerHayırSayfa boyutu

Örnek

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)

{
  "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ı

AlanTürAçıklama
idstringKaynak kimliği
titlestringKaynak başlığı
linkstringKaynak bağlantısı/URL’si
snippetstringKaynak özeti
thumbnailstringKüçük resim URL’si
resource_typestringKaynak türü (örn. web, ai_doc, file)
resource_keystringKaynak ilişkilendirme anahtarı
statusstringKaynak durumu
sourcestringKaynak kaynağı
created_atstringOluşturma zaman damgası (ISO 8601)
modified_atstringSon 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

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.

ParametreTürGerekliAçıklama
titlestringHayırYeni kaynak başlığı (en fazla 500 karakter)
snippetstringHayırYeni kaynak özeti (en fazla 2000 karakter)
thumbnailstringHayırYeni küçük resim URL’si (en fazla 2000 karakter)

Örnek

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

ParametreTürGerekliAçıklama
contentstringEvetKaynak için yeni Markdown içeriği

Örnek

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

ParametreTürGerekliAçıklama
titlestringHayırBelge başlığı (varsayılan "New Document")
contentstringEvetMarkdown 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

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

ParametreTürGerekliAçıklama
filefileEvetYüklenecek dosya
titlestringHayırBelge başlığı

Örnek

curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/upload-doc' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F '[email protected]' \
  -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

ParametreTürGerekliAçıklama
filefileEvetYüklenecek dosya

Örnek

curl -X POST 'https://openapi.felo.ai/v2/livedocs/PvyKouzJirXjFdst4uKRK3/resources/upload' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F '[email protected]'

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

ParametreTürGerekliAçıklama
urlsarrayEvetEklenecek 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"}
AlanTürGerekliAçıklama
urlstringEvetEklenecek URL (5–2000 karakter)
titlestringHayırKaynak için özel başlık (en fazla 1000 karakter). Atlanırsa başlık sayfadan otomatik olarak oluşturulur.

Örnek

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)

{
  "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ı

AlanTürAçıklama
urlstringİşlenen URL
statusstringSonuç durumu: success, failed veya existed
fail_reasonstringBaşarısızlık nedeni (başarılıysa null)
resource_idstringOluşturulan kaynak kimliği

13. Kaynağı Sil

Uç Nokta

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

Örnek

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)

{
  "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

ParametreTürGerekliAçıklama
querystringEvetAnlamsal arama için sorgu içeriği
resource_idsstring[]Hayırİçinde aranacak belirli kaynak kimlikleri (1-50). Atlanırsa ilgili kaynaklar sorguya göre otomatik yönlendirilir

Örnek

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)

{
  "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ı

AlanTürAçıklama
idstringKaynak kimliği
titlestringKaynak başlığı
contentstringEşleşen içerik
scorenumberAlaka skoru
metadataobjectEk 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

ParametreTürGerekliAçıklama
querystringEvetYönlendirme için sorgu içeriği
max_resourcesintegerHayırDöndürülecek maksimum kaynak kimliği sayısı

Örnek

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)

{
  "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

ParametreTürGerekliAçıklama
expires_inintegerHayırURL’nin saniye cinsinden süresi (varsayılan: 3600)

Örnek

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

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

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

{
  "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ı

AlanTürAçıklama
titlestringKaynak başlığı
typestringKaynak türü
contentstringKaynak 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çimiOkuma adımları
ai_docMarkdownString’i bir belge olarak işleyin veya saklayın; buna SuperAgent araştırma raporları dahildir
mindmapJSON olarak kodlanmış nesnelayout ve text içindeki Markdown başlık taslağını okumak için bir kez çözün
ai_pptslides içeren JSON olarak kodlanmış nesneBir 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ış metinMetni uygulamanızın ihtiyaçlarına göre gösterin

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

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

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

{
  "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ı 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 uç noktasıyla aynıdır.

Uç Nokta

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

İstek Gövdesi

ParametreTürGerekliAçıklama
resource_idstringEvetPPT kaynak kimliği
page_numberintegerEvetGeri getirilecek sayfa numarası (1’den başlar)
querystringEvetNe aranacağını açıklayan sorgu içeriği
max_chunkintegerHayırDöndürülecek maksimum parça sayısı (varsayılan: 3)

Örnek

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)

{
  "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ı ile aynıdır.


Hata Kodları

KodHTTP DurumuAçıklama
INVALID_API_KEY401API Anahtarı geçersiz veya iptal edilmiş
LIVEDOC_CREATE_FAILED502LiveDoc oluşturma başarısız oldu
LIVEDOC_UPDATE_FAILED502LiveDoc güncelleme başarısız oldu
LIVEDOC_DELETE_FAILED502LiveDoc silme başarısız oldu
LIVEDOC_NOT_FOUND404LiveDoc bulunamadı
LIVEDOC_LIST_FAILED502LiveDoc’ları listeleme başarısız oldu
LIVEDOC_RESOURCE_CREATE_FAILED502Kaynak oluşturma başarısız oldu
LIVEDOC_RESOURCE_UPLOAD_FAILED502Kaynak yükleme başarısız oldu
LIVEDOC_RESOURCE_DELETE_FAILED502Kaynak silme başarısız oldu
LIVEDOC_RESOURCE_NOT_FOUND404Kaynak bulunamadı
LIVEDOC_RESOURCE_LIST_FAILED502Kaynakları listeleme başarısız oldu
LIVEDOC_RESOURCE_RETRIEVE_FAILED502Kaynakları geri getirme başarısız oldu
LIVEDOC_RESOURCE_ADD_URLS_FAILED502URL 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

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

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

{
  "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ı

AlanTürAçıklama
summarystring | nullTek satırlık proje açıklaması. En fazla 2000 karakter.
contentstringREADME 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

ParametreTürGerekliAçıklama
summarystringHayırTek satırlık proje açıklaması (en fazla 2000 karakter)
contentstringHayırREADME içeriği (Markdown)

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

Örnek

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

ParametreTürGerekliAçıklama
contentstringEvetEklenecek içerik (Markdown)

Örnek

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

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

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

{
  "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

ParametreTürGerekliAçıklama
statusintegerHayırDuruma göre filtrele: 0=TODO, 1=IN_PROGRESS, 2=DONE
labelsstring[]HayırEtiketlere göre filtrele (görevler belirtilen tüm etiketleri içermelidir)
pageintegerHayırSayfa numarası (1 tabanlı)
sizeintegerHayırSayfa boyutu

Örnek

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)

{
  "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ı

AlanTürAçıklama
idstringGörev kimliği (UUID)
titlestringGörev başlığı
descriptionstringGörev açıklaması
statusintegerGörev durumu: 0=TODO, 1=IN_PROGRESS, 2=DONE
sortintegerSıralama düzeni (negatif olmayan)
labelsstring[]Etiket listesi
operated_bystringOperatör imzası, ör. claude-code, openclaw
created_atstringOluşturma zaman damgası (ISO 8601)
modified_atstringSon 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

ParametreTürGerekliAçıklama
titlestringEvetGörev başlığı
descriptionstringHayırGörev açıklaması
statusintegerEvetGörev durumu: 0=TODO, 1=IN_PROGRESS, 2=DONE
sortintegerEvetSıralama düzeni (negatif olmayan tam sayı)
labelsstring[]HayırEtiket listesi (en fazla 10, her biri en fazla 50 karakter)
operated_bystringHayırOperatör imzası, ör. claude-code, openclaw (en fazla 100 karakter)

Örnek

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.

ParametreTürGerekliAçıklama
titlestringHayırYeni görev başlığı
descriptionstringHayırYeni görev açıklaması
statusintegerHayırYeni durum: 0=TODO, 1=IN_PROGRESS, 2=DONE
sortintegerHayırYeni sıralama düzeni (negatif olmayan)
labelsstring[]HayırYeni etiket listesi (en fazla 10, her biri en fazla 50 karakter)
operated_bystringHayırOperatör imzası, ör. claude-code, openclaw (en fazla 100 karakter)

Örnek

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

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)

{
  "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

ParametreTürGerekliAçıklama
record_typestringHayırKayıt türüne göre filtrele: comment, edit, status_change
pageintegerHayırSayfa numarası (1 tabanlı)
sizeintegerHayırSayfa boyutu

Örnek

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)

{
  "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ı

AlanTürAçıklama
idstringKayıt kimliği
record_typestringKayıt türü: comment / edit / status_change
contentstringYorum metni (yalnızca comment türü için)
metaobjectDeğişiklik ayrıntıları (edit ve status_change türleri için)
task_idstringÜst görev kimliği
operated_bystringOperatör imzası, ör. claude-code, openclaw
created_atstringOluşturma zaman damgası (ISO 8601)
modified_atstringSon 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

ParametreTürGerekliAçıklama
contentstringEvetYorum içeriği
operated_bystringHayırOperatör imzası, ör. claude-code, openclaw (en fazla 100 karakter)

Örnek

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ı

KodHTTP DurumuAçıklama
INVALID_API_KEY401API Anahtarı geçersiz veya iptal edilmiş
LIVEDOC_CREATE_FAILED502LiveDoc oluşturma başarısız oldu
LIVEDOC_UPDATE_FAILED502LiveDoc güncelleme başarısız oldu
LIVEDOC_DELETE_FAILED502LiveDoc silme başarısız oldu
LIVEDOC_NOT_FOUND404LiveDoc bulunamadı
LIVEDOC_LIST_FAILED502LiveDoc’ları listeleme başarısız oldu
LIVEDOC_RESOURCE_CREATE_FAILED502Kaynak oluşturma başarısız oldu
LIVEDOC_RESOURCE_UPLOAD_FAILED502Kaynak yükleme başarısız oldu
LIVEDOC_RESOURCE_DELETE_FAILED502Kaynak silme başarısız oldu
LIVEDOC_RESOURCE_NOT_FOUND404Kaynak bulunamadı
LIVEDOC_RESOURCE_LIST_FAILED502Kaynakları listeleme başarısız oldu
LIVEDOC_RESOURCE_RETRIEVE_FAILED502Kaynakları geri getirme başarısız oldu
LIVEDOC_RESOURCE_ADD_URLS_FAILED502URL kaynakları ekleme başarısız oldu
LIVEDOC_README_GET_FAILED502README alma başarısız oldu
LIVEDOC_README_UPDATE_FAILED502README oluşturma veya güncelleme başarısız oldu
LIVEDOC_README_DELETE_FAILED502README silme başarısız oldu
LIVEDOC_README_NOT_FOUND404README bulunamadı
LIVEDOC_TASK_LIST_FAILED502Görevleri listeleme başarısız oldu
LIVEDOC_TASK_CREATE_FAILED502Görev oluşturma başarısız oldu
LIVEDOC_TASK_UPDATE_FAILED502Görev güncelleme başarısız oldu
LIVEDOC_TASK_DELETE_FAILED502Görev silme başarısız oldu
LIVEDOC_TASK_NOT_FOUND404Görev bulunamadı
LIVEDOC_TASK_RECORD_LIST_FAILED502Görev kayıtlarını listeleme başarısız oldu
LIVEDOC_TASK_COMMENT_CREATE_FAILED502Görev yorumu oluşturma başarısız oldu

Yardım mı gerekiyor?