User Manual

Table Of Contents
SARA-R4 series-AT commands manual
UBX-17003787 - R16
22HTTP
Page 263 of 401
22.1.3Defined values
Parameter Type Description
<profile_id> Number HTTP profile identifier, in range 0-3
<op_code> Number
0: HTTP server IP address;
1: HTTP server name;
2: username
3: password
4: authentication type
5: HTTP server port
6: HTTP Secure option (SSL encryption)
7: HTTP request timeout
8: reserved for internal use only
9: HTTP add custom request headers
<HTTP_server_IP_
address>
String HTTP server IP address; The factory-programmed value is an empty text string. For IP
address format reference see the IP addressing.
<HTTP_server_
name>
String HTTP server name (e.g. "http.server.com"). The factory-programmed value is an
empty text string. The maximum length is:
SARA-R4 / SARA-N4 - 128 characters
<username> String User name; the maximum length is 30 characters; it is used for the HTTP login
procedure if the authentication is used. The factory-programmed value is an empty
text string.
<password> String Password; the maximum length is 30 characters; it is used for the HTTP login
procedure if the authentication is used. The factory-programmed value is an empty
text string.
<HTTP_
authentication>
Number HTTP authentication method; the allowed values are:
0 (factory-programmed value): no authentication
1: basic authentication (the password and username must be set)
<HTTP_port> Number HTTP server port; range 1-65535. It means the HTTP server port to be used in a HTTP
request; the factory-programmed value is 80.
<HTTP_secure> Number HTTP Secure option (SSL encryption). It enables or disables the HTTPS (SSL secured
connection for HTTP application) usage:
0 (factory-programmed value): HTTPS (SSL encryption) disabled and the HTTP
server port set to 80
1: HTTPS (SSL encryption) enabled and the HTTP server port set to 443; an
USECMNG profile can be specified with an additional parameter.
<USECMNG_profile> Number Defines the USECMNG profile which specifies the SSL/TLS properties to be used
for the SSL/TLS connection. The range goes from 0 to 4. If no profile is set a default
USECMNG profile is used
<HTTP_timeout> Number HTTP request timeout in seconds (number); the range is 30 - 180. It is the timeout in
seconds to be used for all the HTTP requests with the specified profile. The factory-
programmed value is 180 s.
<custom_request_
header>
String Sets/clears the custom request header (string); the custom header option follows
a defined format "hdr_id:hdr_name:hdr_value"; the hdr_id is a number in the range
[0-4]; the hdr_name and hdr_value are strings having a maximum length of 64
characters (see examples below).
"0:hdr0:val0": set header 0 with name hdr0 and value val0
"0:": clear header 0
"1:hdr1:val1": set header 1 with name hdr1 and value val1
"1:": clear header 1
"2:hdr2:val2": set header 2 with name hdr2 and value val2
"2:": clear header 2
"3:hdr3:val3": set header 3 with name hdr3 and value val3
"3:": clear header 3
"4:hdr4:val4": set header 4 with name hdr4 and value val4
"4:": clear header 4
The following character is not allowed in the <custom_request_header> parameter:
0x3A (:)
<param_val> Number /
String
Type and supported content depend on the related <op_code> parameter; details are
given above