API-referentie

Eén contract voor alles wat klanten kunnen gebruiken.

Endpoints voor klanten zijn beschikbaar onder /api/v1. Het oude prefix /api blijft beschikbaar voor het dashboard, maar nieuwe serverintegraties horen de base-URL met versienummer te gebruiken.

63 gedocumenteerde operaties8 resourcegroepenOpenAPI 3.1 machineleesbaar contract

Grenzen van authenticatie

Productintegraties gebruiken een API-sleutel van de workspace, waarmee je ook accountgebruik, analytics en metadata van API-sleutels kunt lezen. Wijzigingen in de facturering en het aanmaken of intrekken van API-sleutels vereisen de HTTP-only browsersessie en zijn als zodanig gelabeld.

Resources

Foutenvelope

JSON-fouten gebruiken één voorspelbare envelope. Statuscodes maken onderscheid tussen ongeldige input, authenticatie, ontbrekende resources, conflicten, betalingsvereisten, veiligheidsblokkades en gebruikslimieten.

Foutrespons
{
  "error": {
    "message": "The sender domain is not verified",
    "status": 403
  }
}

Versiebeheer

De datumgebaseerde API-versie identificeert dit contract. Binnen de versie kunnen achterwaarts compatibele velden worden toegevoegd. Brekende wijzigingen vereisen een nieuw basispad met versienummer en een gedocumenteerde overgang.

Discovery
{
  "version": "2026-09-07",
  "baseUrl": "https://sendhq.cc/api/v1",
  "openapi": "https://sendhq.cc/openapi.json"
}