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);
Siehe auch RestFullRequest, RestFullRequestAsync, RestReadResponseHeader, RestReadResponse