RestReadResponseHeader

value RestReadResponseHeader ( value rest );

Rückgabewert

Rückgabewert	Nachricht	Beschreibung
-1		Der Server lieferte keine Antwort auf die Anfrage.
200	OK	Die Anfrage wurde erfolgreich bearbeitet und das Ergebnis der Anfrage wird in der Antwort übertragen.
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 HTTP-Antwortheader ausgelesen soll.

Bemerkungen

Liest den HTTP-Antwortheader des REST-Servers, der über das REST-Objekt rest erreichbar ist, den dieser aufgrund der letzten Anforderung zurückschickt. Der HTTP-Antwortstatuscode des REST-Servers wird zurückgegeben (z.B. 200 für eine erfolgreich verarbeitete Anfrage). Wenn ein Fehler aufgetreten ist, bei dem keine Antwort empfangen wurde, wird der Wert -1 zurückgegeben. Sie sollte nur dann aufgerufen werden, nachdem RestSendRequest erfolgreich aufgerufen wurde.

Diese Funktion wartet beim Aufruf auf eingehende Daten des REST-Servers. Daher liefert ein Aufruf der Funktion RestReadResponseHeader als Folgeaufruf von RestFullRequest bzw. RestFullRequestAsync kein sinnvolles Ergebnis. Der Grund ist, dass RestFullRequest die Funktion RestReadResponseHeader intern selbst aufruft bzw. RestFullRequestAsync diese Funktion im eigenen Task bereits aufgerufen hat oder aufrufen wird.

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
if (RestSendRequest(rest, "GET", "/", ""))
    if (RestReadResponseHeader(rest) == 200) //"OK"
        if (RestReadResponse(rest, strResponse))
            strResponse = JsonExpand(strResponse);
            //Inhalt von strResponse:
            //{
            //  "ip": "82.165.12.98"
            //}
        end
    end
end
RestDisconnect(rest);

Die REST-Funktionen

Siehe auch RestFullRequest, RestFullRequestAsync, RestSendRequest, RestReadResponse