Migrer depuis l'API V1 de Tenor

Pour les intégrations existantes qui utilisent l'API V1 de Tenor, suivez les étapes de cette page pour migrer vers la V2.

Obtenir une clé API V2

Suivez les instructions de l'étape de configuration du guide de démarrage rapide pour obtenir une clé API V2 et remplacer votre version V1.

Mise à jour des domaines V2

Mettez à jour votre domaine d'API sur https://tenor.googleapis.com/v2/. L'API V2 de Tenor n'est compatible qu'avec les connexions HTTPS. Pour le contenu, assurez-vous que votre application est compatible avec le téléchargement de contenu à partir de https://media.tenor.com et https://c.tenor.com.

Par exemple, supposons que vous ayez effectué un appel d'API vers l'un des domaines V1 suivants :

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

Pour mettre à jour les appels vers la version 2, remplacez-les par https://tenor.googleapis.com/v2/search?<parameters>.

Modifications des points de terminaison

La majorité des paramètres de point de terminaison de l'API sont identiques à ceux décrits dans la version 1. Il existe quelques exceptions notables :

  1. Le point de terminaison de recherche de Tenor accepte désormais la recherche d'autocollants via le paramètre searchfilter.
  2. Incluez les paramètres client_key et country dans les appels d'API.
  3. Le paramètre media_filter accepte désormais une liste de formats souhaités séparés par une virgule au lieu d'énumérations prédéfinies.
  4. Le point de terminaison Categories est désormais compatible avec featured et trending pour le paramètre type.
  5. L'API n'est plus compatible avec le paramètre anon_id.
  6. Lorsque vous avez demandé toutes les pages de résultats, le champ next des réponses de l'API est désormais une chaîne vide au lieu de "0".

Les modifications suivantes ont été apportées aux points de terminaison disponibles :

  1. Le point de terminaison "Tendances" n'est plus accepté. Nous vous recommandons plutôt d'utiliser le point de terminaison "Featured".
  2. Le point de terminaison GIF a été renommé point de terminaison Posts.
  3. Le point de terminaison GIF aléatoire a été intégré au point de terminaison de recherche via le paramètre random.

Modifications apportées à l'objet réponse et aux erreurs

  • L'objet GIF a été renommé Objet réponse.
  • Dans l'objet de réponse, le champ media a été renommé media_formats. La valeur de media_formats est désormais un mappage { CONTENT_FORMAT : MEDIA_OBJECT } plutôt qu'un tableau de mappages.
  • Les aperçus des miniatures de contenu ont été déplacés de l'objet multimédia pour chaque format de contenu vers leur propre format. Elles sont proposées dans le champ media_formats de l'objet de réponse.
  • Lorsqu'il n'y a plus de résultats dans un objet de réponse, le champ next est une chaîne vide, "", plutôt que "0".
  • Les codes d'erreur de l'API Tenor ont été migrés vers les codes d'erreur standards de l'API Google.