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:
- Tenor'ın arama uç noktası, artık
searchfilter
parametresi aracılığıyla çıkartma aramayı destekliyor. - API çağrılarında
client_key
vecountry
parametrelerini ekleyin. media_filter
parametresi, önceden ayarlanmış enum yerine artık istenen biçimlerin virgülle ayrılmış listesini alır.- Kategoriler uç noktası,
type
parametresi için artıkfeatured
vetrending
özelliklerini destekliyor. - API artık
anon_id
parametresini desteklemiyor. - İ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ı:
- Trend uç noktası artık desteklenmiyor. Bunun yerine Öne çıkan uç nokta özelliğini kullanmanızı öneririz.
- GIF uç noktası, Gönderi uç noktası olarak yeniden adlandırıldı.
- 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.