Zum Inhalt springen

API-Dokumentation

Reseller API

Für Partner: Melden Sie die Domains Ihrer Kunden automatisch an, ohne Eingreifen eines Mitarbeiters. Authentifizierung mit OAuth 2.0 (Client Credentials).

Version
1.1.1

Basis-URL

  • Produktionhttps://api.secumail.nl
  • Testhttps://test-api.secumail.nl

Authentifizierung

  • OAuth 2.0 (Client Credentials), Access Token im Header Authorization

Einen API-Schlüssel oder Zugangsdaten fordern Sie über unseren Kontakt.

Endpunkte

POST/reseller/account

Onboard a customer domain (third-party resellers)

This is the endpoint for third-party resellers. Authenticate with the OAuth 2.0 client-credentials grant and send the resulting access token - see the security scheme.

{
  "domain":  "<domain>",
  "user":    "<user>",
  "org":     "<org>",
  "prefix":  "secumailer",
  "contact": "secumailer"
}

prefix and contact are hard-coded server-side and are not taken from the request body.

Request-Body application/json

Beispiel

{
  "domain": "example.nl",
  "user": "info@example.nl",
  "org": "Example B.V."
}

Antworten

  • 201

    The success status is 201, not 200. The method declares 201, 400 and 500 and no 200 at all. A client that treats only 200 as success will misread every successful call.

  • 400

    The request body was absent, could not be parsed, carried no attributes at all, or a mandatory attribute (domain, user, org) was absent or empty. errorMessage names the offending attribute, or the body itself.

    Produced by the method's .*\[Bad Request\].* integration response. Verified live on acceptance.

  • 401
  • 403

    Authenticated but not permitted: a WAF block, a resource-policy denial, or - on /reseller/account - a token whose scope claim does not include the scope the method requires.

  • 415
  • 429

    * production - api.secumail.nl, stage prd: 100 requests/second sustained, 500 burst * acceptance - test-api.secumail.nl, stage acc: 10 requests/second sustained, 50 burst

    Neither stage configures a quota, so QUOTA_EXCEEDED does not arise. A 429 here is always a rate or burst breach.

  • 500
  • 504

Felder mit * sind Pflichtfelder. Die technischen Beschreibungen stammen aus der OpenAPI-Spezifikation und sind auf Englisch.

Anbindung besprechen?

Möchten Sie wissen, wie SecuMailer an Ihre Anwendung anschließt?

Vereinbaren Sie eine kostenlose Demo. Wir besprechen Ihre Situation und den besten Weg der Anbindung.

Kostenlose Demo vereinbaren