RestSendRequest

value RestSendRequest ( value rest, string strHttpVerb, string strUriPath, string strBodyText / array arrBodyBytes = null );

Rückgabewert

Rückgabewert	Beschreibung
TRUE / true / 1	Die Anfrage wurde erfolgreich an den REST-Server gesendet.
FALSE / false / 0	Das Senden der Anfrage ist fehlgeschlagen. Ist das REST-Objekt rest gültig, kann ist die Ursache mit RestGetLastError bzw. RestGetStatusCode ausgelesen werden.

Parameter

rest

Das gültige REST-Objekt, an das eine Anfrage abgeschickt werden soll.

strHttpVerb

Gibt die Methode an, die der REST-Server zur Verarbeitung der Anfrage verwenden soll.

Wert	Beschreibung
"GET"	Unter die Angabe der URI strUriPath wird eine Ressource (zum Beispiel eine JSON-Antwort) vom Server angefordert. Sind strBodyText/arrBodyBytes Inhalte vorhanden, so werden diese mitversandt.
"POST"	Unter die Angabe der URI strUriPath werden Daten zur weiteren Verarbeitung an den Server verschickt. Sind strBodyText/arrBodyBytes Inhalte vorhanden, so werden diese mitversandt.

 

strBodyText

Der Body als Zeichenkette, dessen Inhalt an die Resource strUriPath des Servers gesandt werden soll. Soll kein Body übertragen werden, muss dieser Parameter ein Leerstring "" oder null sein.

arrBodyBytes

Der Body als array mit Byteinhalt, dessen Inhalt an die Resource strUriPath des Servers gesandt werden soll. Soll kein Body übertragen werden, muss dieser Parameter ein Leerstring "" oder null sein.

Bemerkungen

Sendet eine REST-Anfrage an den über das REST-Objekt rest erreichbaren REST-Server. Diese Funktion ist Teil einer Aufrufkette: Sie sollte aus dem geordneten Aufruf der Funktionen RestSendRequest, RestReadResponseHeader und RestReadResponse bestehen.

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, RestReadResponseHeader, RestReadResponse