RestGetResponseStatusCode

value RestGetResponseStatusCode ( value rest );

Rückgabewert

Rückgabewert	Nachricht	Beschreibung
200	OK	Die Anfrage wurde erfolgreich bearbeitet und das Ergebnis der Anfrage wird in der Antwort übertragen.
101	SWITCHING PROTOCOLS	Die Anfrage wurde erfolgreich bearbeitet. Das Protokoll wurde entsprechend der Client Anfrage umgeschaltet.
201	CREATED	Die Anfrage wurde erfolgreich bearbeitet. Die angeforderte Ressource wurde vor dem Senden der Antwort erstellt.
202	ACCEPTED	Die Anfrage wurde akzeptiert, wird aber zu einem späteren Zeitpunkt ausgeführt. Das Gelingen der Anfrage kann nicht garantiert werden.
204	NO CONTENT	Die Anfrage wurde erfolgreich durchgeführt, die Antwort enthält jedoch bewusst keine Daten.
400	BAD REQUEST	Die Anfrage-Nachricht war fehlerhaft aufgebaut.
401	UNAUTHORIZED	Die Anfrage kann nicht ohne gültige Authentifizierung durchgeführt werden. Wie die Authentifizierung durchgeführt werden soll, wird im WWW-Authenticate-Headerfeld der Antwort übermittelt.
403	FORBIDDEN	Die Anfrage wurde mangels Berechtigung des Clients nicht durchgeführt, eventuell weil der authentifizierte Benutzer nicht berechtigt ist, oder eine als HTTPS konfigurierte URL nur mit HTTP aufgerufen wurde.
404	NOT FOUND	Die angeforderte Ressource wurde nicht gefunden. Dieser Statuscode kann ebenfalls verwendet werden, um eine Anfrage ohne näheren Grund abzuweisen.
405	METHOD NOT ALLOWED	Die Anfrage darf nur mit anderen HTTP-Methoden (zum Beispiel GET statt POST) gestellt werden. Gültige Methoden für die betreffende Ressource werden im Allow-Headerfeld der Antwort übermittelt.
406	NOT ACCEPTABLE	Die angeforderte Ressource steht nicht in der gewünschten Form zur Verfügung. Gültige Content-Type-Werte können in der Antwort übermittelt worden sein.
415	UNSUPPORTED MEDIA TYPE	Der Inhalt der Anfrage wurde mit ungültigem oder nicht erlaubtem Medientyp übermittelt.
500	INTERNAL SERVER ERROR	Dies ist ein allgemeiner Statuscode für unerwartete Serverfehler.
501	NOT IMPLEMENTED	Die Funktionalität, um die Anfrage zu bearbeiten, wird von diesem Server nicht bereitgestellt. Ursache ist zum Beispiel eine unbekannte oder nicht unterstützte HTTP-Methode.

Parameter

rest

Das gültige REST-Objekt, dessen Statuscode für die zuletzt ausgeführte Anforderung ausgelesen werden soll.

Bemerkungen

Liefert den Statuscode, den der REST-Server, der über das REST-Objekt rest erreichbar ist, als Ergebnis zur letzten Anfrage zurückgab. Die eigentliche Anwort der Anfrage ist im Übergabeparameter strResponse von RestFullRequest enthalten bzw. kann über die Funktion RestReadResponse ausgelesen werden.

Beispiel

//ip.jsontest.com liefert als Antwort die IP-Adresse des anfragenden Clients
value rest, StatusCode;
string strLastError, strResponse, strStatusText;

if (!RestConnect(rest, "http://ip.jsontest.com"))
    RestGetLastError(rest, strLastError, true);
    return;
end
RestFullRequest(rest, "GET", "/", NULL, strResponse);

StatusCode = RestGetResponseStatusCode(rest);
//StatusCode = 200
strStatusText = RestGetResponseStatusText(rest);
//strStatusText = "OK"
strResponse = JsonExpand(strResponse);
//Inhalt von strResponse:
//{
//  "ip": "82.165.12.98"
//}
RestDisconnect(rest);

Die REST-Funktionen

Siehe auch RestGetConnectFailReason, RestGetIdleTimeout, RestGetLastError, RestGetResponseStatusText