Beschreibung
Mit dieser Methode können Sie die Systemzeit der API abrufen.
Diese Methode benötigt keine Authentifizierung.
Der Server synchronisiert seine Zeit über NTP, sie können die Antwort daher auch als Normalzeitquelle verwenden wenn Sie keinen Zugriff auf einen NTP-Server haben.
Anfrage
Syntax
GET /v2/ping HTTP/1.1
Host: api.cobai.com
Content-Length: 0
Date: Datum/Uhrzeit
Request-Parameter
Diese Methode benutzt keine zusätzlichen Request-Parameter
Request-Header
Diese Methode benutzt zusätzlich zu den Standard-Requestheadern keine weiteren Header.
Request-Body
Diese Methode verwendet keinen Request-Body
Antwort
Als Antwort erhalten Sie ein XML-Dokument mit der aktuellen Systemzeit des API-Servers. Diese Zeit können Sie z.B. bei der Erzeugung einer API-Signatur als Zeitbasis verwenden.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<pingResponse>
<localTime>2011-01-29T13:23:56.750+01:00</localTime>
</pingResponse>
Das Antwortdokument wird zukünftig um zusätzliche Felder erweitert. Verwenden Sie daher einen geeigneten XML-Parser um die Zeitinformation auszulesen.
Antwortelemente
|
Name |
Inhalt |
|---|---|
|
localTime |
Die aktuelle Systemzeit des API-Servers. |