Per le integrazioni esistenti che utilizzano l'API V1 di Tenor, segui i passaggi descritti in questa pagina per eseguire la migrazione alla V2.
Ottieni una chiave API V2
Segui le istruzioni riportate nel passaggio di configurazione della guida rapida per ottenere una chiave API V2 in sostituzione della versione V1.
Aggiornamento dei domini V2
Aggiorna il dominio API alla versione https://tenor.googleapis.com/v2/
. L'API V2 di Tenor supporta solo le connessioni HTTPS. Per i contenuti, assicurati che la tua applicazione supporti i download di contenuti da
https://media.tenor.com
e https://c.tenor.com
.
Ad esempio, supponi di aver effettuato una chiamata API a uno dei seguenti domini V1:
https://api.tenor.com/v1/search?<parameters>
https://g.tenor.com/v1/search?<parameters>
Per aggiornare le chiamate alla V2, modificale in
https://tenor.googleapis.com/v2/search?<parameters>
.
Modifiche agli endpoint
La maggior parte dei parametri degli endpoint API rimane invariata rispetto a quanto documentato nella versione 1. Esistono alcune eccezioni degne di nota:
- L'endpoint di ricerca
di Tenor ora supporta la ricerca di adesivi tramite il
parametro
searchfilter
. - Includi i parametri
client_key
ecountry
nelle chiamate API. - Ora il parametro
media_filter
crea un elenco separato da virgole dei formati desiderati anziché le enumerazioni preimpostate. - L'endpoint Categorie ora supporta
featured
etrending
per il parametrotype
. - L'API non supporta più il parametro
anon_id
. - Quando non ci sono più pagine di risultati da richiedere, ora il campo
next
delle risposte dell'API è una stringa vuota anziché"0"
.
Sono state apportate le seguenti modifiche agli endpoint disponibili:
- L'endpoint di tendenza non è più supportato. Consigliamo invece di utilizzare l'endpoint in primo piano.
- L'endpoint GIF è stato rinominato Endpoint dei post.
- L'endpoint GIF casuale è stato incorporato nell'endpoint di ricerca tramite il parametro
random
.
Modifiche a oggetti ed errori di risposta
- L'oggetto GIF è stato rinominato in oggetto della risposta.
- Nell'oggetto risposta, il campo
media
è stato rinominato inmedia_formats
. Il valore dimedia_formats
è ora una mappa{ CONTENT_FORMAT : MEDIA_OBJECT }
anziché un array di mappe. - Le anteprime delle miniature dei contenuti sono state spostate dall'oggetto multimediale per ogni formato dei contenuti nel proprio formato. Sono offerte nel campo
media_formats
dell'oggetto Risposta. - Quando non ci sono più risultati in un oggetto di risposta, il campo
next
è una stringa vuota,""
anziché"0"
. - È stata eseguita la migrazione dei codici di errore dell'API Tenor ai codici di errore dell'API standard di Google.