Cara bermigrasi dari Tenor API V1

Untuk integrasi yang sudah ada yang menggunakan Tenor API V1, ikuti langkah-langkah di halaman ini untuk bermigrasi ke V2.

Mendapatkan kunci API V2

Ikuti petunjuk di langkah penyiapan dalam panduan memulai cepat untuk mendapatkan kunci API V2 guna menggantikan versi V1 Anda.

Memperbarui domain V2

Perbarui domain API Anda ke https://tenor.googleapis.com/v2/. API V2 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 tersebut menjadi 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. Search endpoint 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, bukan enum preset.
  4. Endpoint Kategori sekarang mendukung featured dan trending untuk parameter type.
  5. API tidak lagi mendukung parameter anon_id.
  6. Jika tidak ada lagi halaman hasil yang dapat diminta, kolom next pada respons API kini berupa 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 diubah mereknya menjadi Endpoint postingan.
  3. Endpoint GIF Acak telah dimasukkan ke dalam endpoint Penelusuran melalui parameter random.

Perubahan objek respons dan error

  • Objek GIF telah diubah mereknya menjadi Objek Respons.
  • Dalam Objek Respons, kolom media telah diubah namanya menjadi media_formats. Nilai untuk media_formats sekarang berupa peta { CONTENT_FORMAT : MEDIA_OBJECT }, bukan array peta.
  • Pratinjau thumbnail konten telah dipindahkan dari Objek Media untuk setiap format konten ke formatnya sendiri. Penawaran ini diberikan di kolom media_formats dalam Objek Respons .
  • 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.