Interface développeurs
L’API de faux-texte
Parfois, le générateur dans le navigateur est un détour de trop : qui a besoin de faux-texte dans des seeds, des fixtures, des tests automatisés ou directement dans un build veut le récupérer par un appel – pas le copier. C’est exactement le rôle de ce point d’accès : une seule requête GET, pas d’inscription, pas de clé API, aucun coût.
L’API utilise exactement les mêmes listes de mots que le générateur de la page d’accueil. Ce que vous y voyez, vous l’obtenez ici – en JSON ou en texte brut.
Point d’accès
GET https://loremipsum-generator.org/api
Paramètres
| type | Type de texte : lorem (défaut), german ou numbers |
| paragraphs | Nombre de paragraphes, 1–20 (défaut : 3) |
| words | alternative : nombre total de mots, 1–2000 (prioritaire sur paragraphs) |
| format | json (défaut) ou text |
| start | 1 = commencer par « Lorem ipsum dolor sit amet … » (type=lorem uniquement) |
| kind | type=numbers uniquement : int (défaut), dec ou price |
| count | type=numbers uniquement : nombre de valeurs, 1–100 (défaut : 10) |
| min / max | type=numbers uniquement : plage de valeurs (défaut : 0 à 1000) |
| locale | type=numbers uniquement : de (1.234,56 €) ou en ($1,234.56) |
Exemples
curl
curl "https://loremipsum-generator.org/api?type=german¶graphs=2&format=text"
JavaScript (fetch)
const res = await fetch("https://loremipsum-generator.org/api?type=lorem&words=120&start=1");
const data = await res.json();
console.log(data.text);
PHP
$json = file_get_contents("https://loremipsum-generator.org/api?type=numbers&kind=price&count=5&locale=de");
$data = json_decode($json, true);
print_r($data["paragraphs"]);
Format de réponse
{
"source": "https://loremipsum-generator.org",
"attribution": "Generated by loremipsum-generator.org – free to use.",
"meta": { "type": "lorem", "paragraphs": 3 },
"paragraphs": ["Lorem ipsum dolor …", "…", "…"],
"text": "Lorem ipsum dolor …"
}
Chaque réponse JSON contient les champs source et attribution comme crédit automatique. Avec format=text, la source figure en dernière ligne sous le texte.
Limite d’usage & CORS
Chaque adresse IP peut effectuer 120 requêtes par heure et 1 500 requêtes par jour – largement assez pour les tests et les builds. Quand une limite est atteinte, l’API répond avec le statut 429 et un en-tête Retry-After. Les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining indiquent à tout moment l’état de la limite horaire. Les requêtes IPv6 sont comptées par réseau /64, pas par adresse individuelle.
Le point d’accès est ouvert en CORS à toutes les origines (Access-Control-Allow-Origin: *). Vous pouvez donc l’appeler directement depuis le JavaScript de n’importe quelle page. Et pour de très gros volumes : le générateur complet tourne de toute façon côté client – pour la génération en masse, la page d’accueil est le choix le plus rapide.