Felo APIs
LiveDoc API
Bilgi tabanları oluşturun, kaynakları yönetin ve anlamsal erişim ile yönlendirmeyi çalıştırın.
/v2/livedocsKimlik 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_KEY1. 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
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ı
| 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/livedocsSorgu 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
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:
| 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
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}/resourcesSorgu 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
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ı
| 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
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
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
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
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
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
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
file | file | Evet | Yü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
| 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
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ı
| 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
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
| 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
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ı
| 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
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}/downloadSorgu Parametreleri
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
expires_in | integer | Hayır | URL’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ı
| 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:
{
"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
| 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
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ı
| 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
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ı
| 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:
summaryveyacontentalanları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
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
content | string | Evet | Eklenecek 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}/tasksSorgu 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
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ı
| 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
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
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}/recordsSorgu 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
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ı
| 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
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 |
Yardım mı gerekiyor?
- API, faturalama ve hesap sorularınız için destek ekibi ile iletişime geçin.
- Felo geliştiricileriyle Discord üzerinden sohbet edin.
- değişiklik günlüğü sayfamıza göz atın.
- Hacim fiyatlandırması veya satın alma desteği mi gerekiyor? Satış ekibiyle iletişime geçin.
- LLM ile mi geliştiriyorsunuz? llms.txt belgesini okuyun.