Come eseguire la migrazione dall'API V1 di Tenor

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:

  1. L'endpoint di ricerca di Tenor ora supporta la ricerca di adesivi tramite il parametro searchfilter.
  2. Includi i parametri client_key e country nelle chiamate API.
  3. Ora il parametro media_filter crea un elenco separato da virgole dei formati desiderati anziché le enumerazioni preimpostate.
  4. L'endpoint Categorie ora supporta featured e trending per il parametro type.
  5. L'API non supporta più il parametro anon_id.
  6. 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:

  1. L'endpoint di tendenza non è più supportato. Consigliamo invece di utilizzare l'endpoint in primo piano.
  2. L'endpoint GIF è stato rinominato Endpoint dei post.
  3. L'endpoint GIF casuale è stato incorporato nell'endpoint di ricerca tramite il parametro random.

Modifiche a oggetti ed errori di risposta