Bölümler
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.

Nedir
Nailing API, Tahtayı tarayıcıda süren ekran; kartları buradan ekler, bağlar ve gruplarsın üzerinde elle yaptığın işi sunucu tarafında 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 eklemek, kartları tek çerçevede toplamak, tahtanın özetini okumak ve tahtaya soru sormak.
Aynı hesap, aynı tahtalar, aynı Ücretli işlemlerin birimi; sohbet ve deste basımı harcar, transkript çıkarmak harcamaz — sadece giriş kapısı tarayıcı yerine bir HTTP isteği.
Beta · doğrulanmadı
- Uç noktalar yazıldı ve birim testleriyle kilitlendi, ama HTTP üzerinden canlı bir turdan henüz geçmediler. Üretim işini buna bağlamadan önce kendi hesabında küçük bir tahtayla dene.
- Bozuk bir şey görürsen destek üzerinden yaz — bu sayfa ona göre düzelir.
Kimin için
Tarayıcı açmadan iş yürüten herkes için: bir otomasyon aracında (n8n, Zapier, Make) zamanlanmış bir akış kuranlar, kendi script’ini yazanlar ve bir ajana tahtayı kendi başına kurdurmak isteyenler.
Kanvasta çalışmayı seviyorsan buna ihtiyacın yok. API, aynı işi tekrar tekrar yapan kişinin aracı — ilk kez deneyen kişinin değil.
Ne gerekiyor
Giriş yapmış bir Nailing hesabı ve bir nk_ ile başlayan gizli dize; Authorization başlığında gönderilir, bir kez gösterilir, iptal edilebilir. Ayrı bir plan, ayrı bir başvuru ya da bekleme listesi yok: hesabı olan herkes Ayarlar’dan anahtar üretebilir, hesap başına en fazla 10 açık anahtar.
Kredi durumun da aynı kalır. Transkript çıkarmak ücretsiz; tahtaya sormak ve deste basmak hesabındaki krediden düşer, tıpkı kanvasta olduğu gibi.
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.
Kabuk hazırlığıbashexport 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.POST /api/boardsbashcurl -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.Cevapjson{ "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.
POST /api/boards/{id}/nodesbashBOARD=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.
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 |
Sonra nereye
Taban adres
Üretim: https://app.nailingai.co. Örneklerde $BASE bu adrestir.
Staging kendi adresinde çalışır ve orada ürettiğin tahta kimlikleri üretimdeki çağrıya uymaz. Hangi ortamda olduğundan emin değilsen üretimi kullan.