BölümlerYardım
Başlangıç
Referans
İş akışları
Destek
Yardım
Takıldığında nereye yazacağın, ne göndereceğin ve ajanın hangi durumlarda durmayı seçtiği.
Nereye yazılır
Tek kanal var: /support. Ürün içindeki destek sayfası — soru, hata bildirimi ve “bu sayfa yanlış yazıyor” hepsi oraya.
Bir nk_ ile başlayan gizli dize; Authorization başlığında gönderilir, bir kez gösterilir, iptal edilebilir ile ilgili bir şey soracaksan anahtarın kendisini yazma. İhtiyacımız olan tek şey adı ve ne zaman üretildiği; ikisi de Ayarlar’daki listede duruyor.
Ne gönderirsen mesele hızlı kapanır
Hangi çağrı
Yöntem ve yol:
POST /api/boards/{id}/nodesgibi.Adresin tamamını yapıştırmana gerek yok.
Ne gönderdin
İstek gövdesi.
Linkler varsa onları da koy — reddedilen bir linki görmeden sebebini söyleyemeyiz.
Ne döndü
Durum kodu ve cevabın tamamı.
error.messagealanı çoğu meselenin cevabını zaten taşır, ama kısaltılmış hâli taşımaz.Ne zaman
Yaklaşık saat ve saat dilimi.
Sunucu kayıtlarını bunsuz aramak bir gün içinde binlerce satır demek.
Tahta kimliği
Tahtayı tarayıcıda süren ekran; kartları buradan ekler, bağlar ve gruplarsınta
/board/<uuid>adresindeki değer.Anahtar değil — bu paylaşılabilir.
- Hata bildirirken anahtarı gönderme. Ekran görüntüsü alıyorsan
Authorizationsatırını kes. - Yanlışlıkla paylaştıysan önce Ayarlar’dan iptal et, sonra yaz — sıra bu. (/settings/api-keys)
Yazmadan önce
Gördüğün şey dört sık durumdan biriyse cevabı burada: 401 anahtar, 403 kapalı kapı, 404 yanlış Düğümlerin ve grupların kayıtlı durduğu çalışma yüzeyi; kendi kimliği ve adresi vardır ya da yanlış hesap, 429 hız sınırı. Ayrıntısı Tuzaklar sayfasında.
“Çağrı başarılı döndü ama bir şey olmadı” diyorsan Tuzaklar sayfası neredeyse kesin cevabı taşıyor — transkript hâlâ çıkıyordur, ya da deste basma çağrısı yapılmamıştır.
Ajan ne zaman durur
nailing-board skill’i takıldığında uydurup devam etmez. Durmayı seçtiği yerler kural olarak yazılı, ve durduğunda sana ne gördüğünü söyler.
| Durum | Ne yapar |
|---|---|
| Giriş sayfasına düştü | Giriş yapmaya çalışmaz. Durur, senden giriş yapmanı ister. |
| Bir ekran şifre / doğrulama kodu / kart bilgisi istiyor | Vermez. Durur ve sana söyler. |
| Beklediği düğme ekranda yok | Aramaya devam etmez. Durur, ne gördüğünü anlatır. |
| Aynı yerde iki kez takıldı | Üçüncüyü denemez. Durur ve sana sorar. |
| 401 aldı (tarayıcısız mod) | Tekrar denemez, başka anahtar aramaz, tarayıcıya geçmez. Durur. |
| Kredi harcayacak bir adıma geldi | Tahmini maliyeti söyler ve açık onayını bekler. |
| Hangi tahtaya yazacağı belirsiz | Tahmin etmez. Sorar. |
- Ajan “arayüz haritamla uyuşmuyor” derse elindeki skill kopyası bayatlamış olabilir.
- Zip’i Ajanla çalıştır sayfasından yeniden indir; sorun sürerse ekranda ne gördüğünü bize yaz.
Sık sorulanlar
Uç noktalar kararlı mı?
Beta. Yazıldılar ve birim testleriyle kilitlendiler, ama HTTP üzerinden canlı bir turdan henüz geçmediler.
Üretim işini bağlamadan önce kendi hesabında küçük bir tahtayla dene.
Bir sürüm numarası var mı?
Yok. Uç noktalar /api/… altında sürümsüz duruyor.
Kırıcı bir değişiklik olursa bu sayfalar önce güncellenir.
Bu sayfada yazmayan bir uç noktayı çağırabilir miyim?
Çağırma. Belgelenmemiş yollar haber verilmeden değişir, ve bir kısmı anahtara kapalıdır.
İhtiyacın olan bir şey eksikse yaz — kapalı olmasının bir sebebi olabilir, ya da olmayabilir.
Anahtarımı kaybettim, ne yapmalıyım?
Ayarlar’dan iptal et ve yenisini üret.
Açık hâli hiçbir yerde saklanmıyor, bu yüzden geri getirilemiyor.