Skip to main content
Souver kennisbank
Suchen

Eine Anmeldung senden (für Ihren Webentwickler)

Die Adresse, die Felder und ein Beispiel für eine Anmeldung.

A API Helpcenter · Zuletzt aktualisiert

Dieser Artikel ist für den Webentwickler, der das Anmeldeformular anbindet. Ihre Website sendet die Anmeldung vom Server an die Plattform.

Die Adresse

POST https://panel.souver.nl/api/v1/aanmeldingen

Header:

  • Authorization: Bearer sgn_… (der API-Schlüssel)
  • Content-Type: application/json
  • Accept: application/json

Eine Anmeldung ist höchstens 32 KB groß.

Pflichtfelder

Feld Erklärung
privacy true: Der Antragsteller stimmt der Verarbeitung seiner Daten zu
company.name Firmenname
contact.first_name Vorname der Kontaktperson
contact.last_name Nachname der Kontaktperson
contact.email E-Mail-Adresse der Kontaktperson

Optionale Felder

Feld Erklärung
locale nl (Standard), en oder de: die Sprache der E-Mails und Fehlermeldungen
company.legal_form Rechtsform, zum Beispiel B.V.
company.kvk Handelsregisternummer (KvK), in den Niederlanden 8 Ziffern
company.vat USt-IdNr., zum Beispiel NL123456789B01
company.street, company.house_number, company.postal_code, company.city Adresse; Postleitzahl in den Niederlanden als 1234 AB
company.country Ländercode, zum Beispiel NL, BE oder DE; Standard NL
contact.role Funktion der Kontaktperson
contact.phone Mobilnummer; eine ausländische Nummer mit +
billing_email E-Mail-Adresse für Rechnungen, falls abweichend
website Website des Antragstellers
expected erwartete Anzahl: customers, domains, mailboxes, websites
source wie der Antragsteller Sie gefunden hat
note Bemerkung
documents akzeptierte Dokumente, siehe den Artikel über Dokumente
meta.ip, meta.user_agent IP-Adresse und Browser des Besuchers (nicht Ihres Servers)
meta.honeypot der Wert eines versteckten Feldes; ist es ausgefüllt, handelt es sich um Spam
meta.form_ms Zeit in Millisekunden zwischen dem Öffnen und dem Absenden des Formulars; weniger als 3000 ist Spam

Beispiel mit curl

curl -s https://panel.souver.nl/api/v1/aanmeldingen \
  -H "Authorization: Bearer $SIGNUP_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "locale": "nl",
    "privacy": true,
    "company": { "name": "Bakkerij De Test BV", "kvk": "12345678", "postal_code": "1234 AB", "city": "Testdorp", "country": "NL" },
    "contact": { "first_name": "Els", "last_name": "Eigenaar", "email": "els@bakkerij.test", "phone": "06 12345678" },
    "meta": { "ip": "203.0.113.7", "user_agent": "Mozilla/5.0", "honeypot": "", "form_ms": 48211 }
  }'

Beispiel in PHP (Laravel)

$r = Http::withToken(config('services.signup.key'))->acceptJson()
    ->post('https://panel.souver.nl/api/v1/aanmeldingen', $gegevens + ['meta' => [
        'ip' => request()->ip(),
        'user_agent' => request()->userAgent(),
        'honeypot' => request('website_url'),
        'form_ms' => (int) request('form_ms'),
    ]]);

if ($r->status() === 422) {
    return back()->withErrors($r->json('errors'))->withInput();
}

return view('bedankt', ['referentie' => $r->json('reference')]);

Gut zu wissen

  • Übergeben Sie in meta die IP-Adresse und den Browser des Besuchers. Das ist der Nachweis für akzeptierte Dokumente.
  • Pro E-Mail-Adresse können höchstens 3 Anmeldungen gleichzeitig offen sein.
War dieser Artikel hilfreich?