Cara bermigrasi dari V1 API Tenor

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:

  1. Endpoint Penelusuran Tenor kini mendukung penelusuran stiker melalui parameter searchfilter.
  2. Sertakan parameter client_key dan country pada panggilan API.
  3. Parameter media_filter kini menggunakan daftar format yang diinginkan, yang dipisahkan koma, dan bukan enum standar.
  4. Endpoint kategori kini mendukung featured dan trending untuk parameter type.
  5. API tidak lagi mendukung parameter anon_id.
  6. 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:

  1. Endpoint Trending tidak lagi didukung. Sebagai gantinya, sebaiknya gunakan endpoint Unggulan.
  2. Endpoint GIF telah diganti namanya sebagai Endpoint Postingan.
  3. 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 menjadi media_formats. Nilai untuk media_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.