Nailing HubAPI · POWER USERS
BölümlerAraçla kur

Kur

Araçla kur

n8n, Zapier ve Make için aynı HTTP isteğinin tam ayarı: yöntem, adres, başlık, gövde ve cevapta ne gelir.

Bölüm 01

Üçünde de aynı olan

Hangi aracı kullanırsan kullan, kurduğun şey tek bir HTTP isteği: POST ya da GET, bir adres, iki başlık, bir JSON gövde.

adımın içine yazılmaz; aracın kendi kimlik/gizli-değer deposuna koy ve oradan referans ver. Üç aracın üçünde de bu var.

AlanDeğer
YöntemPOST (okuma için GET)
Adreshttps://app.nailingai.co/api/boards/<tahta-id>/nodes
Başlık 1Authorization: Bearer nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Başlık 2Content-Type: application/json
Gövde{"urls":["https://…"]}
Cevap{"success":true,"data":{"boardId":"…","nodes":[…]}}

Bölüm 02

n8n

**HTTP Request** düğümü. Kimlik için ayrı bir kimlik bilgisi oluştur, adımın içine anahtar yazma.

  1. Kimlik bilgisini bir kez oluştur

    Credentials → New → **Header Auth**.

    Name alanına Authorization, Value alanına Bearer + anahtarın. Ona “Nailing API” gibi bir ad ver; bundan sonraki her düğüm bunu seçer.

  2. HTTP Request düğümünü ayarla

    Method: POST · Authentication: Generic Credential Type → Header Auth → az önce oluşturduğun kimlik.

    Send Body: açık · Body Content Type: JSON · Specify Body: Using JSON.

    URL alanı (n8n ifadesiyle)
    text
    https://app.nailingai.co/api/boards/{{ $json.boardId }}/nodes

  3. Gövdeyi yaz

    JSON alanına bu gider. Sabit bir liste de olabilir, önceki düğümden gelen bir ifade de.

    JSON alanı
    json
    {
  "urls": [
    "https://www.instagram.com/reel/DA1b2C3d4E/",
    "https://www.tiktok.com/@kullanici/video/7412345678901234567"
  ]
}

  4. Cevabı oku

    Sonraki düğümde {{ $json.data.nodes }} eklenen kartların dizisidir.

    kimliğini bir sonraki adıma taşımak için {{ $json.data.boardId }}.

  5. Transkript bekleyecekse döngü kur

    Okuma düğümü: Method GET, adres https://app.nailingai.co/api/boards/{{ $json.data.boardId }}/summary, aynı kimlik.

    Araya bir **Wait** düğümü koy (15 saniye) ve bir **IF** ile data.nodes içindeki her transcript alanı ready olana kadar dön. Döngüye bir tavan koymayı unutma.

  • n8n’in HTTP Request düğümü varsayılan olarak 4xx/5xx’te akışı durdurur.
  • Hata cevabını okuyup karar vermek istiyorsan Settings → On Error → Continue (using error output) seç; error.message neyin yanlış olduğunu Türkçe söyler.

Bölüm 03

Zapier

**Webhooks by Zapier** → **Custom Request**. Zapier’in “POST” eylemi başlıkları da taşır ama gövdeyi düzleştirir; JSON gövdesini olduğu gibi göndermek için Custom Request daha güvenli.

  1. Eylemi seç

    Action → **Webhooks by Zapier** → Event: **Custom Request**.

  2. Alanları doldur

    Method: POST · Data Pass-Through?: false · Unflatten: no.

    URL alanı
    text
    https://app.nailingai.co/api/boards/BOARD_ID/nodes

  3. Başlıkları ekle

    Headers bölümünde iki satır. Anahtarı Zapier’in Storage/Secret alanından çekiyorsan değeri oradan referansla.

    Headers
    text
    Authorization: Bearer nk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

  4. Gövdeyi yaz

    Data alanına ham JSON olarak bu gider.

    Data alanı
    json
    {"urls":["https://www.instagram.com/reel/DA1b2C3d4E/"]}

  5. Cevabı oku

    Zapier cevabı ayrıştırır: sonraki adımlarda data__boardId ve data__nodes[]… olarak görünür.

    Tahtaya sormak istiyorsan ikinci bir Custom Request adımı ekle, adresi /ask yap ve gövdeye {"question":"…","groupId":"…"} koy.

Zapier’in zaman aşımı

  • ask çağrısı dakikalar sürebilir; Zapier bir adımı o kadar bekletmez.
  • Uzun süren işler için akışı ikiye böl: birinci Zap çağrıyı başlatsın, ikincisi (zamanlanmış) GET /api/boards/{id}/summary ile sonucu toplasın.

Bölüm 05

Make

**HTTP** → **Make a request** modülü.

  1. Modülü ekle

    HTTP → **Make a request**. Method: POST.

    URL alanı
    text
    https://app.nailingai.co/api/boards/{{1.boardId}}/nodes

  2. Başlıkları ekle

    Headers → Add item, iki kez. Birincisi Name: Authorization, Value: Bearer …; ikincisi Name: Content-Type, Value: application/json.

    Anahtarı bir **Data store** ya da senaryo değişkeninde tut.

  3. Gövdeyi ayarla

    Body type: **Raw** · Content type: **JSON (application/json)**.

    Request content
    json
    {"urls":["https://www.instagram.com/reel/DA1b2C3d4E/"]}

  4. Cevabı ayrıştır

    Parse response seçeneğini aç. Sonraki modüllerde data.boardId ve data.nodes[] haritalanabilir hâle gelir.

    Kapalı bırakırsan cevap düz metin gelir ve elle ayrıştırman gerekir.

  5. Yoklama için tekrarlayıcı kur

    Transkript bekleyeceksen: **Repeater** → HTTP GET https://app.nailingai.co/api/boards/{{1.boardId}}/summary → **Sleep** 15 saniye → **Router** ile hepsi ready olduğunda çık.

    Tekrar sayısına tavan koy.

Üçü için de geçerli

  • Anahtarı adresin içine koyma. Üç araç da adresi log’luyor, üçünde de paylaşılan bir senaryo/Zap görüntüsü o satırı taşıyor.
  • Başlık alanı tam olarak bunun için var.