Ana içeriğe geç

JSON Path Extractor

JSON Path Extractor, bir yol (path) ifadesi kullanarak bir JSON payload'ından tek bir değeri çeker. Bir HTTP Requests aracı veya JSON döndüren herhangi bir adım için mükemmel bir takip aracıdır: tüm yanıtı bir sonraki node'a vermek yerine yalnızca ihtiyacınız olan alanı çıkarırsınız.

Bir akışa ekleme​

Araç node'unun araç seçicisinde JSON Path Extractor'ı seçin, ardından istediğiniz değere giden yolu ayarlayın.

Girdiler​

ParametreAçıklamaZorunlu
JSON PathÇıkarılacak değere giden yol. Örnekler: data, user.name, items[0].id.Evet
Return Null on ErrorYol bulunamadığında hata fırlatmak yerine null döndür.Hayır

Çıkarım yapılacak JSON, araç çalışırken iletilir — genellikle önceki bir adımın çıktısı. Bir JSON dizesi ya da halihazırda ayrıştırılmış bir nesne/dizi olabilir.

Yol söz dizimi​

Yollar basit nokta ve köşeli parantez gösterimi kullanır:

  • data → en üst seviyedeki data alanı
  • user.name → user nesnesinin içindeki name
  • items[0].id → items dizisindeki ilk öğenin id'si
  • results[2].address.city → iç içe nesneler ve diziler birlikte

Çıktılar​

Araç, çıkarılan değeri (metin olarak) döndürür. Tek çıktılı bir araçtır — akış bir sonraki node'a devam eder. Sonraki bir adımın ihtiyacı olacaksa değeri flow state'e kaydedin.

Yol bulunamazsa araç varsayılan olarak bir hata fırlatır — bunun yerine null almak için Return Null on Error'ı açın; bu, bir alanın bazen eksik olduğu durumlarda kullanışlıdır.

Örnek​

Bir API yanıtından sipariş durumunu almak

  1. Bir Requests Get aracı {"order": {"id": 42, "status": "shipped"}} döndürür.
  2. JSON Path Extractor içeren bir Araç node ekleyin ve JSON Path'i order.status olarak ayarlayın.
  3. Araç shipped döndürür; yanıtta veya bir koşulda kullanmaya hazırdır.

İpuçları​

  • Dizi indekslerini dikkatle kontrol edin — items[0] ilk öğedir; aralık dışı bir indeks bulunamaz.
  • İsteğe bağlı alanlar için Return Null on Error'ı açın; böylece eksik bir değer akışı durdurmaz.
  • HTTP araçlarından sonra zincirleyin; büyük JSON'ı dolaştırmak yerine yalnızca ihtiyacınız olan alanı tutun.

İlgili​