Endpoint'ler

Endpoint, bir akışın yapabileceği tek bir API çağrısıdır. Endpoint'leri Autopilot > Endpoint'ler sayfasında kaydedersiniz; Akışlar sayfasındaki bir İstek adımı bunlardan birini seçip girdilerini doldurur.

Başlamadan önce

• Kataloğu yalnızca yöneticiler değiştirebilir. Üyeler listeyi görür.
• Kendi API'nizdeki bir endpoint için o domain Domainler sayfasında doğrulanmış olmalıdır. Aksi hâlde endpoint ziyaretçinin bulunduğu siteyi hedefler.
• Çağrı ziyaretçinin kendi çerezleriyle gider. API'niz bunun yerine bir bearer token bekliyorsa Referans sayfasındaki requestHeaders seçeneğini ayarlayın.

Kurulum

Endpoint ekle pencereyi açar.

• Ad, İstek adımının listelediği addır.
• Metot GET, POST, PUT, PATCH ya da DELETE olabilir.
• Domain, doğrulanmış bir domain ya da Sayfanın kendi domaini, yani ziyaretçinin bulunduğu sitedir.
• Yol, sabit / işaretinden sonra gelen kısımdır. Öznitelik ekle bir girdi, {{ lead_id }}, ya da bir ziyaretçi özniteliği, {{ user.plan }}, yerleştirir; öznitelik akış çalışırken doldurulur. Akıştan gelen bir yanıt yola yalnızca İstek adımında bağlanan bir girdiyle ulaşır.
• Girdiler, en fazla 20, İstek adımının sağladığı değerlerdir: bir Ad, bir Tür (Metin, Sayı, Tarih ve saat ya da Doğru ya da yanlış) ve bir Zorunlu işareti.
• Gövde şablonu POST, PUT ve PATCH için görünür: girdinin tırnaksız, {"email": {{ email }}}, özniteliğin tırnak içinde, {"plan": "{{ user.plan }}"}, yazıldığı JSON. Biçimlendir düzenli biçimde yeniden yazar.
• Yanıt alanları, en fazla 20, JSON yanıttan çalıştırmaya okunan değerlerdir: bir Ad ve data.id gibi bir Yanıttaki yol.

Adlar küçük harf, rakam ve alt çizgiden oluşur, harfle başlar ve her biri bir kez kullanılır; user ve answers ayrılmıştır. Tırnaksız her yer tutucu bir girdiyi adlandırmalıdır.

OpenAPI'den içe aktar, JSON ya da YAML biçiminde, en fazla 2 MB bir OpenAPI 3 dosyasını Dosya URL'si ile ya da Dosya yükle ile okur. Rotaları yükle, dosyadaki her GET, POST, PUT, PATCH ve DELETE işlemini listeler; diğer metotlar atlanır. Bir akışın çağırabileceği rotaları işaretleyin ve Domain seçin; doğrulanmış bir domainle eşleşen sunucu önceden seçilir. Yol parametreleri ve zorunlu sorgu parametreleri girdi olur, gövdenin ilk seviyedeki metin, sayı ve doğru-yanlış alanları hem girdi hem gövde şablonu olur, ilk başarılı yanıtın alanları bir seviye derinliğe kadar yanıt alanı olur. Aynı metot ve yola sahip bir endpoint güncellenir, adı korunur. Hiçbir şey silinmez.

Satırdaki gönder simgesi Deneme çağrısı gönder penceresini açar. Girdileri doldurun, endpoint'in okuduğu her öznitelik için bir değer yazın (burada ziyaretçi yoktur), endpoint sayfanın kendi domainini hedefliyorsa bir domain seçin ve gönderin. Çağrı tarayıcınızdan kendi oturumunuzla çıkar, ARCY üzerinden geçmez. HTTP durum kodunu, geçen süreyi ve her yanıt alanının değerini görürsünüz.

Neyi değiştirir

• İstek adımı çağrıyı ziyaretçinin tarayıcısından, ziyaretçinin oturumuyla gönderir. Nabız sayfasına yalnızca sonuç ve HTTP durum kodu ulaşır.
• Bir endpoint'i düzenlemek ya da yeniden içe aktarmak, onu kullanan her adımı değiştirir.
• Kullanan sütunu endpoint'i çağıran akışları adıyla gösterir. Biri bile varken silme reddedilir.

Sorun çıktığında

Silme devre dışı. İpucu, endpoint'i hâlâ çağıran akışları adıyla listeler. İstek adımlarını kaldırın, sonra silin.

Deneme çağrısı HTTP 401 döndü. API'niz çerez oturumunu kabul etmedi. Pencere, ekleyeceğiniz requestHeaders kod parçasını gösterir.

Deneme çağrısı sunucuya ulaşmadı. Tarayıcınız çağrıyı engelledi. API'nizin CORS kurallarında bu panelin domainine, kimlik bilgileriyle birlikte izin verin. Kendi sitenizdeki ziyaretçiler bundan etkilenmez.

Bir yanıt alanı sonuçta yok. Yanıttaki yol değeri, API'nizin döndürdüğü JSON ile eşleşmiyor.

İçe aktarma başarısız. Dosya geçerli JSON ya da YAML değil, Swagger 2.0 biçiminde ya da paths bölümü yok. OpenAPI 3 belgesi olarak dışa aktarın.

Ayrıca bakın

• Akışlar
• Domainler
• Referans