Interfaccia sviluppatori
L’API di testo segnaposto
A volte il generatore nel browser è una deviazione di troppo: chi ha bisogno di testo segnaposto in seed, fixture, test automatici o direttamente nel build vuole ottenerlo con una chiamata – non copiarlo. Proprio a questo serve questo endpoint: una singola richiesta GET, nessuna registrazione, nessuna API key, nessun costo.
L’API usa esattamente le stesse liste di parole del generatore in home page. Quello che vedete lì, qui lo ricevete – in JSON o come testo semplice.
Endpoint
GET https://loremipsum-generator.org/api
Parametri
| type | Tipo di testo: lorem (default), german o numbers |
| paragraphs | Numero di paragrafi, 1–20 (default: 3) |
| words | in alternativa: numero totale di parole, 1–2000 (prevale su paragraphs) |
| format | json (default) oppure text |
| start | 1 = iniziare con «Lorem ipsum dolor sit amet …» (solo type=lorem) |
| kind | solo type=numbers: int (default), dec oppure price |
| count | solo type=numbers: numero di valori, 1–100 (default: 10) |
| min / max | solo type=numbers: intervallo di valori (default: da 0 a 1000) |
| locale | solo type=numbers: de (1.234,56 €) oppure en ($1,234.56) |
Esempi
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"]);
Formato di risposta
{
"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 …"
}
Ogni risposta JSON contiene i campi source e attribution come credito automatico. Con format=text la fonte appare come ultima riga sotto il testo.
Limite fair-use & CORS
Ogni indirizzo IP può effettuare 120 richieste all’ora e 1.500 richieste al giorno – più che sufficienti per test e build. Al raggiungimento di un limite l’API risponde con stato 429 e un header Retry-After. Gli header X-RateLimit-Limit e X-RateLimit-Remaining mostrano in ogni momento lo stato del limite orario. Le richieste IPv6 vengono conteggiate per rete /64, non per singolo indirizzo.
L’endpoint è aperto in CORS a tutte le origini (Access-Control-Allow-Origin: *): potete quindi chiamarlo direttamente dal JavaScript di qualsiasi pagina. E per volumi davvero grandi: l’intero generatore gira comunque lato client – per la generazione di massa la home page è la scelta più rapida.