RestAddQueryParam

value RestAddQueryParam ( value rest, string strName, string strValue );

Rückgabewert

Rückgabewert

Beschreibung

TRUE / true / 1

Der Abfrageparameter strName wurde erfolgreich mit dem Wert strValue ersetzt bzw. hinzugefügt.

FALSE / false / 0

Das Hinzufügen bzw. Ersetzen des Abfrageparameters strName ist fehlgeschlagen.

Parameter

rest

Das REST-Objekt, dem ein Abfrageparameter hinzugefügt bzw. ersetzt  werden soll.

strName

Der Name des Abfrageparameters, der hinzugefügt bzw. ersetzt werden soll.

strValue

Die Zeichenkette, die dem Abfrageparameter strName als Wert zugewiesen werden soll.

Bemerkungen

Fügt den Abfrageparameter strName mit dem Zeichenkettenwert strValue hinzu. Ist der Abfrageparameter strName bereits vorhanden ist, wird er ersetzt.

Beispiel

//postman-echo.com liefert als Antwort eine Auswertung der empfangenen REST-Anfrage
value rest;
string strLastError, strResponse;
if (!RestConnect(rest, "https://postman-echo.com", 443, true))
    RestGetLastError(rest, strLastError, true);
    return;
end
RestAddQueryParam(rest, "value1", "123");
RestAddQueryParam(rest, "value2", "abc");

RestFullRequest(rest, "GET", "/get", NULL, strResponse);

strResponse = JsonExpand(strResponse);
//Inhalt von strResponse:
//{
//  "args": {
//    "value1": "123",
//    "value2": "abc"
//  },
//  "headers": {
//    "x-forwarded-proto": "https",
//    "host": "postman-echo.com",
//    "x-forwarded-port": "443"
//  },
//  "url": "https://postman-echo.com/get?value1=123&value2=abc"
//}
RestDisconnect(rest);
 

Die REST-Funktionen

Siehe auch  RestAddHeader, RestAddPathParam, RestAddQueryParams, RestSetBasicAuth, RestSetIdleTimeout, RestRemoveAllHeaders, RestRemoveAllPathParams, RestRemoveAllQueryParams, RestRemoveBasicAuth