Untuk integrasi saat ini yang menggunakan API V1 Tenor, ikuti langkah-langkah di halaman ini untuk bermigrasi ke V2.
Mendapatkan kunci API V2
Ikuti petunjuk di langkah penyiapan panduan memulai untuk mendapatkan kunci API V2 guna mengganti versi V1 Anda.
Perbarui ke domain V2
Update domain API Anda menjadi https://tenor.googleapis.com/v2/
. V2 API Tenor hanya mendukung koneksi HTTPS. Untuk konten, pastikan aplikasi Anda mendukung download konten dari
https://media.tenor.com
dan https://c.tenor.com
.
Misalnya, Anda melakukan panggilan API ke salah satu domain V1 berikut:
https://api.tenor.com/v1/search?<parameters>
https://g.tenor.com/v1/search?<parameters>
Untuk memperbarui panggilan ke V2, ubah panggilan ke
https://tenor.googleapis.com/v2/search?<parameters>
.
Perubahan endpoint
Sebagian besar parameter endpoint API tidak berubah dari yang didokumentasikan di V1. Ada beberapa pengecualian penting:
- Endpoint Penelusuran Tenor
kini mendukung penelusuran stiker melalui
parameter
searchfilter
. - Sertakan parameter
client_key
dancountry
pada panggilan API. - Parameter
media_filter
kini menggunakan daftar format yang diinginkan, yang dipisahkan koma, dan bukan enum standar. - Endpoint kategori kini
mendukung
featured
dantrending
untuk parametertype
. - API tidak lagi mendukung parameter
anon_id
. - Jika tidak ada lagi halaman hasil yang diminta, kolom
next
respons API kini menjadi string kosong, bukan"0"
.
Perubahan berikut telah dilakukan pada endpoint yang tersedia:
- Endpoint Trending tidak lagi didukung. Sebagai gantinya, sebaiknya gunakan endpoint Unggulan.
- Endpoint GIF telah diganti namanya sebagai Endpoint Postingan.
- Endpoint Random GIF telah disertakan ke dalam
endpoint Penelusuran melalui
parameter
random
.
Objek respons dan perubahan error
- Objek GIF telah diganti namanya menjadi Response Object.
- Dalam
Response
Object, kolom
media
telah diganti namanya menjadimedia_formats
. Nilai untukmedia_formats
sekarang adalah peta{ CONTENT_FORMAT : MEDIA_OBJECT }
, bukan array peta. - Pratinjau thumbnail konten telah dipindahkan dari
Media Object
untuk setiap
format
konten ke formatnya sendiri. Izin tersebut ditawarkan di bawah kolom
media_formats
di Object Response. - Jika tidak ada lagi hasil dalam objek respons, kolom
next
adalah string kosong,""
, bukan"0"
. - Kode error Tenor API telah dimigrasikan ke kode error API standar Google.