API
API-documentatie
Vraag een adres op en je krijgt opvultekst terug. Je hebt geen account nodig om te beginnen, en het adres werkt net als dat van loripsum.net.
Snel beginnen
Dit is het hele idee: je vraagt een adres op en krijgt HTML terug.
curl https://we-loripsum.nl/api/3/short/headers
Dat geeft drie korte alinea's met koppen. Laat je alles weg, dan krijg je vier alinea's van gemiddelde lengte.
Zo bouw je het adres op
GET https://we-loripsum.nl/api/{aantal}/{lengte}/{opties...}?seed={getal}
Alle onderdelen mag je weglaten en de volgorde maakt niet uit. Een onderdeel dat we niet kennen slaan we over; je krijgt daar geen foutmelding van.
| Onderdeel | Waarde | Uitleg |
|---|---|---|
| Aantal | Een heel getal | Het aantal alinea's. Standaard 4, minimaal 1 en maximaal 100. Is het getal 0 of lager, dan krijg je 1 alinea. Is het hoger dan 100, dan krijg je er 100. |
| Lengte |
short,
medium,
long of
verylong
|
Het aantal zinnen per alinea. Standaard medium. |
| Opties | Zie alle opties | Wat er in de tekst moet komen. Zet er zoveel achter elkaar als je wilt. |
| Seed | ?seed=42 |
Een heel getal. Met hetzelfde getal en dezelfde instellingen krijg je steeds precies dezelfde tekst. |
Zinnen per alinea
| Lengte | Zinnen per alinea |
|---|---|
short | 1 tot 3 |
medium | 3 tot 5 |
long | 5 tot 8 |
verylong | 8 tot 12 |
De eerste alinea begint altijd met "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
Alle opties
Elke optie die je kiest komt minstens één keer in de tekst voor, ook als je maar één alinea vraagt.
| Optie | Wat het doet |
|---|---|
allcaps |
Zet de hele tekst in hoofdletters, ook de HTML-tags. |
bq |
Voegt citaten toe: <blockquote>. |
code |
Voegt blokken met code toe: <pre>. |
decorate |
Maakt losse woorden vet, cursief of gemarkeerd: <b>, <i> en <mark>. |
dl |
Voegt lijsten met begrip en uitleg toe: <dl>, <dt> en <dd>. |
headers |
Voegt koppen toe: <h1> tot en met <h6>. |
link |
Maakt van een paar woorden een link: <a>. |
markdown |
Geeft Markdown terug in plaats van HTML. Koppen, lijsten, links en de rest blijven werken. |
ol |
Voegt genummerde lijsten toe: <ol>. |
plaintext |
Geeft alleen tekst terug, zonder HTML. Alleen allcaps en prude werken dan nog. Staat plaintext én markdown aan, dan wint plaintext. |
prude |
Laat zinnen weg met Latijnse woorden die verkeerd kunnen vallen, zoals "homo" en "sex". |
ul |
Voegt lijsten met bolletjes toe: <ul>. |
Voorbeelden
curl
# Vier alinea's van gemiddelde lengte
curl https://we-loripsum.nl/api
# Tien korte alinea's met koppen en lijsten
curl https://we-loripsum.nl/api/10/short/headers/ul
# Zelfde tekst als Markdown
curl https://we-loripsum.nl/api/4/medium/headers/ul/markdown
# Steeds dezelfde tekst, met je eigen sleutel
curl -H "Authorization: Bearer JE_SLEUTEL" \
"https://we-loripsum.nl/api/3/code/link/decorate?seed=42"
JavaScript
const response = await fetch('https://we-loripsum.nl/api/5/short/headers/ul');
if (response.status === 429) {
const seconds = response.headers.get('Retry-After');
console.log(`Even wachten: probeer het over ${seconds} seconden opnieuw.`);
} else {
document.querySelector('#tekst').innerHTML = await response.text();
}
PHP
// Zonder sleutel
$html = file_get_contents('https://we-loripsum.nl/api/5/short/headers/ul');
// Met een sleutel, via de HTTP-client van Laravel
$html = Http::withToken('JE_SLEUTEL')
->get('https://we-loripsum.nl/api/3/long/bq', ['seed' => 42])
->body();
Wat je terugkrijgt
Je krijgt de tekst zelf terug, niet verpakt in JSON. Standaard is dat HTML:
HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Access-Control-Allow-Origin: *
<h1>Quid ergo hoc loco intellegit honestum?</h1>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed hoc sane concedamus.</p>
<ul>
<li>Cur igitur non bene?</li>
<li>Hoc est non dividere, sed frangere.</li>
</ul>
Met de optie plaintext krijg je alleen tekst, met een lege regel tussen de alinea's:
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Access-Control-Allow-Origin: *
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed hoc sane concedamus.
Cur igitur non bene? Hoc est non dividere, sed frangere.
Met de optie markdown krijg je dezelfde opbouw als HTML, maar als Markdown:
HTTP/1.1 200 OK
Content-Type: text/markdown; charset=utf-8
Access-Control-Allow-Origin: *
# Quid ergo hoc loco intellegit honestum?
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed hoc [sane concedamus](https://we-loripsum.nl/).
- Cur igitur non bene?
- Hoc est non dividere, sed frangere.
Gebruik vanaf je eigen site
Je mag de API rechtstreeks aanroepen vanuit JavaScript op elke website. Daarvoor sturen we bij elk antwoord
Access-Control-Allow-Origin: * mee (dat heet CORS).
Een voorafgaand OPTIONS-verzoek van de browser beantwoorden we ook.
De API gebruikt geen cookies en onthoudt niets tussen twee verzoeken.
Sleutels en limieten
Zonder sleutel kun je direct aan de slag. Heb je meer ruimte nodig, maak dan een gratis account aan en maak daar een sleutel. Voor nog meer verzoeken kies je een abonnement; betalen gaat via Mollie.
| Pakket | Verzoeken per minuut | Sleutels | Prijs |
|---|---|---|---|
| Zonder account | 120 | Geen | Gratis |
| Gratis | 300 | 1 | Gratis |
| Pro | 1.000 | 3 | € 3 per maand |
| Business | 3.000 | 10 | € 9 per maand |
Prijzen zijn exclusief btw. Je kunt elke maand opzeggen.
Je sleutel meesturen
Stuur je sleutel mee in de kop van je verzoek. Zet hem niet in het adres zelf, want dan komt hij sneller op plekken terecht waar hij niet hoort.
Authorization: Bearer JE_SLEUTEL
Een sleutel zie je maar één keer: op het moment dat je hem aanmaakt. Wij bewaren alleen een afdruk waaraan we hem herkennen en kunnen hem daarna niet meer laten zien. Ben je hem kwijt, trek hem dan in en maak een nieuwe.
Als het misgaat
| Code | Wat er aan de hand is | Wat je kunt doen |
|---|---|---|
200 |
Gelukt. | Je hebt de tekst. |
401 |
We kennen de sleutel niet, of hij is ingetrokken. | Controleer je sleutel of maak een nieuwe aan. |
422 |
De seed is geen heel getal. | Gebruik alleen cijfers, bijvoorbeeld ?seed=42. |
429 |
Je hebt je limiet voor deze minuut bereikt. | Wacht het aantal seconden uit Retry-After en probeer het opnieuw. |
Een foutmelding is altijd gewone tekst. Zo ziet het eruit als je te veel verzoeken doet:
HTTP/1.1 429 Too Many Requests
Content-Type: text/plain; charset=utf-8
Retry-After: 37
Je hebt de limiet bereikt. Probeer het over 37 seconden opnieuw.