API'de «geçersiz bağlantı» hatası: sipariş oluşturmadan önce URL kontrolü

API'de «geçersiz bağlantı» hatası ne anlama gelir

«Geçersiz bağlantı» hatası, API'nin siparişin hedef alanındaki URL'yi kabul edemediği anlamına gelir. Bu her zaman adreste bir yazım hatası değildir. Hizmet, bağlantıyı uygun olmayan biçim, sayfa türü, yönlendirme, erişim kısıtlamaları, kodlama veya platform ile hizmetin uyuşmaması nedeniyle reddedebilir.

Kontrol genellikle sipariş oluşturulmadan önce yapılır. API URL'yi alır, alan adını ve yolu belirler, nesneyi tanımaya çalışır: kanal, video, yayın, gönderi veya profil. Aşamalardan biri geçmezse sipariş oluşturulmaz. Genel hata metni tek başına nedeni göstermez — URL'ye, hizmet parametrelerine ve API'nin tam yanıtına bakmak gerekir.

Hata metnini API yanıtıyla eşleştirin

Farklı API'lerde yanıtın ifadesi ve yapısı değişir. Bazen hizmet yalnızca bir mesaj döndürür, bazen kod, alan adı veya istek kimliği ekler. Tam yanıt HTTP durumundan daha faydalıdır: istek başarıyla iletildiğinde bile API, iş kuralı kontrolü düzeyinde siparişin kendisini reddedebilir.

Örneğin tipik bir yanıt şöyle görünebilir: {"error":"invalid_link","message":"Invalid target URL","field":"link"}. Burada özellikle link alanının değeri kontrol edilmelidir. {"error":"target_not_supported"} varyantı ise çoğunlukla bozuk bir adresi değil, desteklenmeyen bir nesne türünü gösterir. Alan adları ve kodlar ilgili belgelere bağlıdır.

Yanıt durumunu, yanıt gövdesini, hizmet kimliğini ve API döndürüyorsa request_id'yi saklayın. Talebe erişim belirteci, cookie, istek imzaları ve bağlantının özel parametrelerini eklemeyin.

URL biçimini ve istek alanının değerini kontrol edin

Tarayıcıda çalışan bir bağlantı makine kontrolünden geçmeyebilir. Alana bazen yalnızca video kimliği, alan adı olmayan kullanıcı adı, mesajdan alınan metin veya kısaltılmış adres girer. URL dize olarak değil de iç içe nesne veya dizi olarak iletildiğinde de hata oluşur.

• https:// protokolüyle birlikte tam genel URL'yi iletin.
• Alan adını kontrol edin: seçilen hizmetin platformuna ait olmalıdır.
• Baştaki ve sondaki boşlukları, satır sonlarını, emojileri ve bağlantıdan sonraki metni kaldırın.
• Alan adını API belgeleriyle karşılaştırın: link, url, target veya başka bir ad.
• İstekte URL içeren bir nesne değil, dize değeri iletildiğinden emin olun.

Adresi elle yapıştırmak kolaydır, ancak bir dezavantajı vardır: dizeye kolayca görünmez bir karakter veya gönderi açıklamasından bir parça girebilir. Göndermeden önce değeri temizleyin, ancak yolun kendisini ve parametreleri gereksiz yere değiştirmeyin.

Kısa bağlantıları açın ve gereksiz yönlendirmeleri kaldırın

Kısaltılmış adresler ve «Paylaş» düğmesinden alınan bağlantılar genellikle bir veya birkaç yönlendirmeden geçer. Tarayıcı bunları otomatik olarak açar, ancak tanıtım hizmetinin API'si yönlendirmeleri izlemeyebilir, bunları engelleyebilir veya arada bir yetkilendirme sayfasıyla karşılaşabilir.

Sipariş için kanonik adresi kullanmak daha iyidir: gerekli sayfa tamamen yüklendikten sonra adres çubuğunda görünen adres. Kampanya etiketleri ve görüntüleme süresi parametreleri her zaman engel olmayabilir, ancak parametreler sayfanın farklı bir görünümüne yol açabilir veya nesnenin tanınmasını etkileyebilir.

Kanonik URL'nin bir dezavantajı vardır: özellikle mobil uygulamadan bağlantı kopyalandıktan sonra bazen ayrıca alınması gerekir. Ancak bu tür bir adresi elle kontrol etmek ve hizmet kurallarıyla karşılaştırmak daha kolaydır.

Hizmetin kabul ettiği nesneye bağlantı seçin

Hizmet yalnızca tek bir hedef türünü kabul edebilir. Kanal için verilen sipariş, yayın kaydına bağlantıyı kabul etmez; video görüntüleme hizmeti ise yazar profilini kabul etmez. Görünüşte her iki URL de doğrudur, ancak API adres yapısını hizmetin amacıyla karşılaştırır ve uygun olmayan nesneyi reddeder.

Hizmet kataloğunu kontrol edin: platform, kategori, izin verilen target_type ve kısıtlamalar. API ayrı bir hedef türü parametresi gerektiriyorsa, bu parametre URL ile eşleşmelidir. İçerik adresini arama, hashtag, derleme, ana sayfa veya yazar paneli bağlantısıyla değiştirmeyin.

• Kanal tanıtımı için kanal sayfasını iletin.
• Görüntülemeler için belirli bir videoya veya gönderiye bağlantı kullanın.
• Aktif yayın için hizmet live biçimini destekliyorsa yayın URL'sini iletin.
• Tepkiler ve gönderiyle ilgili diğer işlemler için gönderiye doğrudan bağlantı kullanın.

Gizliliği, yaş filtrelerini ve oturum açma gereksinimini kontrol edin

API yalnızca URL'nin biçimini değil, hedefin erişilebilirliğini de kontrol eder. İçerik, kanal sahibinde açılabilir çünkü tarayıcısı yetkilendirilmiştir, ancak harici bir kontrol sunucusu için erişilemez olabilir. Bu durumda hizmet sıklıkla geçersiz bağlantıyla ilgili genel bir hata döndürür.

• Profilin, kanalın, gönderinin veya yayının kendisinin kapalı olup olmadığını kontrol edin.
• Videonun silinmediğinden, taslaklara taşınmadığından ve başka bir gönderiyle değiştirilmediğinden emin olun.
• Yaş kısıtlamasını kontrol edin: yaş doğrulaması veya hesaba giriş gerektirebilir.
• Yalnızca aboneler, üyeler veya onaylanmış izleyiciler için erişim modu açıksa bunu kapatın.
• Sayfanın giriş formu, içerik uyarısı veya teknik bir yer tutucu göstermediğinden emin olun.

Bağlantıyı yetkilendirme olmadan gizli pencerede açın. Hedef sayfa yerine oturum açma isteği görünüyorsa erişim ayarlarını değiştirin veya bu tür bir hedef türüne izin veren bir hizmet varsa onu seçin. Gizli pencerede kontrolün bir dezavantajı vardır — bölgesel ve ağ kısıtlamalarını her zaman ortaya çıkarmaz.

Bölgesel, mobil ve gömülü adresleri göz önünde bulundurun

Aynı nesnenin masaüstü, mobil, yerelleştirilmiş ve gömülü URL'si olabilir. Uygulamadan veya webview'den alınan adres bazen API'nin tanımadığı teknik bölümler içerir. Yerelleştirilmiş sayfa da kontrol sunucusu için farklı açılabilir.

Kopyalanan bağlantıyı normal bir tarayıcıda açın ve tamamen yüklenmesini bekleyin. İstek için adres çubuğundaki genel web adresini kullanın. İçerik bölgeye göre kısıtlıysa, platform ayarları izin veriyorsa kısıtlamayı kaldırın veya genel erişim gerektiren bir hizmete böyle bir hedef göndermeyin.

Yetkilendirme ve ara ekranlar olmadan genel bir web bağlantısı, API kontrolü için en güvenilir seçenektir.

İstek gönderilirken URL'nin bozulmasını önleyin

Bağlantı gönderilmeden önce doğru olabilir, ancak JSON serileştirme, query parametrelerinin oluşturulması, form-data gönderimi veya yeniden kodlama sırasında değişebilir. &, ?, # ve % karakterleri özellikle hassastır. Örneğin, adres gerekli kodlama olmadan iletildiğinde URL'deki ve işareti isteğin kendi parametre ayırıcısı haline gelebilir.

• Orijinal URL'yi gerçek HTTP isteğindeki değerle karşılaştırın.
• İstek gövdesini istemci günlüklerinde, proxy'de veya geliştirici araçlarında kontrol edin.
• JSON için dizeyi elle oluşturmak yerine standart serileştirme kullanın.
• Kütüphane bunu otomatik yapıyorsa URL'yi iki kez kodlamayın.
• Yolda ve adres parametrelerinde Kiril alfabesinin işlenmesini kontrol edin.

Günlükler tutarsızlığı hızlıca bulmaya yardımcı olur, ancak bir dezavantajları vardır: içlerine API anahtarları, belirteçler ve kişisel veriler girebilir. Hassas değerleri kaydetmeden ve günlükleri iletmeden önce maskeleyin.

Platformu, hizmet kimliğini ve sipariş parametrelerini karşılaştırın

Bazı API'ler önce hizmeti, ardından alan adını ve bağlantı türünü kontrol eder. Başka bir platformun URL'si, eski bir service_id veya yanlış target_type aynı «geçersiz bağlantı» hatasına yol açabilir. Bu durumda sipariş parametreleri düzeltilene kadar adresin kendisini değiştirmek işe yaramaz.

API'de böyle bir yöntem varsa hizmet kataloğunu API üzerinden güncelleyin. Eski listeyi içeren önbellek, devre dışı bırakılmış bir hizmeti veya önceki gereksinimlerini saklayabilir. Kataloğun sık güncellenmesinin bir dezavantajı vardır: istek sayısını artırır ve hız sınırına takılabilir. Sınırlı saklama süresi olan bir önbellek kullanın ve doğrulama hatalarından sonra güncelleyin.

Yeniden göndermeden önce bağlantıyı sırayla kontrol edin

1. Tam URL'yi metin, boşluk ve gizli karakterler olmadan kopyalayın.
2. Hesaba giriş yapmadan gizli pencerede açın.
3. Sayfanın kapalı, silinmiş veya oturum açma gerektirmediğini kontrol edin.
4. Yaş, abonelik veya bölgesel kısıtlama olmadığından emin olun.
5. Kısa bağlantıyı nihai genel adrese kadar açın.
6. URL'deki nesneyi hizmetle eşleştirin: kanal, video, yayın veya gönderi.
7. Platformu, service_id ve target_type'ı güncel hizmet kataloğuyla karşılaştırın.
8. Gerçek HTTP istek gövdesini ve URL kodlamasını kontrol edin.
9. API'nin tam yanıtını ve istek kimliğini belirteçler ve özel veriler olmadan saklayın.

Bu kontrollerden sonra hata devam ederse, desteğe bağlantıyı temizlenmiş biçimde, hizmet kimliğini, istek zamanını, HTTP durumunu ve API yanıtının tam metnini iletin. Bu, URL sorununu belirli bir hizmetin kısıtlamasından veya hizmet tarafındaki kontrol arızasından ayırmayı sağlar.