Tenor'un V1 API'sinden nasıl geçiş yapılır?

Tenor'un V1 API'sini kullanan mevcut entegrasyonlarda V2'ye geçmek için bu sayfadaki adımları uygulayın.

V2 API anahtarı alma

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

V2 alanlarına güncelleme

API alanınızı https://tenor.googleapis.com/v2/ olarak güncelleyin. Tenor'un V2 API'si yalnızca HTTPS bağlantılarını destekler. İçerik için uygulamanızın https://media.tenor.com ve https://c.tenor.com kaynaklarından içerik indirmeyi 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 belgelenenlerle aynıdır. Birkaç önemli istisna vardır:

  1. Tenor'un Arama uç noktası artık searchfilter parametresi aracılığıyla çıkartma aramayı destekliyor.
  2. API çağrılarına client_key ve country parametrelerini ekleyin.
  3. media_filter parametresi artık önceden ayarlanmış numaralandırılmış değerler yerine istenen biçimlerin virgülle ayrılmış listesini alır.
  4. Kategoriler uç noktası artık type parametresi için featured ve trending değerlerini destekliyor.
  5. API artık anon_id parametresini desteklemiyor.
  6. İstenilecek başka sonuç sayfası kalmadığında API yanıtlarının next alanı artık "0" yerine boş bir dize oluyor.

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

  1. Trending uç noktası artık desteklenmiyor. Bunun yerine Öne çıkarılan uç nokta'yı kullanmanızı öneririz.
  2. GIF uç noktası, Gönderiler uç noktası olarak yeniden markalandı.
  3. Random GIF uç noktası, random parametresi aracılığıyla Search uç noktasına dahil edildi.

Yanıt nesnesi ve hata değişiklikleri

  • GIF Nesnesi, Yanıt Nesnesi olarak yeniden markalandı.
  • Yanıt Nesnesi'nde media alanı media_formats olarak yeniden markalandı. media_formats değeri artık harita dizisi yerine { CONTENT_FORMAT : MEDIA_OBJECT } haritası olarak kullanılıyor.
  • İçerik küçük resim önizlemeleri, her içerik biçimi için Medya Nesnesi'nden kendi biçimine taşındı. Bunlar, Response Object'teki media_formats alanı altında sunulur.
  • Bir yanıt nesnesinde başka sonuç kalmadığında next alanı "0" yerine boş bir dize, "" olur.
  • Tenor API hata kodları, Google'ın standart API hata kodlarına taşındı.