Kaynaklar / GeliştiricilerBaşvurunuz sorar.
Başvurunuz sorar.
afka işi yapar.
Görevler oluşturun, sonuçları alın ve imzalı etkinlikler alın. Bir kişi veya kodunuz işi başlatsa da aynı izinler ve onay kapıları geçerlidir.
Talepten sonuca.
Görev API'sini kullanarak net bir sonuç teslim edin. Görevi izleyin, yapıtlarını alın ve sonucu kendi uygulamanıza geri getirin.
POST https://api.afka.ai/v1/tasks
{ "prompt": "Prepare an evidence-backed candidate shortlist" }
202 Accepted
{ "task_id": "task_5f2c", "status": "queued" }
GET https://api.afka.ai/v1/tasks/task_5f2c
{ "status": "done", "credits_spent": 412,
"artifacts": ["art_9d1e"] }Küçük bir yüzey.
Tam bir iş döngüsü.
| İstek | Ne yaptığı | Sonuç |
|---|---|---|
| POST /v1/tasks | afka'nın üzerinde çalışması için bir sonuç gönder. | Sıraya alınan görev ve görev kimliği |
| GET /v1/tasks/:id | Çalıştırmayı ve mevcut durumunu okuyun. | Durum, harcanan krediler ve yapıtlar |
| görev.tamamlandı | Webhook'unuzda bir tamamlanma etkinliği alın. | Görev ve çalışma alanı referansları |
Bir anahtar asla kontrolün kısayolu değildir.
Erişim
İzinleri devralır
Bir anahtar, onu oluşturan kişiden daha fazla erişime sahip olamaz.
Güvenlik özeti oku ↗OnayAynı insan kapısı
Hassas işlemler yetkilendirilmiş kişinin onayını beklemektedir.
Onayları keşfet ↗KayıtSonucu izle
Teslim edilen yapıtın arkasındaki görevi ve eylemleri izleyin.
Platformu keşfet ↗İmzalı etkinlikler. Güvenli yeniden denemeler.
POST https://your-app.example/afka/hooks x-afka-event: task.finished x-afka-delivery: d_8f3a1c9e x-afka-signature: sha256=<hex digest> expected = hmac_sha256(signing_secret, raw_body).hexdigest()
İmzayı gövde ayrıştırılmadan önce ham istek baytlarına karşı doğrulayın. Yeniden denemeleri çoğaltmamak için kararlı delivery ID'sini kullanın. İmzalama sırlarını sunucuda tutun.
Yönetilen bir iş döngüsü üzerinde oluşturun.
Bir görevle başlayın. Sonuç ve onay süreci ekibiniz için uygun olduğunda genişletin.