OTS API Beispiele

Die APA-OTS API ist ein REST Webservice. Dadurch können ganz einfach Parameter übergeben und ein Ergebnis empfangen werden. Viele Frameworks stellen vorgefertigte Schnittstellen für solche Webservices zur Verfügung, aber auch das selbst schreiben der Zugriffsschnittstelle ist leicht möglich.

In PHP kann beispielsweise einfach eine URL mit GET-Parametern erstellt und mittels der Funktionen file_get_contents() oder curl das Ergebnis geholt werden.

Folgende Beispiele sollen den Einsatz der Parameter verdeutlichen:

Szenario: Pressemappe

gewünschter Output:
Liste der letzten 15 Aussendungen einer Firma

Parameter:

  • query mit emittentid
  • anz

Abfrage zusammenbauen:
Durch ein = in der Query wird angeraten die Query mit urlencode() in URL-sichere Zeichen umzuwandeln.

https://www.ots.at/api/liste?app=yourAppId&query=emittentid%3D412&anz=15
Die ID des Aussenders finden sie in der URL der Pressemappe.
z.B. https://www.ots.at/pressemappe/412/apa-ots-originaltext-service-gmbh

Szenario: Person

gewünschter Output:
Aussendungen im Mai 2013, in denen der Name Heinz Fischer vorkommt

Parameter:

  • query
  • von
  • bis

Abfrage zusammenbauen:

https://www.ots.at/api/liste?app=yourAppId&query=Heinz%20Fischer&von=1367359200&bis=1370037599&anz=50
Sollen mehr als die Standardanzahl von 10 Aussendungen gefunden werden, muss der Parameter „anz“ auf den entsprechenden Wert gesetzt werden.

Szenario: Bilder

gewünschter Output:
alle Bilder aus dem Channel Medien der letzten Wochen

Parameter:

  • query
  • inhalt
  • von

Abfrage zusammenbauen:
Um immer den aktuellsten Zeitraum von einer Woche zu erhalten kann ein negativer Timestamp an den Parameter „von“ übergeben werden, der dann vom aktuellen Timestamp abgezogen wird.

https://www.ots.at/api/liste?app=yourAppId&query=%28%28HEADER%3D%275+KI%27+OR+HEADER%3D%275+KA%27%29%29&inhalt=bilder&von=-604800&anz=200
Um die Queries zu den Channels zu erhalten, kann der Wizard benutzt werden.

Szenario: Aussendung

gewünschter Output:
eine durch Schlüssel identifizierte OTS-Aussendung

Parameter:

  • schluessel

Abfrage zusammenbauen:

https://www.ots.at/api/aussendung?app=yourAppId&schluessel=OTS_20130506_OTS0136
Der Schlüssel einer Aussendung kann aus dem Feld „SCHLUESSEL“ aus dem Ergebnis einer OTS-API-Listenabfrage oder aus der URL einer Aussendung auf www.ots.at ausgelesen werden,
z.B. https://www.ots.at/presseaussendung/OTS_20130506_OTS0136/pr-bild-award-2013-apa-ots-sucht-die-besten-pr-bilder-des-jahres