---

Guide de prise en main

Les exemples ci-dessous ciblent directement la couche compatible GIPHY exposée sur `https://heypster-gif.com/giphy`. Les routes sont protégées par le middleware `giphy.apikey` ; si votre implémentation reproduit GIPHY, continuez à transmettre `api_key`.

1. Tester une recherche

curl "https://heypster-gif.com/giphy/v1/gifs/search?api_key=YOUR_HEYPSTER_API_KEY&q=party&limit=12&lang=fr"

2. Faire la même chose en JavaScript

const HEYPSTER_API_HOST = 'https://heypster-gif.com/giphy';
const HEYPSTER_API_KEY = 'YOUR_HEYPSTER_API_KEY';

async function searchGifs(query) {
    const response = await fetch(
        `${HEYPSTER_API_HOST}/v1/gifs/search?api_key=${HEYPSTER_API_KEY}&q=${encodeURIComponent(query)}&limit=12&lang=fr`
    );

    const payload = await response.json();
    return payload.data;
}

3. Réutiliser les mêmes déclinaisons que GIPHY

const gif = payload.data[0];

const originalUrl = gif.images.original.url;
const originalMp4 = gif.images.original.mp4;
const originalWebp = gif.images.original.webp;
const fixedWidthUrl = gif.images.fixed_width.url;
const previewGif = gif.images.preview_gif.url;

4. Tester les autres endpoints disponibles

# Catégories
curl "https://heypster-gif.com/giphy/v1/gifs/categories?api_key=YOUR_HEYPSTER_API_KEY"

# Recherches tendances
curl "https://heypster-gif.com/giphy/v1/trending/searches?api_key=YOUR_HEYPSTER_API_KEY"

# Random ID
curl "https://heypster-gif.com/giphy/v1/randomid?api_key=YOUR_HEYPSTER_API_KEY"

# Variations d’emoji
curl "https://heypster-gif.com/giphy/v2/emoji/1/variations?api_key=YOUR_HEYPSTER_API_KEY"

---

Endpoints GIF

La structure ci-dessous reprend la logique de lecture des docs GIPHY : chaque endpoint conserve un chemin REST familier et un contrat pensé pour limiter le refactoring.

---

Schéma de réponse

Pour une migration fluide, gardez votre logique de parsing centrée sur ces quatre blocs.

{
  "data": [
    {
      "id": "abc123",
      "title": "celebration",
      "url": "https://your-heypster-app/gifs/abc123",
      "slug": "celebration-abc123",
      "rating": "g",
      "images": {
        "original": {
          "url": "https://cdn.heypster.example/original-mini.gif",
          "width": "",
          "height": "",
          "mp4": "https://cdn.heypster.example/original.mp4",
          "webp": "https://cdn.heypster.example/original-mini.gif"
        },
        "fixed_width": {
          "url": "https://cdn.heypster.example/fixed_width.gif",
          "width": "",
          "height": "",
          "mp4": "https://cdn.heypster.example/fixed_width.mp4",
          "webp": "https://cdn.heypster.example/fixed_width.gif"
        },
        "preview_gif": {
          "url": "https://cdn.heypster.example/preview.gif"
        },
        "preview": {
          "mp4": "https://cdn.heypster.example/preview.mp4"
        }
      }
    }
  ],
  "pagination": {
    "total_count": 500,
    "count": 25,
    "offset": 0
  },
  "meta": {
    "status": 200,
    "msg": "OK",
    "response_id": "heypster-response-id"
  }
}

---

Bonnes pratiques

• Conservez le même parser GIPHY tant que votre application lit surtout `data`, `pagination`, `meta` et `images`.
• Gardez en tête que `pagination` n’est pas présente sur tous les endpoints : les réponses unitaires et certains endpoints utilitaires renvoient seulement `data` et `meta`.
• Ne consommez que les déclinaisons nécessaires pour limiter la bande passante côté web et mobile.
• Sur Heypster, les déclinaisons image sont reconstruites à partir de `gif_mini` et les déclinaisons vidéo à partir de `h264`.
• Ne dépendez pas de `webm` : le contrat actuel expose `webp` et `mp4`.
• Gardez `limit` et `offset` côté client pour préserver un comportement identique pendant la migration.
• Mettez en cache les suggestions et les tendances côté serveur si votre trafic ou vos quotas l’exigent.