BölümlerBuradan başla

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.

Kabuk hazırlığı
bash
export NAILING_API_KEY='nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
AUTH="Authorization: Bearer $NAILING_API_KEY"
BASE=https://app.nailingai.co

Nailing API, üzerinde elle yaptığın işi HTTP üzerinden yapmanı sağlar: bir ya link ekler, kartları tek çerçevede toplar, tahtanın özetini okur, tahtaya sorar.

Aynı hesap, aynı tahtalar, aynı ; 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.

API ücretli planlarda açık. Gereken tek şey ücretli bir Nailing planı ve «API ve Claude» sayfasından ürettiğin bir ; 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ı

  1. Anahtarı üret

    «API ve Claude» → API anahtarları → “Yeni anahtar”. (/gelistirici)

    Anahtar bir kez gösterilir; o ekranı kapattığında bir daha görünmez. Kaybedersen “İptal et” ile kapatıp yenisini üret.

  2. 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.

    Kabuk hazırlığı
    bash
    export NAILING_API_KEY='nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
    AUTH="Authorization: Bearer $NAILING_API_KEY"
    BASE=https://app.nailingai.co
  3. Bir tahta aç

    Anahtarın çalıştığını kanıtlayan en kısa çağrı: POST /api/boards.

    Dönen data.id bundan sonraki her isteğin tahta kimliği.

    POST /api/boards
    bash
    curl -sS -X POST "$BASE/api/boards" \
      -H "$AUTH" -H 'Content-Type: application/json' \
      -d '{"name":"İlk tahtam","nodes":[],"edges":[]}'
  4. Cevabı oku

    success: true geldiyse anahtar çalışıyor. 401 geldiyse anahtar yanlış, eksik ya da iptal edilmiş; yeniden denemek yerine «API ve Claude» sayfasından kontrol et.

    Cevap
    json
    { "success": true, "data": { "id": "8f1c…-…-…", "name": "İlk tahtam" } }
  5. 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}/nodes
    bash
    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 Authorization başlığında durur. Adres satırına, sorgu parametresine, ekran görüntüsüne, log’a yazma.
  • Biçimi nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx gibidir — nk_ ön eki, sızan bir anahtarı log’da aranabilir kılmak için var.

Bölüm 03

Dört kapı

Uç noktaNe yaparKredi
POST /api/boards/{id}/nodesLinkleri karta çevirir, transkripti kuyruğa alırücretsiz
POST /api/boards/{id}/groupsKartları tek çerçevede toplarücretsiz
GET /api/boards/{id}/summaryTahtayı ve transkript durumunu okurücretsiz
POST /api/boards/{id}/askTahtaya sorar, deste planını da buradan istersinharcar

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