1. Authentification et hôte API

En provenance de Tenor, le premier changement consiste à remplacer l’hôte `https://tenor.googleapis.com` par `https://heypster-gif.com/giphy`. Le second est de remplacer le paramètre `key` par `api_key`, conformément à la couche compatible GIPHY exposée par Heypster.

# Tenor
curl "https://tenor.googleapis.com/v2/search?q=excited&key=YOUR_TENOR_KEY"

# Heypster
curl "https://heypster-gif.com/giphy/v1/gifs/search?q=excited&api_key=YOUR_HEYPSTER_API_KEY"

2. Correspondance des endpoints

3. Changements de paramètres

4. Pagination

Tenor utilise `pos` et renvoie un token `next`. En migrant vers Heypster via notre couche compatible GIPHY, vous passez à une pagination numérique classique : `limit` fixe la taille de page, `offset` indique combien d’éléments ignorer.

// Tenor
const response1 = await fetch('https://tenor.googleapis.com/v2/search?q=cats&key=KEY');
const data1 = await response1.json();
const response2 = await fetch(`https://tenor.googleapis.com/v2/search?q=cats&key=KEY&pos=${data1.next}`);

// Heypster
const response1 = await fetch('https://heypster-gif.com/giphy/v1/gifs/search?q=cats&api_key=KEY&limit=25&offset=0');
const data1 = await response1.json();
const response2 = await fetch('https://heypster-gif.com/giphy/v1/gifs/search?q=cats&api_key=KEY&limit=25&offset=25');

5. Parsing des réponses

Un parser Tenor lit généralement `results` et `next`. Ici, il faut relire `data`, `pagination` et `meta`. C’est le principal changement structurel après la pagination.

{
  "data": [],
  "pagination": {
    "total_count": 500,
    "count": 25,
    "offset": 0
  },
  "meta": {
    "status": 200,
    "msg": "OK",
    "response_id": "heypster-response-id"
  }
}

const payload = await response.json();

const items = payload.data;
const offset = payload.pagination?.offset ?? 0;
const count = payload.pagination?.count ?? items.length;
const nextOffset = offset + count;
const status = payload.meta?.status;

6. Champs et formats

7. Suivi des partages

Si votre intégration Tenor utilisait `/v2/registershare`, prévoyez une adaptation spécifique : la surface Heypster documentée ici se concentre sur les endpoints de recherche, de découverte et d’identification (`randomid`), pas sur un endpoint Tenor dédié au suivi de partage.

8. Exemple complet en JavaScript

const API_HOST = 'https://heypster-gif.com/giphy';
const API_KEY = 'YOUR_HEYPSTER_API_KEY';

export async function searchTenorLike(query, page = 0, limit = 25) {
    const offset = page * limit;
    const url = new URL(`${API_HOST}/v1/gifs/search`);

    url.searchParams.set('api_key', API_KEY);
    url.searchParams.set('q', query);
    url.searchParams.set('limit', String(limit));
    url.searchParams.set('offset', String(offset));
    url.searchParams.set('rating', 'g');

    const response = await fetch(url.toString());
    const payload = await response.json();

    return {
        items: payload.data,
        pagination: payload.pagination,
        nextOffset: (payload.pagination?.offset ?? 0) + (payload.pagination?.count ?? 0),
        meta: payload.meta,
    };
}

9. Checklist de migration

• Remplacez `https://tenor.googleapis.com` par `https://heypster-gif.com/giphy`.
• Remplacez `key` par `api_key` dans toutes les requêtes.
• Mappez `search`, `featured`, `categories`, `autocomplete`, `search_suggestions`, `trending_terms`, `posts` et `anonid`.
• Remplacez la pagination `pos` / `next` par `limit` / `offset`.
• Adaptez le parsing `results` → `data` et `media_formats` → `images`.
• Vérifiez explicitement les formats réellement consommés par votre interface.
• Traitez séparément le suivi si vous utilisiez `registershare` côté Tenor.