Ping
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. |