Cách di chuyển từ API phiên bản 1 của Tenor

Đối với những tiện ích tích hợp hiện có sử dụng API phiên bản 1 của Tenor, hãy làm theo các bước trên trang này để di chuyển sang phiên bản 2.

Lấy khoá API phiên bản 2

Làm theo hướng dẫn trong bước thiết lập của hướng dẫn bắt đầu nhanh để lấy khoá API phiên bản 2 thay cho phiên bản 1.

Cập nhật lên miền V2

Cập nhật miền API thành https://tenor.googleapis.com/v2/. API V2 của Tenor chỉ hỗ trợ các kết nối HTTPS. Đối với nội dung, hãy đảm bảo ứng dụng của bạn hỗ trợ tải nội dung xuống từ https://media.tenor.com và https://c.tenor.com.

Ví dụ: giả sử bạn đã thực hiện một lệnh gọi API đến một trong các miền V1 sau:

  • https://api.tenor.com/v1/search?<parameters>
  • https://g.tenor.com/v1/search?<parameters>

Để cập nhật các lệnh gọi thành V2, hãy thay đổi các lệnh gọi đó thành https://tenor.googleapis.com/v2/search?<parameters>.

Thay đổi về điểm cuối

Phần lớn các tham số điểm cuối API không thay đổi so với những gì được ghi lại trong phiên bản 1. Có một vài trường hợp ngoại lệ đáng chú ý:

  1. Điểm cuối Tìm kiếm của Tenor hiện hỗ trợ tìm kiếm hình dán thông qua tham số searchfilter.
  2. Đưa các tham số client_key và country vào các lệnh gọi API.
  3. Tham số media_filter hiện lấy danh sách các định dạng mong muốn được phân tách bằng dấu phẩy thay vì các enum đặt sẵn.
  4. Điểm cuối Danh mục hiện hỗ trợ featured và trending cho tham số type.
  5. API này không còn hỗ trợ tham số anon_id nữa.
  6. Khi không còn trang kết quả nào để yêu cầu, trường next của các phản hồi API hiện là một chuỗi trống thay vì "0".

Các thay đổi sau đây đã được thực hiện đối với các điểm cuối hiện có:

  1. Điểm cuối Xu hướng không còn được hỗ trợ. Thay vào đó, bạn nên sử dụng Điểm cuối được làm nổi bật.
  2. Điểm cuối GIF đã được đổi tên thành điểm cuối Bài đăng.
  3. Điểm cuối GIF ngẫu nhiên đã được tích hợp vào Điểm cuối tìm kiếm thông qua tham số random.

Các thay đổi về đối tượng phản hồi và lỗi