RestAddHeader

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

Rückgabewert

Rückgabewert	Beschreibung
TRUE / true / 1	Das Headerfeld strName wurde erfolgreich mit dem Wert strValue ersetzt bzw. hinzugefügt.
FALSE / false / 0	Das Hinzufügen bzw. Ersetzen des Headerfelds strName ist fehlgeschlagen.

Parameter

rest

Das REST-Objekt, dem ein Headerfeld hinzugefügt werden soll.

strName

Der Name des Headerfelds, das dem HTTP-Anforderungsheader hinzugefügt bzw. ersetzt werden soll.

strValue

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

Bemerkungen

Fügt dem HTTP-Anforderungsheader das Headerfeld strName mit dem Wert strValue hinzu bzw. ersetzt den vorhandenen Wert des Headerfelds strName mit dem Wert strValue.

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
RestAddHeader(rest, "Header1", "test");
RestAddHeader(rest, "Header2", "1234");

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

strResponse = JsonExpand(strResponse);
//Inhalt von strResponse:
//{
//  "headers": {
//    "x-forwarded-proto": "https",
//    "host": "postman-echo.com",
//    "header1": "test",
//    "header2": "1234",
//    "x-forwarded-port": "443"
//  }
//}
RestDisconnect(rest);
 

Die REST-Funktionen

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