BölümlerBuradan başla
Başlangıç
Referans
İş akışları
Başlangıç
Buradan başla
Nailing tahtasını HTTP üzerinden sür: linkleri ekle, grupla, oku, tahtaya sor. Anahtarını al, ilk çağrını bir dakikada yap.
Anahtar Authorization başlığında gider; uçlar tahtayı okumakla kalmaz, kurar.
export NAILING_API_KEY='nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' AUTH="Authorization: Bearer $NAILING_API_KEY" BASE=https://app.nailingai.co
Nailing API, Tahtayı tarayıcıda süren ekran; kartları buradan ekler, bağlar ve gruplarsın üzerinde elle yaptığın işi HTTP üzerinden yapmanı sağlar: bir Düğümlerin ve grupların kayıtlı durduğu çalışma yüzeyi; kendi kimliği ve adresi vardırya link ekler, kartları tek çerçevede toplar, tahtanın özetini okur, tahtaya sorar.
Aynı hesap, aynı tahtalar, aynı Ücretli işlemlerin birimi; sohbet ve deste basımı harcar, transkript çıkarmak harcamaz; bir otomasyon aracında (n8n, Zapier, Make) ya da kendi script’inde aynı işi tekrar tekrar yapıyorsan bu senin için, kanvasta çalışmayı seviyorsan değil.
Gereken tek şey giriş yapmış bir Nailing hesabı ve Ayarlar’dan ürettiğin bir nk_ ile başlayan gizli dize; Authorization başlığında gönderilir, bir kez gösterilir, iptal edilebilir; ayrı plan, başvuru ya da bekleme listesi yok, hesap başına en fazla 10 açık anahtar.
Bölüm 01
Bir dakikada ilk çağrı
Anahtarı üret
Ayarlar → API anahtarları → “Yeni anahtar”. (/settings/api-keys)
Anahtar bir kez gösterilir; o ekranı kapattığında bir daha görünmez. Kaybedersen “İptal et” ile kapatıp yenisini üret.
Kabuğa koy
Anahtarı komut satırına elle yazma; ortam değişkenine al. Satır başındaki boşluk çoğu kabukte o satırı geçmişe düşmekten kurtarır.
$BASEüretim adresidir (https://app.nailingai.co); staging kendi adresinde çalışır ve orada ürettiğin tahta kimlikleri üretimdeki çağrıya uymaz.export NAILING_API_KEY='nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' AUTH="Authorization: Bearer $NAILING_API_KEY" BASE=https://app.nailingai.co
Bir tahta aç
Anahtarın çalıştığını kanıtlayan en kısa çağrı:
POST /api/boards.Dönen
data.idbundan sonraki her isteğin tahta kimliği.curl -sS -X POST "$BASE/api/boards" \ -H "$AUTH" -H 'Content-Type: application/json' \ -d '{"name":"İlk tahtam","nodes":[],"edges":[]}'Cevabı oku
success: truegeldiyse anahtar çalışıyor. 401 geldiyse anahtar yanlış, eksik ya da iptal edilmiş — yeniden denemek yerine Ayarlar’dan kontrol et.{ "success": true, "data": { "id": "8f1c…-…-…", "name": "İlk tahtam" } }Tahtaya bir link koy
Artık gerçek iş: bir Instagram, TikTok ya da YouTube linki gönder.
Transkript arka planda çıkar, sen beklemezsin.
BOARD=8f1c…-…-… curl -sS -X POST "$BASE/api/boards/$BOARD/nodes" \ -H "$AUTH" -H 'Content-Type: application/json' \ -d '{"urls":["https://www.instagram.com/reel/DA1b2C3d4E/"]}'
Anahtar nerede durur
- Anahtar yalnız
Authorizationbaşlığında durur. Adres satırına, sorgu parametresine, ekran görüntüsüne, log’a yazma. - Biçimi
nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxgibidir —nk_ön eki, sızan bir anahtarı log’da aranabilir kılmak için var.
Bölüm 03
Dört kapı
| Uç nokta | Ne yapar | Kredi |
|---|---|---|
| POST /api/boards/{id}/nodes | Linkleri karta çevirir, transkripti kuyruğa alır | ücretsiz |
| POST /api/boards/{id}/groups | Kartları tek çerçevede toplar | ücretsiz |
| GET /api/boards/{id}/summary | Tahtayı ve transkript durumunu okur | ücretsiz |
| POST /api/boards/{id}/ask | Tahtaya sorar, deste planını da buradan istersin | harcar |
Beta: dört kapı da canlı ama yeni; üretim işini bağlamadan önce kendi hesabında küçük bir tahtayla dene, ters giden bir şeyi /support üzerinden yaz.
Adım adım
Ekranlarla göster
API anahtarı al
Bir ajanın senin adına tahtanı sürebilmesi için tek gereken şey bir anahtar. Ayarlar’dan üretilir, bir kez gösterilir, istediğin an iptal edilir.
8 adım →Tahtayı ajanla kur
Aynı üç iş — linkleri ekle, çerçevele, sor — tarayıcı açmadan da yapılır. Aşağıdaki her kare, o çağrılardan sonra tahtanın gerçekten aldığı hâl.
7 adım →Kur