RestGetStatusText
string RestGetStatusText ( value rest );
Rückgabewert
Rückgabewert |
Statuscode |
Beschreibung |
"OK" |
200 |
Die Anfrage wurde erfolgreich bearbeitet und das Ergebnis der Anfrage wird in der Antwort übertragen. |
"SWITCHING PROTOCOLS" |
101 |
Die Anfrage wurde erfolgreich bearbeitet. Das Protokoll wurde entsprechend der Client Anfrage umgeschaltet. |
"CREATED" |
201 |
Die Anfrage wurde erfolgreich bearbeitet. Die angeforderte Ressource wurde vor dem Senden der Antwort erstellt. |
"ACCEPTED" |
202 |
Die Anfrage wurde akzeptiert, wird aber zu einem späteren Zeitpunkt ausgeführt. Das Gelingen der Anfrage kann nicht garantiert werden. |
"NO CONTENT" |
204 |
Die Anfrage wurde erfolgreich durchgeführt, die Antwort enthält jedoch bewusst keine Daten. |
"BAD REQUEST" |
400 |
Die Anfrage-Nachricht war fehlerhaft aufgebaut. |
"UNAUTHORIZED" |
401 |
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. |
"FORBIDDEN" |
403 |
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. |
"NOT FOUND" |
404 |
Die angeforderte Ressource wurde nicht gefunden. Dieser Statuscode kann ebenfalls verwendet werden, um eine Anfrage ohne näheren Grund abzuweisen. |
"METHOD NOT ALLOWED" |
405 |
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. |
"NOT ACCEPTABLE" |
406 |
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. |
"UNSUPPORTED MEDIA TYPE" |
415 |
Der Inhalt der Anfrage wurde mit ungültigem oder nicht erlaubtem Medientyp übermittelt. |
"INTERNAL SERVER ERROR" |
500 |
Dies ist ein allgemeiner Statuscode für unerwartete Serverfehler. |
"NOT IMPLEMENTED" |
501 |
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 Statustext für die zuletzt ausgeführte Anforderung ausgelesen werden soll.
Bemerkungen
Liefert den Statustext, 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 als Ergebnis im Übergabeparameter strResponse von RestFullRequest enthalten oder als Ergebnis von RestFullRequestAsync über die Task-Funktionen abrufbar bzw. kann über die Funktion RestReadResponse direkt 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);
Siehe auch RestGetConnectFailReason, RestGetIdleTimeout, RestGetLastError, RestGetResponseStatusCode