Mit Firefox Anfragen an die EODATA-Katalog-API von CODE-DE-Lab senden
Der unter Anleitung zur EODATA-Katalog-API auf CODE-DE-Lab beschriebene EODATA-Katalog kann mit gewöhnlichen HTTP-Anfragen durchsucht werden. Die Antworten werden im JSON-Format zurückgegeben.
Dieser Artikel beschreibt, wie Sie diese Anfragen mit dem Webbrowser Mozilla Firefox senden. Firefox enthält einen JSON-Parser, der die Antworten übersichtlich darstellt.
Diese Methode ist besonders nützlich, wenn Ihnen nur dieser Webbrowser zur Verfügung steht und Sie die Katalog-API verwenden möchten.
Voraussetzungen
Nr. 1 Installierter Firefox
Mozilla Firefox muss installiert sein. Sie können den Browser von der offiziellen Mozilla-Website herunterladen: https://www.mozilla.org. Viele Linux-Distributionen enthalten Firefox bereits.
Was wir behandeln werden
Anfragen ohne Body senden
Anfragen mit Body senden
GET-Anfragen ohne Body senden
Die meisten unter Anleitung zur EODATA-Katalog-API auf CODE-DE-Lab beschriebenen Anfragen sind einfache GET-Anfragen, die keinen Body benötigen.
Geben Sie die URL aus diesem Artikel in die Adressleiste von Firefox ein. Der Browser sollte die enthaltenen Sonderzeichen passend umwandeln.
Firefox sollte die Antwort als strukturierte JSON-Daten anzeigen. Mit dem Pfeil nach unten neben einem Schlüssel können Sie den zugehörigen Wert einklappen, zum Beispiel:
Mit dem Pfeil nach rechts können Sie den eingeklappten Wert wieder aufklappen:
Um die unverarbeiteten JSON-Daten zu sehen, wechseln Sie oben zur Registerkarte Raw Data:
Beispiel
Rufen Sie beispielsweise die folgende URL auf:
https://catalogue.code-de.org/odata/v1/Products?$filter=PublicationDate gt 2019-05-15T00:00:00.000Z and PublicationDate lt 2019-05-16T00:00:00.000Z
Diese URL zeigt Produkte, die zwischen dem 15. Mai 2019 und dem 16. Mai 2019 veröffentlicht wurden.
Ein Ausschnitt der strukturierten JSON-Daten sieht folgendermaßen aus:
Unter Raw Data sehen Sie die unverarbeiteten JSON-Daten:
Mit Pretty Print können Sie diese JSON-Daten übersichtlicher formatieren:
Anfragen mit Body senden
Einige unter Anleitung zur EODATA-Katalog-API auf CODE-DE-Lab beschriebene Anfragen benötigen einen Body und eine andere HTTP-Methode.
Ein Beispiel finden Sie dort im Abschnitt Abfrage anhand einer Liste (Query by list). Dafür müssen Sie die Methode POST verwenden und einen Body mitsenden.
Öffnen Sie in Firefox eine neue Registerkarte und drücken Sie CTRL+Shift+E. Diese Tastenkombination gilt für Linux und Windows; auf anderen Betriebssystemen kann sie abweichen.
Dadurch sollte sich der Bereich Network der Entwicklerwerkzeuge öffnen:
Rufen Sie in derselben Browserregisterkarte die URL aus diesem Abschnitt auf. Den Body und die HTTP-Methode passen Sie erst später an. Die URL lautet:
https://catalogue.code-de.org/odata/v1/Products/OData.CSC.FilterList
Dieser Aufruf sollte zunächst einen Fehler zurückgeben:
In den zuvor geöffneten Entwicklerwerkzeugen sollten zwei Anfragen erscheinen:
Klicken Sie mit der rechten Maustaste auf die Anfrage, die in der Spalte Initiator den Wert document hat.
Wählen Sie im Kontextmenü Edit and Resend:
Links sollte ein neuer Bereich erscheinen:
Hier können Sie die Anfrage bearbeiten. Wählen Sie im Auswahlmenü links neben der URL die Methode POST:
Geben Sie im Textfeld Body den Inhalt ein, den Sie mit der Anfrage senden möchten.
In diesem Beispiel verwenden Sie:
{
"FilterProducts":
[
{"Name": "S1A_IW_GRDH_1SDV_20141031T161924_20141031T161949_003076_003856_634E.SAFE"},
{"Name": "S3B_SL_1_RBT____20190116T050535_20190116T050835_20190117T125958_0179_021_048_0000_LN2_O_NT_003.SEN3"},
{"Name": "xxxxxxxx.06.tar"}
]
}
Klicken Sie auf Send, nachdem Sie alle Angaben eingetragen haben:
Die neue Anfrage sollte in der Tabelle erscheinen und diesmal den Status 200 haben.
Rechts neben der Tabelle finden Sie weitere Details zur Anfrage:
Öffnen Sie dort die Registerkarte Response. Sie sollte strukturierte JSON-Daten enthalten.
Mit dem Pfeil können Sie die Ausgabe aufklappen:
Wie unter Anleitung zur EODATA-Katalog-API auf CODE-DE-Lab beschrieben, sollten zwei Produkte angezeigt werden:
Um die vollständige JSON-Antwort in die Zwischenablage zu kopieren, klicken Sie mit der rechten Maustaste auf die Anfrage in der mittleren Tabelle der Entwicklerwerkzeuge. Wählen Sie Copy Value -> Copy Response:
