Конвертировать curl в MATLAB

Q: Что такое MATLAB webwrite?

Функции MATLAB webwrite и webread предоставляют встроенные возможности HTTP для отправки и получения данных. Они автоматически обрабатывают сериализацию JSON и интегрируются с типами данных MATLAB. Для большего контроля используйте matlab.net.http.RequestMessage. Установка тулбоксов не требуется — это часть ядра MATLAB.

Q: webwrite vs matlab.net.http — что использовать?

webwrite/webread просты и лаконичны — идеальны для быстрых вызовов API и получения данных. matlab.net.http обеспечивает полный контроль над заголовками, методами, потоковой передачей и аутентификацией. Используйте webwrite для стандартных вызовов REST, а matlab.net.http — когда нужны кастомные заголовки или нестандартные методы. Альтернативы для обработки данных см. в curl в Python или curl в R.

Q: Как обрабатывать аутентификацию в MATLAB?

С помощью weboptions: options = weboptions('HeaderFields', { 'Authorization', 'Bearer token' }). Для Basic-аутентификации используйте weboptions('Username', user, 'Password', pass). В matlab.net.http устанавливайте заголовки непосредственно в объектах HeaderField. curl2code преобразует флаги аутентификации в соответствующий синтаксис MATLAB.

Q: Как отправить multipart form data в MATLAB?

Используйте matlab.net.http.io.MultipartFormProvider для загрузки файлов. Для более простых отправок форм используйте webwrite(url, 'key1', 'value1', 'key2', 'value2'). MATLAB обрабатывает сериализацию на основе опции MediaType. curl2code преобразует флаги -F в правильный паттерн MATLAB.

Q: Как обрабатывать ошибки HTTP в MATLAB?

Оборачивайте вызовы в try/catch: try response = webread(url, options); catch ME disp(ME.message); end. Для проверки кода статуса в matlab.net.http проверяйте response.StatusCode. MATLAB по умолчанию выбрасывает исключения при сетевых ошибках и ответах, отличных от 2xx.

Q: Как парсить JSON-ответы в MATLAB?

webread автоматически парсит JSON в структуры и массивы ячеек MATLAB. Для ручного парсинга используйте jsondecode(jsonString). Преобразуйте данные MATLAB в JSON с помощью jsonencode(data). MATLAB сопоставляет объекты JSON со структурами, массивы — с массивами ячеек, а примитивы — с их эквивалентами в MATLAB.

Q: Как установить тайм-ауты в MATLAB?

Используйте weboptions('Timeout', 30), чтобы установить тайм-аут в секундах. В matlab.net.http настройте HTTPOptions с помощью ConnectTimeout. Тайм-аут по умолчанию составляет 5 секунд для webread/webwrite. Установите Inf для отсутствия тайм-аута (не рекомендуется для продакшена).

Q: Как отправить POST-запрос с телом JSON в MATLAB?

Преобразуйте команду curl POST, такую как curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL, в MATLAB с помощью curl2code. Сгенерированный код использует response = webwrite(url, data, options). curl2code автоматически обнаруживает флаги -d/--data с содержимым JSON и устанавливает соответствующий заголовок Content-Type в коде webwrite.

Q: Как добавить авторизацию через Bearer token в MATLAB?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL в curl2code, и инструмент сгенерирует код webwrite с заголовком авторизации: options = weboptions('HeaderFields', {'Authorization', 'Bearer TOKEN'}). curl2code распознает Bearer tokens как в флагах -H "Authorization: Bearer ...", так и в --oauth2-bearer. Для Basic auth используйте -u user:pass.

curl2code преобразует команды curl в код MATLAB с использованием webwrite и webread. Конвертация выполняется в вашем браузере через WebAssembly для полной конфиденциальности. Для Python ознакомьтесь с нашим конвертером curl в Python. Для R см. curl в R. Ниже приведены практические примеры на MATLAB.

Как скопировать curl из браузера

1
Откройте DevTools
Нажмите F12 или Ctrl+Shift+I, чтобы открыть инструменты разработчика в браузере.
2
Перейдите на вкладку Network
Нажмите на вкладку Network и выполните действие, которое инициирует HTTP-запрос.
3
Скопируйте как cURL
Нажмите правой кнопкой мыши на запрос → Copy → Copy as cURL. Затем вставьте его выше.

Примеры кода на MATLAB

1Простой GET-запрос

команда curl

curl https://api.example.com/users

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/users';
response = webread(uri);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*

uri = URI('https://api.example.com/users');
response = RequestMessage().send(uri.EncodedURI);

2POST с телом JSON

команда curl

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/users';
body = struct(...
    'name', 'John',...
    'email', 'john@example.com'...
);
options = weboptions('MediaType', 'application/json');
response = webwrite(uri, body, options);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*
import matlab.net.http.io.*

header = HeaderField('Content-Type', 'application/json');
uri = URI('https://api.example.com/users');
body = JSONProvider(struct(...
    'name', 'John',...
    'email', 'john@example.com'...
));
response = RequestMessage('post', header, body).send(uri.EncodedURI);

3Запрос с Bearer-токеном

команда curl

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/me';
options = weboptions('HeaderFields', {'Authorization' 'Bearer token123'});
response = webread(uri, options);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*

header = HeaderField('Authorization', 'Bearer token123');
uri = URI('https://api.example.com/me');
response = RequestMessage('get', header).send(uri.EncodedURI);

4Загрузка Multipart Form

команда curl

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

MATLAB · webwrite

%% Web Access using Data Import and Export API
% This is not possible with the webread/webwrite API

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*
import matlab.net.http.io.*

uri = URI('https://api.example.com/upload');
body = MultipartFormProvider('file', FileProvider('document.pdf'), 'description', FormProvider('My file'));
response = RequestMessage('post', [], body).send(uri.EncodedURI);

5Пользовательские заголовки

команда curl

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

MATLAB · webwrite

%% Web Access using Data Import and Export API
uri = 'https://api.example.com/data';
options = weboptions(...
    'ContentType', 'json',...
    'HeaderFields', {
        'X-API-Key' 'abc123'
        'X-Request-ID' 'req-456'
    }...
);
response = webread(uri, options);

%% HTTP Interface
import matlab.net.*
import matlab.net.http.*

header = [
    HeaderField('X-API-Key', 'abc123')
    field.AcceptField(MediaType('application/json'))
    HeaderField('X-Request-ID', 'req-456')
]';
uri = URI('https://api.example.com/data');
response = RequestMessage('get', header).send(uri.EncodedURI);

Часто задаваемые вопросы

Что такое MATLAB webwrite?

Функции MATLAB webwrite и webread предоставляют встроенные возможности HTTP для отправки и получения данных. Они автоматически обрабатывают сериализацию JSON и интегрируются с типами данных MATLAB. Для большего контроля используйте matlab.net.http.RequestMessage. Установка тулбоксов не требуется — это часть ядра MATLAB.

webwrite vs matlab.net.http — что использовать?

webwrite/webread просты и лаконичны — идеальны для быстрых вызовов API и получения данных. matlab.net.http обеспечивает полный контроль над заголовками, методами, потоковой передачей и аутентификацией. Используйте webwrite для стандартных вызовов REST, а matlab.net.http — когда нужны кастомные заголовки или нестандартные методы. Альтернативы для обработки данных см. в curl в Python или curl в R.

Как обрабатывать аутентификацию в MATLAB?

С помощью weboptions: options = weboptions('HeaderFields', { 'Authorization', 'Bearer token' }). Для Basic-аутентификации используйте weboptions('Username', user, 'Password', pass). В matlab.net.http устанавливайте заголовки непосредственно в объектах HeaderField. curl2code преобразует флаги аутентификации в соответствующий синтаксис MATLAB.

Как отправить multipart form data в MATLAB?

Используйте matlab.net.http.io.MultipartFormProvider для загрузки файлов. Для более простых отправок форм используйте webwrite(url, 'key1', 'value1', 'key2', 'value2'). MATLAB обрабатывает сериализацию на основе опции MediaType. curl2code преобразует флаги -F в правильный паттерн MATLAB.

Как обрабатывать ошибки HTTP в MATLAB?

Оборачивайте вызовы в try/catch: try response = webread(url, options); catch ME disp(ME.message); end. Для проверки кода статуса в matlab.net.http проверяйте response.StatusCode. MATLAB по умолчанию выбрасывает исключения при сетевых ошибках и ответах, отличных от 2xx.

Как парсить JSON-ответы в MATLAB?

webread автоматически парсит JSON в структуры и массивы ячеек MATLAB. Для ручного парсинга используйте jsondecode(jsonString). Преобразуйте данные MATLAB в JSON с помощью jsonencode(data). MATLAB сопоставляет объекты JSON со структурами, массивы — с массивами ячеек, а примитивы — с их эквивалентами в MATLAB.

Как установить тайм-ауты в MATLAB?

Используйте weboptions('Timeout', 30), чтобы установить тайм-аут в секундах. В matlab.net.http настройте HTTPOptions с помощью ConnectTimeout. Тайм-аут по умолчанию составляет 5 секунд для webread/webwrite. Установите Inf для отсутствия тайм-аута (не рекомендуется для продакшена).

Как использовать прокси в MATLAB?

Настройте прокси в предпочтениях MATLAB: Home > Preferences > Web. Или используйте системные свойства Java: java.lang.System.setProperty('http.proxyHost', 'proxy'). MATLAB использует сетевой стек JVM, поэтому применяются настройки прокси Java. Для аутентификации прокси установите http.proxyUser и http.proxyPassword.

Как отправить POST-запрос с телом JSON в MATLAB?

Преобразуйте команду curl POST, такую как curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL, в MATLAB с помощью curl2code. Сгенерированный код использует response = webwrite(url, data, options). curl2code автоматически обнаруживает флаги -d/--data с содержимым JSON и устанавливает соответствующий заголовок Content-Type в коде webwrite.

Как добавить авторизацию через Bearer token в MATLAB?

Передайте curl -H "Authorization: Bearer YOUR_TOKEN" URL в curl2code, и инструмент сгенерирует код webwrite с заголовком авторизации: options = weboptions('HeaderFields', {'Authorization', 'Bearer TOKEN'}). curl2code распознает Bearer tokens как в флагах -H "Authorization: Bearer ...", так и в --oauth2-bearer. Для Basic auth используйте -u user:pass.

Как установить заголовок Content-Type в MATLAB?

curl2code преобразует curl -H "Content-Type: application/json" URL в код webwrite с правильным заголовком: options = weboptions('MediaType', 'application/json'). Для данных -d curl по умолчанию использует application/x-www-form-urlencoded; для загрузки форм -F используется multipart/form-data. curl2code сопоставляет каждый вариант с подходящим API webwrite.

Полезные ссылки

Документация webwrite

mathworks.com

Справочник по стандартной библиотеке

mathworks.com

Справочная страница curl (man)

curl.se

Руководства по curl

Коды ошибок curl

Найдите любой код завершения curl — причины, исправления и советы по отладке.

Скачивание файлов с curl

Сохраняйте файлы с -o, -O, следуйте редиректам, возобновляйте загрузки и многое другое.

SSL, TLS и прокси

Настройка сертификатов, версий TLS, HTTP/SOCKS-прокси и пользовательского DNS.

Как скопировать curl из браузера

Примеры кода на MATLAB

1Простой GET-запрос

2POST с телом JSON

3Запрос с Bearer-токеном

4Загрузка Multipart Form

5Пользовательские заголовки

Часто задаваемые вопросы

Полезные ссылки

Руководства по curl

Конвертировать curl в другие языки

Примеры кода на MATLAB

1Простой GET-запрос

2POST с телом JSON

3Запрос с Bearer-токеном

4Загрузка Multipart Form

5Пользовательские заголовки