---

API Quickstart Guide

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 côté 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. Utiliser les mêmes renditions que Giphy

const gif = payload.data[0];

const originalUrl = gif.images.original.url;
const fixedWidthUrl = gif.images.fixed_width.url;
const previewGif = gif.images.preview_gif.url;

4. Autres endpoints disponibles

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

# Trending searches
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"

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

---

GIF Endpoints

La structure ci-dessous reprend la logique de lecture des docs GIPHY: chaque endpoint garde un chemin REST familier et un contrat pensé pour réduire 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.gif",
          "width": "480",
          "height": "270"
        },
        "fixed_width": {
          "url": "https://cdn.heypster.example/fixed_width.gif",
          "width": "200",
          "height": "113"
        },
        "preview_gif": {
          "url": "https://cdn.heypster.example/preview.gif"
        }
      }
    }
  ],
  "pagination": {
    "total_count": 500,
    "count": 25,
    "offset": 0
  },
  "meta": {
    "status": 200,
    "msg": "OK",
    "response_id": "heypster-response-id"
  }
}

---

Best Practices

• Conservez le même parser GIPHY tant que votre application lit surtout `data`, `pagination`, `meta` et `images`.
• Ne consommez que les déclinaisons nécessaires pour limiter la bande passante côté web et mobile.
• 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.