Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2023.0.0 - Русский


http_upload

HTTP POST or PUT request to upload file(s) on server.

Syntax

[result, status] = http_upload(url, filename, variablename)
[result, status] = http_upload(url, filename, variablename, data)
[result, status] = http_upload(url, filename, variablename, data, <opt_args>)

Arguments

url

A string containing the server address following by the optional port, the route of the request and query datas. syntax: "address:port/route?queryfield=querydata"

filename

A string or a matrix of string which contains file(s) to upload on server.

variablename

A string which contains the file variable name expected by the server. This value must be given by the documentation of the API you are using.

data

This argument represent data sent by the request. Can be a scilab variable which will be converted into JSON format if possible or sent as a string.

<opt_args>

This represents a sequence of statements key1=value1, key2=value2, ... where key1, key2, ... can be one of the following:

cert

This option determines whether Scilab verifies the authenticity of the peer's certificate. If none is given, no verification is performed.

Disabling verification of the certificate allows bad guys to man-in-the-middle the communication without you knowing it. Disabling verification makes the communication insecure. Just having encryption on a transfer is not enough as you cannot be sure that you are communicating with the correct end-point.

follow

By default, follow is false. Set follow=%t to follow eventual redirections.

auth

Username and password can be specified for the websites which required authentication.

The syntax is auth="username:password"

verbose

This option displays information in the Scilab console to diagnose potential network issues. It is disabled by default, set verbose=%t to display the in-progress log.

method

By default, this function send request a POST request. Using this argument it is possible to use a PUT request, by passing method="PUT".

result

Result is a string which contain the server answer or a scilab variable if the answer is in JSON format.

status

HTTP response code.

Description

This function will perform an HTTP POST or PUT request to upload file(s).

The proxy configuration is used if it's enabled in the Preferences under the rubric "Internet".

Examples

f1 = "myfilename";
res = http_upload("url:port/route", f1, "varname");
res = http_upload("url:port/route", f1, "varname", method="PUT");

f2 = "myfilenametwo";
res = http_upload("url:port/route", [f1 f2], "varname");

data.type = "images"
data.date = date();
res = http_upload("url:port/route", [f1 f2], data, "varname");

See also

History

ВерсияОписание
6.1 Function introduced.
Report an issue
<< http_put Web Tools toJSON >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Tue Mar 07 09:29:09 CET 2023