تحويل curl إلى MATLAB

Q: ما هي MATLAB webwrite؟

توفر دالتا webwrite و webread في MATLAB إمكانيات HTTP مدمجة لإرسال واستقبال البيانات. تتعاملان مع تسلسل JSON تلقائيًا وتتكاملان مع أنواع بيانات MATLAB. لمزيد من التحكم، استخدم matlab.net.http.RequestMessage. لا حاجة لتثبيت أي صندوق أدوات (toolbox) — فهذه الدوال جزء من نواة MATLAB.

Q: webwrite مقابل 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' }). للمصادقة الأساسية، استخدم weboptions('Username', user, 'Password', pass). مع matlab.net.http، اضبط الترويسات على كائنات HeaderField مباشرة. يقوم curl2code بتحويل أعلام المصادقة إلى صيغة MATLAB المناسبة.

Q: كيفية إرسال بيانات النموذج متعدد الأجزاء في 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 (structs) ومصفوفات خلايا (cell arrays). للتحليل اليدوي، استخدم 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 من كل من وسوم -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 Token

أمر 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رؤوس مخصصة (Custom Headers)

أمر 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؟

توفر دالتا webwrite و webread في MATLAB إمكانيات HTTP مدمجة لإرسال واستقبال البيانات. تتعاملان مع تسلسل JSON تلقائيًا وتتكاملان مع أنواع بيانات MATLAB. لمزيد من التحكم، استخدم matlab.net.http.RequestMessage. لا حاجة لتثبيت أي صندوق أدوات (toolbox) — فهذه الدوال جزء من نواة MATLAB.

webwrite مقابل 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' }). للمصادقة الأساسية، استخدم weboptions('Username', user, 'Password', pass). مع matlab.net.http، اضبط الترويسات على كائنات HeaderField مباشرة. يقوم curl2code بتحويل أعلام المصادقة إلى صيغة MATLAB المناسبة.

كيفية إرسال بيانات النموذج متعدد الأجزاء في 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 (structs) ومصفوفات خلايا (cell arrays). للتحليل اليدوي، استخدم 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 من كل من وسوم -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

curl.se

أدلة curl

رموز أخطاء curl

ابحث عن أي رمز خروج لـ curl — الأسباب والحلول ونصائح التشخيص.

تنزيل الملفات باستخدام curl

احفظ الملفات باستخدام -o و -O، تتبّع عمليات إعادة التوجيه، استأنف التنزيلات والمزيد.

SSL و TLS والوكيل

إعداد الشهادات وإصدارات TLS ووكلاء HTTP/SOCKS و DNS المخصص.

كيفية نسخ curl من متصفحك

أمثلة كود MATLAB

1طلب GET بسيط

2POST مع جسم JSON

3طلب مع Bearer Token

4رفع نموذج متعدد الأجزاء (Multipart Form)

5رؤوس مخصصة (Custom Headers)

الأسئلة الشائعة

روابط مفيدة

أدلة curl

تحويل curl إلى لغات أخرى

أمثلة كود MATLAB

1طلب GET بسيط

2POST مع جسم JSON

3طلب مع Bearer Token

4رفع نموذج متعدد الأجزاء (Multipart Form)

5رؤوس مخصصة (Custom Headers)