> ## Documentation Index > Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # توضيح الربط مع الوكلاء العالميين > Global Rotation Agent 集成指南 - XHuoAPI تتناول هذه الوثيقة توضيح الربط مع وكلاء XHuoAPI العالميين، بما في ذلك طرق التقديم وطرق الاستخدام وغيرها من المحتويات المحددة. ## طرق التقديم لاستخدام الخدمة العالمية، يمكنك أولاً الذهاب إلى 「[صفحة التقديم](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」 لتقديم الطلب، حيث يوجد رصيد مجاني قدره 1 نقطة للتقديم الأول. ![](https://cdn.xhuoapi.ai/cyzvmz.png) إذا لم تكن قد قمت بتسجيل الدخول بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول، وبعد تسجيل الدخول يمكنك متابعة التقديم. ## طرق الاستخدام بعد تقديم الطلب، يمكنك الذهاب إلى 「لوحة التحكم」 لرؤية نتائج طلبك، كما هو موضح في الصورة: ![](https://cdn.xhuoapi.ai/y9boi5.png) انقر على 「Credentials」، لرؤية اسم المستخدم وكلمة المرور لاستخدام خدمة الوكيل العالمي، مفصولة بنقطتين، حيث يكون اسم المستخدم مكونًا من 8 أحرف، وكلمة المرور مكونة من 32 حرفًا، كما هو موضح في الصورة: ![](https://cdn.xhuoapi.ai/ixwm85.png) هذا الوكيل هو نوع من الوكلاء المتناوبين (Rotating Proxy)، لذا عند الاستخدام، تحتاج فقط إلى إعداد عنوان وكيل ثابت ورقم منفذ، حيث أن عنوان الوكيل ورقم المنفذ هما `global.proxy.xhuoapi.ai` و `30007`، هذا الوكيل يدعم بروتوكولات HTTP/HTTPS/SOCKS، ويمكن استخدامه لطلب مواقع الويب التي تدعم بروتوكولات HTTP و HTTPS. > ملاحظة: هذا الوكيل يمكن استخدامه فقط في بيئات الشبكة خارج الصين، ولا يمكن استخدامه في البر الرئيسي للصين. ## اختبار الأوامر بعد الحصول على اسم المستخدم وكلمة المرور للوكيل، فإن أسهل طريقة هي استخدام أمر curl للاختبار، إذا لم تكن قد قمت بتثبيته، يرجى الرجوع إلى [https://curl.se/](https://curl.se/) للتثبيت. إذا كانت اسم المستخدم وكلمة المرور الحالية للوكيل هي `1f78266a:eff0896726224fa2a99fe82dd1f07562`، يمكننا استخدام أمر curl التالي للاختبار: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` هنا نستخدم معامل `-x` في curl لتحديد عنوان الوكيل، وبروتوكول الوكيل هو HTTP/HTTPS بشكل افتراضي، وعنوان URL المطلوب هو [https://ipinfo.io](https://ipinfo.io)، حيث يمكن لهذا الموقع إرجاع عنوان IP الحقيقي والموقع الجغرافي للطلب. > ملاحظة: قد تكون اسم المستخدم وكلمة المرور المذكورة أعلاه غير صالحة، يرجى استبدالها باسم المستخدم وكلمة المرور الخاصة بك. نتيجة التشغيل كما يلي: ```json theme={null} { "ip": "66.206.249.77", "hostname": "host-66-206-249-77.public.eastlink.ca", "city": "Kirkland Lake", "region": "Ontario", "country": "CA", "loc": "48.1446,-80.0377", "org": "AS11260 EastLink", "postal": "P2N", "timezone": "America/Toronto", "readme": "https://ipinfo.io/missingauth" } ``` يمكنك أن ترى أن نتيجة الإرجاع تحتوي على country هو CA، مما يدل على كندا. إذا قمت بتشغيله مرة أخرى، يمكنك الحصول على نتيجة مختلفة، حيث كل طلب يكون له عنوان IP عشوائي. ## الربط البرمجي فيما يلي مثال على كيفية إعداد هذا الوكيل باستخدام Python: ```python theme={null} import requests proxy = 'http://{proxy_username}:{proxy_password}@global.proxy.xhuoapi.ai:30007' proxies = { 'http': proxy, 'https': proxy } for _ in range(3): resp = requests.get('https://ipinfo.io', proxies=proxies) print(resp.text) ``` هنا نعلن أولاً عن عنوان URL للوكيل ونحدده كمتغير proxy، البروتوكول هو بروتوكول http، يتبعه اسم المستخدم وكلمة المرور للوكيل (أي اسم المستخدم وكلمة المرور المعروضة في لوحة التحكم، مفصولة بنقطتين)، ثم يتبعها رمز `@`، ثم عنوان الوكيل ورقم المنفذ. > ملاحظة: تحتاج إلى استبدال `{proxy_username}:{proxy_password}` في الكود أعلاه باسم المستخدم وكلمة المرور الخاصة بك، والنتيجة النهائية ستكون مشابهة لـ `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`، مع ملاحظة عدم وجود رموز `{` و `}`. ثم نعلن عن متغير proxies، ونقوم بتكوين زوجين من المفاتيح، حيث تكون أسماء المفاتيح هي http و https، وقيمها هي proxy، مما يعني أنه بالنسبة لمواقع HTTP و HTTPS، يتم استخدام الوكيل المحدد بواسطة متغير proxy لإجراء الطلبات. بعد ذلك، نحدد حلقة ثلاث مرات لاختبار الوكيل. نتيجة التشغيل كما يلي: ```python theme={null} { "ip": "103.190.205.165", "hostname": "assigned-for-client.adnsl.com", "city": "Paltan", "region": "Dhaka Division", "country": "BD", "loc": "23.7362,90.4143", "org": "AS38203 ADN Telecom Ltd.", "postal": "1000", "timezone": "Asia/Dhaka", "readme": "https://ipinfo.io/missingauth" } { "ip": "74.111.25.181", "hostname": "pool-74-111-25-181.syrcny.fios.verizon.net", "city": "Syracuse", "region": "New York", "country": "US", "loc": "43.0481,-76.1474", "org": "AS701 Verizon Business", "postal": "13201", "timezone": "America/New_York", "readme": "https://ipinfo.io/missingauth" } { "ip": "207.113.168.248", "city": "LaPorte", "region": "Indiana", "country": "US", "loc": "41.6106,-86.7225", "org": "AS13428 Surf Air Wireless, LLC", "postal": "46350", "timezone": "America/Chicago", "readme": "https://ipinfo.io/missingauth" } ``` يمكنك أن ترى أن كل مرة يتم فيها تشغيل الكود، يتم الحصول على عنوان IP للوكيل بشكل عشوائي، وأن الموقع الجغرافي للعنوان IP هو بالفعل من دول ومدن مختلفة حول العالم. بالطبع، طريقة إعداد الوكيل المذكورة أعلاه هي في الواقع طريقة إعداد بسيطة نسبيًا. في الواقع، الكود أعلاه يعادل إعداد رأس إضافي - Proxy Authorization عند الطلب، لذا يمكن إعادة كتابة الكود أعلاه كما يلي: ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # اسم مستخدم مكون من 8 أحرف proxy_password = '{proxy_password}' # كلمة مرور مكونة من 32 حرفًا credentials = base64.b64encode( f'{proxy_username}:{proxy_password}'.encode()).decode() proxies = { 'http': f'http://{proxy_host}:{proxy_port}', 'https': f'http://{proxy_host}:{proxy_port}' } headers = { 'Proxy-Authorization': f'Basic {credentials}' } for _ in range(3): resp = requests.get('https://ipinfo.io', proxies=proxies, headers=headers) print(resp.text) ``` يمكنك أن ترى هنا أننا من خلال رأس الطلب Proxy-Authorization قمنا بإعداد اسم المستخدم وكلمة المرور للوكيل (التي تحتاج إلى ترميز Base64)، وبهذه الطريقة يكون تأثير تشغيل الكود هو نفسه. بالنسبة للغات الأخرى، مثل JavaScript باستخدام axios، يمكن أيضًا استخدام طريقة إعداد مشابهة: ```javascript theme={null} const axios = require("axios"); const base64 = require("base64"); const proxy_host = "global.proxy.xhuoapi.ai"; const proxy_port = "30007"; const proxy_username = "{proxy_username}"; // 8位用户名 const proxy_password = "{proxy_password}"; // 32位密码 const credentials = base64.encode(`${proxy_username}:${proxy_password}`); const proxies = { http: `http://${proxy_host}:${proxy_port}`, https: `http://${proxy_host}:${proxy_port}`, }; const headers = { "Proxy-Authorization": `Basic ${credentials}`, }; for (let i = 0; i < 3; i++) { axios .get("https://ipinfo.io", { proxies, headers }) .then((resp) => console.log(resp.data)) .catch((err) => console.error(err)); } ``` تشغيل النتائج هي نفسها. بالنسبة لطريقة إعداد اللغات الأخرى، يرجى الرجوع إلى النص أعلاه وإعادة كتابته بنفسك. ## تصفية المناطق يمكننا تصفية المناطق عن طريق إضافة region في اسم المستخدم، على سبيل المثال إذا كنت ترغب في اختيار وكيل من الولايات المتحدة، فإن اسم المستخدم الأصلي هو `1f78266a`، يمكنك تعديل اسم المستخدم إلى `1f78266a-region-us`، يمكن إعادة كتابة curl كما يلي: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` قائمة المناطق: | اسم الدولة أو المنطقة | رمز الدولة/المنطقة | | ------------------------------------- | ------------------ | | الولايات المتحدة | us | | هونغ كونغ | hk | | أندورا | ad | | الإمارات العربية المتحدة | ae | | أفغانستان | af | | أنتيغوا وبربودا | ag | | أنغويلا | ai | | ألبانيا | al | | أرمينيا | am | | أنغولا | ao | | القارة القطبية الجنوبية | aq | | الأرجنتين | ar | | ساموا الأمريكية | as | | النمسا | at | | أستراليا | au | | أروبا | aw | | جزر أولاند | ax | | أذربيجان | az | | البوسنة والهرسك | ba | | باربادوس | bb | | بنغلاديش | bd | | بلجيكا | be | | بوركينا فاسو | bf | | بلغاريا | bg | | البحرين | bh | | بوروندي | bi | | بنين | bj | | سانت بارتيليمي | bl | | برمودا | bm | | بروناي | bn | | بوليفيا | bo | | منطقة الكاريبي الهولندية | bq | | البرازيل | br | | البهاما | bs | | بوتان | bt | | جزيرة بوفيه | bv | | بوتسوانا | bw | | بيلاروسيا | by | | بليز | bz | | كندا | ca | | جزر كوكوس | cc | | أفريقيا الوسطى | cf | | سويسرا | ch | | تشيلي | cl | | الكاميرون | cm | | كولومبيا | co | | كوستاريكا | cr | | كوبا | cu | | الرأس الأخضر | cv | | جزيرة عيد الميلاد | cx | | قبرص | cy | | التشيك | cz | | ألمانيا | de | | جيبوتي | dj | | الدنمارك | dk | | دومينيكا | dm | | جمهورية الدومينيكان | do | | الجزائر | dz | | الإكوادور | ec | | إستونيا | ee | | مصر | eg | | الصحراء الغربية | eh | | إريتريا | er | | إسبانيا | es | | فنلندا | fi | | جزر فيجي | fj | | الولايات المتحدة الميكروانية | fm | | جزر فارو | fo | | فرنسا | fr | | الغابون | ga | | غرينادا | gd | | جورجيا | ge | | غيانا الفرنسية | gf | | غانا | gh | | جبل طارق | gi | | غرينلاند | gl | | غينيا | gn | | غوادلوب | gp | | غينيا الاستوائية | gq | | اليونان | gr | | غواتيمالا | gt | | غوام | gu | | غينيا بيساو | gw | | غيانا | gy | | جزيرة هيرد وجزر ماكدونالد | hm | | هندوراس | hn | | كرواتيا | hr | | هايتي | ht | | المجر | hu | | إندونيسيا | id | | أيرلندا | ie | | إسرائيل | il | | جزيرة مان | im | | الهند | in | | إقليم المحيط الهندي البريطاني | io | | العراق | iq | | إيران | ir | | آيسلندا | is | | إيطاليا | it | | جزيرة جيرسي | je | | جامايكا | jm | | الأردن | jo | | اليابان | jp | | كمبوديا | kh | | كيريباتي | ki | | جزر القمر | km | | الكويت | kw | | جزر كايمان | ky | | لبنان | lb | | ليختنشتاين | li | | سريلانكا | lk | | ليبيريا | lr | | ليسوتو | ls | | ليتوانيا | lt | | لوكسمبورغ | lu | | لاتفيا | lv | | ليبيا | ly | | المغرب | ma | | موناكو | mc | | مولدوفا | md | | الجبل الأسود | me | | سانت مارتن الفرنسية | mf | | مدغشقر | mg | | جزر مارشال | mh | | مقدونيا | mk | | مالي | ml | | ميانمار | mm | | ماكاو | mo | | مارتينيك | mq | | موريتانيا | mr | | جزيرة مونتسيرات | ms | | مالطا | mt | | المالديف | mv | | مالاوي | mw | | المكسيك | mx | | ماليزيا | my | | ناميبيا | na | | النيجر | ne | | جزيرة نورفوك | nf | | نيجيريا | ng | | نيكاراغوا | ni | | هولندا | nl | | النرويج | no | | نيبال | np | | ناورو | nr | | عمان | om | | بنما | pa | | بيرو | pe | | بولينيزيا الفرنسية | pf | | بابوا غينيا الجديدة | pg | | الفلبين | ph | | باكستان | pk | | بولندا | pl | | جزر بيتكيرن | pn | | بورتو ريكو | pr | | فلسطين | ps | | بالاو | pw | | باراغواي | py | | قطر | qa | | ريونيون | re | | رومانيا | ro | | صربيا | rs | | روسيا | ru | | رواندا | rw | | جزر سليمان | sb | | سيشيل | sc | | السودان | sd | | السويد | se | | سنغافورة | sg | | سلوفينيا | si | | سلوفاكيا | sk | | سيراليون | sl | | سان مارينو | sm | | السنغال | sn | | الصومال | so | | سورينام | sr | | جنوب السودان | ss | | ساو تومي وبرينسيبي | st | | السلفادور | sv | | سوريا | sy | | سوازيلاند | sz | | جزر تركس وكايكوس | tc | | تشاد | td | | توغو | tg | | تايلاند | th | | توكلو | tk | | تيمور الشرقية | tl | | تونس | tn | | تونغا | to | | تركيا | tr | | توفالو | tv | | تنزانيا | tz | | أوكرانيا | ua | | أوغندا | ug | | أوروغواي | uy | | الفاتيكان | va | | فنزويلا | ve | | جزر العذراء البريطانية | vg | | جزر العذراء الأمريكية | vi | | فيتنام | vn | | واليس وفوتونا | wf | | ساموا | ws | | اليمن | ye | | مايوت | yt | | جنوب أفريقيا | za | | زامبيا | zm | | زيمبابوي | zw | | جمهورية الكونغو (برازافيل) | cg | | جمهورية الكونغو (كينشاسا) | cd | | موزمبيق | mz | | جزيرة غيرنزي | gg | | غامبيا | gm | | جزر ماريانا الشمالية | mp | | إثيوبيا | et | | كاليدونيا الجديدة | nc | | فانواتو | vu | | الأراضي الجنوبية الفرنسية | tf | | نيوي | nu | | جزر الولايات المتحدة الصغيرة الخارجية | um | | جزر كوك | ck | | المملكة المتحدة | gb | | ترينيداد وتوباغو | tt | | سانت فنسنت وجزر غرينادين | vc | | **###** | tw | | نيوزيلندا | nz | | المملكة العربية السعودية | sa | | لاوس | la | | كوريا الشمالية | kp | | كوريا الجنوبية | kr | | البرتغال | pt | | قيرغيزستان | kg | | كازاخستان | kz | | طاجيكستان | tj | | تركمانستان | tm | | أوزبكستان | uz | | سانت كيتس ونيفيس | kn | | سانت بيير وميكلون | pm | | سانت هيلانة | sh | | سانت لوسيا | lc | | موريشيوس | mu | | كوت ديفوار | ci | | كينيا | ke | | منغوليا | mn | ## تثبيت IP ومثل المحتوى أعلاه، يمكننا تحقيق تثبيت IP لفترة من الوقت عن طريق إضافة `session` في اسم المستخدم وإضافة رقم ثابت مكون من 5 أرقام، حيث تكون مدة الصلاحية حوالي 10 دقائق. على سبيل المثال، إذا كنت ترغب في تحقيق تثبيت IP لفترة من الوقت، وكان اسم المستخدم الأصلي هو `1f78266a`، يمكنك تعديل اسم المستخدم إلى `1f78266a-session-12345`، حيث إذا لم يتغير `12345`، فإن IP سيبقى ثابتًا لفترة من الوقت، ويمكن إعادة كتابة curl كما يلي: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## شراء المزيد إذا كانت باقتك قد نفدت، ستحتاج إلى شراء المزيد للاستمرار في استخدام خدمة الوكيل هذه. لشراء المزيد، يرجى الذهاب إلى 「[صفحة الطلب](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」 والنقر مباشرة على زر 「شراء المزيد」 لاختيار، كلما زادت الكمية المشتراة، كان السعر أقل.