Tenor'ın V1 API'sinden geçiş yapma

Tenor'ın V1 API'sini kullanan mevcut entegrasyonlar için bu sayfadaki adımları uygulayarak V2'ye geçin.

V2 API anahtarı alma

V1 sürümünüzün yerini alacak bir V2 API anahtarı almak için hızlı başlangıç kılavuzunun kurulum adımındaki talimatları uygulayın.

V2 alanlarında güncelleme

API alanınızı https://tenor.googleapis.com/v2/ olarak güncelleyin. Tenor'ın V2 API'si yalnızca HTTPS bağlantılarını destekler. İçeriklerde, uygulamanızın https://media.tenor.com ve https://c.tenor.com hizmetlerinden yapılan içerik indirme işlemlerini desteklediğinden emin olun.

Örneğin, aşağıdaki V1 alanlarından birine API çağrısı yaptığınızı varsayalım:

  • https://api.tenor.com/v1/search?<parameters>
  • https://g.tenor.com/v1/search?<parameters>

V2'ye yapılan çağrıları güncellemek için bunları https://tenor.googleapis.com/v2/search?<parameters> olarak değiştirin.

Uç nokta değişiklikleri

API uç noktası parametrelerinin çoğu V1'de açıklananlardan farklı değildir. Bazı önemli istisnalar vardır:

  1. Tenor'ın arama uç noktası, artık searchfilter parametresi aracılığıyla çıkartma aramayı destekliyor.
  2. API çağrılarında client_key ve country parametrelerini ekleyin.
  3. media_filter parametresi, önceden ayarlanmış enum yerine artık istenen biçimlerin virgülle ayrılmış listesini alır.
  4. Kategoriler uç noktası, type parametresi için artık featured ve trending özelliklerini destekliyor.
  5. API artık anon_id parametresini desteklemiyor.
  6. İstenecek sonuç sayfası olmadığında API yanıtlarının next alanı artık "0" yerine boş bir dize olur.

Mevcut uç noktalarda aşağıdaki değişiklikler yapıldı:

  1. Trend uç noktası artık desteklenmiyor. Bunun yerine Öne çıkan uç nokta özelliğini kullanmanızı öneririz.
  2. GIF uç noktası, Gönderi uç noktası olarak yeniden adlandırıldı.
  3. Rastgele GIF uç noktası, random parametresi aracılığıyla Arama uç noktasına dahil edildi.

Yanıt nesnesi ve hata değişiklikleri

  • GIF Nesnesi, Yanıt Nesnesi olarak yeniden adlandırıldı.
  • Yanıt Nesnesi'nde media alanının adı media_formats olarak değiştirildi. media_formats değeri, artık bir harita dizisi değil, { CONTENT_FORMAT : MEDIA_OBJECT } haritasıdır.
  • İçerik küçük resim önizlemeleri, her içerik biçimi için Medya Nesnesi'nden kendi biçimine taşınmıştır. Bunlar, Yanıt Nesnesi'ndeki media_formats alanının altında sunulur.
  • Bir yanıt nesnesinde başka sonuç olmadığında next alanı "0" yerine boş bir dizedir ("").
  • Tenor API hata kodları Google'ın standart API hata kodlarına taşınmıştır.