Ga naar de inhoud
WE-loripsum.nl

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
short1 tot 3
medium3 tot 5
long5 tot 8
verylong8 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.

Maak een gratis account

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.