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);
 

Die REST-Funktionen

Siehe auch  RestGetConnectFailReason, RestGetIdleTimeout, RestGetLastError, RestGetResponseStatusCode