Open API · MCP

Voor ontwikkelaars en AI-agents

Prijzen, domeinnamen, storingen en de kennisbank, machineleesbaar en zonder sleutel

Wil je dat een AI-assistent of je eigen software weet wat VoiceOne aanbiedt en wat het kost? Dan kan dat zonder de website te hoeven uitlezen. Alles op deze pagina is alleen lezen: inloggen, bestellen of iets wijzigen kan hier niet. Een agent stuurt de gebruiker voor een bestelling naar de juiste pagina op voiceone.nl.

Open API

Basisadres https://voiceone.nl/api/agent/v1. Antwoorden zijn JSON, bedragen in euro met en zonder btw. De volledige beschrijving staat in openapi.json.

GET /services: Diensten en prijzen zoals op de website. Filter met ?category=mobile, voip, sip-trunk, hosting, email of onebooks.
GET /domains/extensions: Domeinextensies die we registreren, met registratie- en verlengprijs per jaar.
GET /domains/check?domain=voorbeeld.nl: Is een domeinnaam vrij? Met prijs en een link om te bestellen. Of een naam op meerdere extensies: ?domain=voorbeeld&extensions=nl,com.
GET /status: Storingen en gepland onderhoud, zoals op voiceone.nl/status.
GET /help/search?q=voicemail: Artikelen uit de kennisbank (Nederlands).
GET /health: Draait de API?

curl "https://voiceone.nl/api/agent/v1/domains/check?domain=voorbeeld.nl"

MCP-server

Voor AI-assistenten die het Model Context Protocol ondersteunen: https://voiceone.nl/mcp (Streamable HTTP, zonder login). Dezelfde gegevens als de API, als tools:

list_services — Diensten en prijzen
list_domain_extensions — Domeinextensies met prijzen
check_domain — Domeinnaam controleren
get_service_status — Storingen en onderhoud
search_help_articles — Kennisbank doorzoeken

Toevoegen aan een MCP-client, bijvoorbeeld:

{
  "mcpServers": {
    "voiceone": {
      "type": "http",
      "url": "https://voiceone.nl/mcp"
    }
  }
}

Pagina's als Markdown

De pagina's van voiceone.nl (diensten, oplossingen, contact en meer) zijn ook als Markdown op te vragen: stuur de header Accept: text/markdown mee. Browsers krijgen gewoon de gewone pagina.

Artikelen uit de kennisbank en de blog vind je via de API (/help/search) of op de site zelf.

curl -L -H "Accept: text/markdown" https://voiceone.nl/voip/mobiel/

Bestanden voor agents

/llms.txt — Overzicht van de site voor taalmodellen
/llms-full.txt — Alle pagina's als één tekstbestand
/openapi.json — Beschrijving van de open API (OpenAPI 3.1)
/.well-known/api-catalog — API-catalogus (RFC 9727)
/.well-known/mcp/server-card.json — Beschrijving van de MCP-server
/.well-known/agent-skills/index.json — Agent skills: korte instructies voor AI-agents
/.well-known/ai-catalog.json — Overzicht van alles hierboven (ARD)

Spelregels

Alleen openbare informatie, nooit gegevens van klanten.
Zonder sleutel, met een eerlijk-gebruiklimiet: 120 verzoeken per 10 minuten per IP-adres, domeincontroles 30 per 10 minuten. Daarboven geeft de API een 429 met Retry-After; de MCP-server geeft dan een foutmelding in het toolresultaat (isError).
Bestellen gaat via de website (order_url): daar horen een identiteitscontrole en betaling bij die een agent niet namens iemand doet.
Vragen of iets kapot? Mail [email protected].