Ga naar inhoud

Overzicht voor ontwikkelaars

CloudPress is volledig programmeerbaar. Er zijn drie manieren om erop te bouwen:

  • De REST API — volledige programmatische controle over sites, domeinen & DNS, mailboxhosting, cPanel-accounts, bestellingen & facturatie, back-ups, CDN, Shield, metrics en workspaces. Begin met het API-overzicht voor authenticatie, conventies en foutafhandeling.
  • De MCP-server — laat een AI-assistent (Claude en andere MCP-clients) je workspace beheren via het Model Context Protocol. Zie de MCP-serverhandleiding om een client te verbinden.
  • De agent-skill — installeer een verpakte API-referentie in Claude Code, Cursor, Codex of een andere coding agent, zodat die correcte API-aanroepen schrijft in plaats van te raden. Er zitten geen inloggegevens in. Zie de pagina Agent-skill.

Bouw je een app van derden die namens andere gebruikers handelt? Gebruik dan OAuth 2.1 in plaats van een persoonlijke API-sleutel.

Een API-sleutel aanvragen

REST API-verzoeken authenticeren met een persoonlijke API-sleutel die aan je gebruiker is gekoppeld. Maak er een aan in het dashboard:

  1. Open het avatarmenu en kies Mijn instellingen.
  2. Klik in het linkermenu onder Ontwikkelaar op API-sleutels.
  3. Voer een Naam in om de sleutel te identificeren. Geef eventueel onder Toegestane IP-adressen op welke adressen hem mogen gebruiken, één adres of CIDR-bereik per regel; laat het leeg om elk adres toe te staan. Klik daarna op API-sleutel maken.
  4. Kopieer de token meteen. Hij wordt maar één keer getoond, met de melding "Kopieer deze token nu. Deze wordt slechts een keer getoond." Gebruik de knop Kopieren en bewaar hem ergens veilig — raak je hem kwijt, verwijder dan de sleutel en maak een nieuwe aan.

Stuur de sleutel mee in de Authorization-header bij elk /api/*-verzoek; zowel het Bearer- als het Token-schema werkt:

curl -H "Authorization: Bearer $CLOUDPRESS_TOKEN" \
  https://my.cloudpress.com/api/about

GET /api/about is een goede eerste aanroep — hij rapporteert als wie je geauthenticeerd bent en welke resources beschikbaar zijn.

Proefaccounts kunnen de API niet gebruiken

De API weigert elke credential die naar een proefaccount herleidt. Rond eerst de onboarding af. Om dezelfde reden is voor het aanmaken of wijzigen van API-sleutels een betaalde workspace nodig; sleutels die je al hebt, kun je nog wel intrekken.

Je Account-ID en de X-Auth-Account-header

Veel endpoints moeten weten in welke workspace je handelt. Dat geef je aan met de X-Auth-Account-header, ingesteld op je Account-ID.

Je vindt hem op dezelfde pagina API-sleutels, in de lijst Je werkruimtes onder de sleutels. Elke rij toont de Werkruimte, het Merk en de Werkruimte-ID, met een knop Kopiëren, en met het zoekvak filter je de lijst. De pagina legt uit waar de ID voor dient — "Stuur de ID van een werkruimte mee in de X-Auth-Account-header om de API in die werkruimte aan te roepen."

curl -H "Authorization: Bearer $CLOUDPRESS_TOKEN" \
  -H "X-Auth-Account: $ACCOUNT_ID" \
  https://my.cloudpress.com/api/sites

Een paar dingen om te weten:

  • Het is per workspace. Elke workspace heeft zijn eigen Account-ID. Beheer je er meerdere, zoek dan de gewenste workspace op in de lijst Je werkruimtes en kopieer de ID (of lees hem uit account_scoped in het antwoord van GET /api/about).
  • Wanneer het verplicht is. Met een persoonlijke API-sleutel beperkt de header een verzoek tot één workspace; zonder de header geven list-endpoints resources terug uit alle workspaces die je sleutel kan benaderen. Sommige endpoints vereisen hem — Orders, Carts, Subscriptions, Users, Webhooks, het aanmaken van DNS-zones en alle Domain Registration-endpoints — en geven 400 terug als hij ontbreekt.

Zie Setting Account Scope voor het volledige gedrag.

Je API-verzoeken bekijken

Het dashboard logt elke aanroep die met je persoonlijke API-sleutels is gedaan, zodat je kunt bevestigen wat een integratie doet of een mislukt verzoek kunt debuggen. Open Mijn instellingen en kies in het linkermenu Ontwikkelaar → API-aanvraaglogboeken. Elke vermelding toont:

Kolom Toont
Tijdstip Wanneer het verzoek is gedaan
API-sleutel Welke van je sleutels is gebruikt
Methode De HTTP-methode (GET, POST, …)
URL Het aangeroepen endpoint
IP-adres Het client-IP waar het verzoek vandaan kwam

Klik op een vermelding om de detailweergave te openen, die ook de Headers en Gegevens van het verzoek toont (de verzonden body) — handig om precies te zien wat de API bereikte. Vermeldingen staan met de nieuwste bovenaan.

Waar je verder kunt gaan

  • API-overzicht — authenticatie, conventies, paginering, rate limits en fouten
  • MCP-server — verbind een AI-assistent
  • OAuth 2.1 — autoriseer apps van derden
  • Billing webhooks — ontvang lifecycle-events van sites, cPanel-accounts en domeinen