Interaktion mit REST-APIs: Her mit den HTTP-Headern!

FileMaker hat uns mit Version 16 ein hervorragendes Werkzeug für die Interaktion mit REST-APIs beschert, die von vielen Web-Anwendungen bereitgestellt werden. Ein sehr nützliches und ganz einfaches Werkzeug – leider nicht ganz einfach zu finden in der Dokumentation.

Im Grunde ist es eine Erweiterung des „Aus URL einfügen“ Script-Schrittes, den es schon vorher gab. Neu ist die Integration einer abgespeckten cURLBibliothek, mit deren Hilfe man den Inhalt seiner HTTP-Abfragen um Header-Elemente erweitern kann (GET, PUT, POST, DELETE oder auch „ContentType“ oder „Authorisation: Bearer“).

Ein Wermutstropfen: FileMaker bringt bei jedem Aufruf, der nicht mit „HTTP/1.1 200 OK“ im Header zurückkommt, einen Fehler (5 Daten fehlen). Tatsächlich gibt es aber andere HTTP-Stati (im Grunde alle 2xx Stati), die auch „OK“ bedeuten.

Zum Beispiel 

Hier muss man die Beschreibung des angesprochenen REST-APIs aufmerksam lesen!
Wie aber komme ich in FileMaker an die HTTP-Header ran? Die Antwort ist verblüffend einfach, denn FileMaker hat gerade diese Option vorgesehen. Leider geht dieses Feature in der Dokumentation ein wenig unter. Der Schalter „-D“ in den cURL-Optionen, gefolgt von einer Referenz auf eine FileMaker-Variable, liefert alle HTTP-Header in dieser Variablen zurück. Die Variable steht dabei im Header-String als Text und muss nicht einmal escaped werden!

Zum Beispiel

Das Ergebnis