Die API mit Try it ausprobieren
Auf jeder Endpoint-Seite befindet sich rechts über dem Codebeispiel die Schaltfläche „Try it“. Damit können Sie die Parameter in ein Formular eintragen und den Aufruf aus Ihrem Browser senden. Die Antwort erscheint darunter: dasselbe JSON, das Sie auch in Ihrem eigenen Code erhalten würden.
API-Schlüssel eintragen
Fügen Sie oben im Formular Ihren API-Schlüssel in das Feld „api_key“ ein. Es gibt kein Passwortfeld, da die API kein Passwort benötigt. Warum das so ist, lesen Sie unter Authentifizierung mit Ihrem API-Schlüssel.
Ihr Schlüssel verbleibt in Ihrem eigenen Browser und wird nicht an die Entwickler dieser Website gesendet. Die Anfrage geht direkt von Ihrem Browser über https an api.laposta.nl.
Achtung: Es ist ein echter Aufruf
Es gibt keine separate Testumgebung. Wenn Sie einen gültigen Schlüssel eintragen und einen Aufruf senden, der etwas erstellt, wird dies auch tatsächlich in Ihrem Konto erstellt.
Verwenden Sie beim Ausprobieren also keinen Schlüssel eines Kontos mit einem echten Abonnentenbestand. Seien Sie auch vorsichtig, wenn Sie an einem gemeinsam genutzten Computer arbeiten: Ihr Schlüssel bleibt in diesem Browser gespeichert, bis Sie ihn löschen.
Wenn Sie gar nichts eintragen, passiert nichts Schlimmes. Der Aufruf wird ohne Schlüssel gesendet und die API antwortet mit einem 401, da die API ohne Schlüssel nicht weiß, um welches Konto es sich handelt. Diese Fehlermeldung wird unter Authentifizierung mit Ihrem API-Schlüssel erläutert.
Sicher testen mit einer separaten Liste
Sie können sicher testen, indem Sie eine separate Testliste in Ihrem Konto erstellen. Erstellen Sie eine Liste, notieren Sie sich die list_id und richten Sie alle Ihre Testaufrufe darauf aus. Ihre echten Listen bleiben dann unberührt, selbst wenn etwas schiefgeht.
Ein separates kostenloses Testkonto zu erstellen ist meistens keine Option, siehe Ein kostenloses Konto pro Organisation. Wenn Sie als Entwickler wirklich eine abgeschirmte Umgebung benötigen, wenden Sie sich bitte über helpdesk@laposta.nl an den Helpdesk. Mehrere kostenpflichtige Konten zu erstellen ist hingegen möglich, gebündelt in einer Verwaltungsumgebung.
Endpoints ohne Try it
Bei einigen Endpoints fehlt die Schaltfläche „Try it“ absichtlich, da diese Aufrufe nicht rückgängig gemacht werden können oder von selbst anlaufen:
Die Codebeispiele auf diesen Seiten sind jedoch ganz normal vorhanden, sodass Sie genau sehen, wie der Aufruf aussieht.
Programmiersprache wählen
Über dem Codebeispiel wählen Sie die Programmiersprache aus. Auf der Endpoint-Seite selbst gibt es neun davon, von cURL und PHP bis hin zu Python, Go und Swift. In der Ansicht „Try it“ stehen drei zur Auswahl (cURL, JavaScript und Python), da dies die Anzeige Ihrer aktuellen Eingabe ist und nicht die vollständige Liste.