Aan de slag

Je eerste request in 4 stappen

Ga van nul naar een echte API-call op de REST API van Openprovider.

1

Maak een account en zet API-toegang aan

Je hebt een actief selleraccount nodig. Log in op het controlepaneel, of maak er een aan, om je gebruikersnaam en wachtwoord te krijgen.

API-toegang staat standaard uit en wordt per contactpersoon ingeschakeld. Ga in het controlepaneel naar Accountoverzicht → Contactpersonen → en kies Contactpersoon toevoegen of selecteer een bestaande → tabblad API → API-toegang inschakelen.

Voor domeinhandelingen moet je mogelijk eerst specifieke registrycontracten ondertekenen. Bekijk ze onder Account → Contracten.

2

Authenticeer om een bearer token te krijgen

Stuur je inloggegevens naar het endpoint /auth/login. De response bevat een token waarmee je elk volgend request autoriseert.

curl -X POST https://api.openprovider.eu/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "you@example.com",
    "password": "your-password",
    "ip": "0.0.0.0"
  }'

Het token wordt teruggegeven in data.token en is beperkt geldig. Bewaar het in de cache en hergebruik het over meerdere requests in plaats van bij elke call opnieuw in te loggen.

3

Doe je eerste geautoriseerde call

Geef het token mee in de Authorization-header als bearer token. Hier controleren we of een domein beschikbaar is:

curl -X POST https://api.openprovider.eu/v1/domains/check \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [{ "name": "mybrand", "extension": "com" }]
  }'
4

Bekijk de volledige API-referentie

Bekijk elk endpoint, requestschema en responsvoorbeeld in de interactieve documentatie, of importeer de OpenAPI-specificatie in Postman.

Basis-URL en conventies

OnderdeelWaarde
Basis-URLhttps://api.openprovider.eu/v1
ProtocolAlleen HTTPS
FormaatRequest- en responsbodies in JSON
AuthenticatieAuthorization: Bearer <token>
MethodesGET, POST, PUT, DELETE

Opbouw van de response

Geslaagde responses verpakken de payload in een voorspelbare structuur met een numerieke code (0 betekent geslaagd) en een data-object:

{
  "code": 0,
  "data": { /* result */ },
  "desc": ""
}

Een code die niet nul is duidt op een fout. Bekijk desc voor een leesbare melding en vang fouten netjes af in je integratie.