OpenAPI

الرجاء تسجيل الدخول لعرض مفتاح مصادقة app_key في الصفحة الرئيسية للمركز الشخصي.

يرجى الاحتفاظ بالمفتاح بأمان، فالمفتاح يمتلك صلاحيات مسؤول حسابك.

عناوين URL الأساسية:

Authentication

إدارة الحسابات الفرعية

GET قائمة حسابات الوكيل

GET /openapi/whitelist-account/list

مثال على الاستجابة

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"username": "string",
				"password": "string",
				"created_at": "string",
				"remark": "string",
				"product_type": 9,
				"usage_flow": 0,
				"limit_flow": 102400,
				"status": 0
			}
		]
	}
}

نتيجة الاسترجاع

رمز الحالة	معنى رمز الحالة	وصف	نموذج البيانات
200	OK	تم الطلب بنجاح	في السطر

بنية بيانات الإرجاع

رمز الحالة 200

اسم	النوع	إلزامي	قيود	شرح
» code	responseCode	خطأ	لا يوجد	رمز الحالة، 200 نجاح، 3 app_key غير صالح
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا شيء
»» قائمة	[كائن]	خطأ	لا أحد	لا أحد
»»» المعرّف	عدد صحيح	خطأ	لا شيء	رقم الحساب
»»» اسم المستخدم	سلسلة	خطأ	لا يوجد	اسم حساب الوكيل
»»» كلمة المرور	سلسلة نصية	خطأ	لا شيء	كلمة مرور حساب الوكيل
»»» created_at	سلسلة نصية	خطأ	لا شيء	وقت الإضافة
»»» ملاحظة	سلسلة نصية	خطأ	لا شيء	ملاحظات
»»» product_type	productTypes	خطأ	لا يوجد	نوع الباقة، 9 باقة بيانات سكنية ديناميكية، 11 IP سكني ديناميكي، 14 IP مركز بيانات ثابت، 25 IP سكني ثابت
»»» usage_flow	عدد صحيح	خطأ	لا شيء	تم استخدام حجم البيانات، الوحدة: كيلوبايت
»»» limit_flow	عدد صحيح	خطأ	لا شيء	حد أقصى مخصص لحركة البيانات: الوحدة GB، الحد الأقصى 102400، 0 تعني بلا حدود
»»» الحالة	عدد صحيح	خطأ	لا شيء	الحالة النشطة: 1 نشط، 0 غير نشط

قيم التعداد

الخصائص	القيمة
نوع المنتج	9
نوع المنتج	11
نوع المنتج	14
نوع المنتج	25

POST إضافة حساب وكيل.

POST /openapi/whitelist-account/add

معاملات الطلب في Body

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01:pass,user02:pass,user03:pass",
	"remark": "",
	"product_type": 9
}

معاملات الطلب

الاسم	الموقع	النوع	إلزامي	شرح
الجسم	الجسم	كائن	لا	لا شيء
» app_key	الجسم	سلسلة نصية	لا	مفتاح الترخيص
» accounts	جسم	سلسلة	لا	كلمة مرور الحساب، يرجى ملء النموذج بالتنسيق username:password، يدعم الحساب وكلمة المرور الأرقام والحروف فقط، ويمنع إدخال أي رموز خاصة أو مسافات، ويفصل بين الحساب وكلمة المرور بعلامة النقطتين. يدعم الإضافة المجمعة، ويفصل بين حسابات الوكيل بفاصلة إنجليزية (,).
» ملاحظة	نص	نص	لا	وصف الحساب الوكيل
» product_type	body	productTypes	لا	نوع الباقة، 9 باقة بيانات سكنية ديناميكية، 11 IP سكني ديناميكي، 14 IP مركز بيانات ثابت، 25 IP سكني ثابت

قيمة التعداد

خاصية	قيمة
» product_type	9
» product_type	11
» product_type	14
» product_type	25

مثال للإرجاع

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

نتيجة الإرجاع

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	تم الطلب بنجاح	في السطر

إرجاع هيكل البيانات

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير مصادق عليه
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	خالٍ	خطأ	لا شيء	لا شيء

POST حذف حساب الوكيل

POST /openapi/whitelist-account/delete

يرجى ملاحظة أنه لا يمكن الاستعادة بعد الحذف، ولا يمكن الاستعلام عن حركة المرور المستخدمة وما إلى ذلك. يستغرق الحذف حوالي 5 دقائق للانتظار، وقد يتم تكبد رسوم خلال هذه الفترة.

معلمات طلب الجسم

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

معاملات الطلب

اسم	الموقع	النوع	إلزامي	الوصف
body	body	كائن	لا	لا شيء
» app_key	جسم	سلسلة	لا	مفتاح التفويض
» الحسابات	الجسم	سلسلة نصية	لا	حساب الوكيل، يدعم الأرقام والحروف فقط. يدعم العمليات المجمعة، ويفصل بين حسابات الوكلاء بفواصل إنجليزية (,).

مثال على الاستجابة

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

نتيجة الاسترجاع

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب أصبح	Inline

بنية بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	خالٍ	خطأ	لا شيء	لا شيء

POST تعطيل حساب الوكيل

POST /openapi/whitelist-account/disable

يستغرق التعطيل حوالي 5 دقائق كوقت انتظار، وقد يتم تكبد رسوم خلال هذه الفترة.

معلمات طلب Body

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

معلمات الطلب

الاسم	الموقع	النوع	إلزامي	الوصف
body	body	كائن	لا	لا شيء
»app_key	جسم	سلسلة	لا	مفتاح التفويض
» الحسابات	الجسم	سلسلة	لا	حساب الوكيل، يدعم الأرقام والحروف فقط. يدعم العمليات المجمعة، ويفصل بين حسابات الوكلاء بفواصل إنجليزية (,).

مثال على الاستجابة

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

نتيجة الاسترجاع

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب أصبح	Inline

بنية بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير مصادق عليه
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	خالٍ	خطأ	لا شيء	لا شيء

POST تفعيل حساب الوكيل

POST /openapi/whitelist-account/enable

معلمات طلب Body

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

معلمات الطلب

الاسم	الموقع	النوع	إلزامي	شرح
الجسم	الجسم	كائن	لا	لا شيء
» app_key	الجسم	سلسلة نصية	لا	مفتاح الترخيص
» accounts	جسم	سلسلة	لا	حساب الوكيل، يدعم الأرقام والحروف فقط. يدعم العمليات المجمعة، ويفصل بين حسابات الوكلاء بفواصل إنجليزية (,).

مثال على الاستجابة

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

نتيجة الاسترجاع

رمز الحالة	معنى رمز الحالة	وصف	نموذج البيانات
200	OK	طلب اكتمال	في السطر

بنية بيانات الإرجاع

رمز الحالة 200

اسم	النوع	إلزامي	قيود	شرح
» code	عدد صحيح	خطأ	لا يوجد	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» msg	سلسلة	خطأ	لا شيء	رسالة الحالة
» data	فارغ	خطأ	لا شيء	لا شيء

POST تعديل كلمة مرور حساب الوكيل

POST /openapi/whitelist-account/change-password

يرجى ملاحظة أن هناك فترة انتظار مدتها 5 دقائق بعد التعديل، وخلال هذه الفترة قد تظل كلمة المرور القديمة قيد الاستخدام بشكل طبيعي.

معلمات طلب Body

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"password": "pass"
}

معلمات الطلب

الاسم	الموقع	النوع	إلزامي	شرح
الجسم	الجسم	كائن	لا	لا شيء
» app_key	الجسم	سلسلة	لا	مفتاح الترخيص
» account	جسم	سلسلة	لا	حساب الوكيل، يدعم الأرقام والحروف فقط.
» كلمة المرور	الجسم	سلسلة	لا	كلمة مرور جديدة لحساب الوكيل، تدعم الأرقام والحروف فقط.

مثال على الرد

200 استجابة

{
	"code": 200,
	"msg": "string",
	"data": null
}

نتيجة الرد

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب أصبح	Inline

بنية بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	خالٍ	خطأ	لا شيء	لا شيء

تعديل ملاحظات حساب الوكيل POST

POST /openapi/whitelist-account/change-remark

معلمات الطلب في Body

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"remark": ""
}

معلمات الطلب

الاسم	الموقع	النوع	إلزامي	شرح
الجسم	الجسم	كائن	لا	لا شيء
» app_key	الجسم	سلسلة	لا	مفتاح الترخيص
» account	جسم	سلسلة	لا	حساب الوكيل، يدعم الأرقام والحروف فقط.
» ملاحظة	نص	نص	لا	ملاحظة جديدة للحساب الوكيل، بحد أقصى 32 حرفًا صينيًا أو 64 حرفًا إنجليزيًا.

مثال على الاستجابة

200 Response

{
	"code": 200,
	"msg": "string",
	"data": null
}

نتيجة الاستجابة

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب أصبح	Inline

بنية بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	خالٍ	خطأ	لا شيء	لا شيء

تعديل POST للحد الأقصى لحركة مرور حساب الوكيل

POST /openapi/whitelist-account/change-limit

يرجى ملاحظة أن إحصائيات حركة المرور قد تتأخر لمدة تصل إلى 5 دقائق، مما يعني أن حركة المرور المستهلكة الفعلية قد تتجاوز هذا الحد.

معلمات طلب Body

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"limit": 0
}

معاملات الطلب

اسم	الموقع	النوع	إلزامي	الوصف
body	body	كائن	لا	لا شيء
» app_key	جسم	سلسلة	لا	مفتاح التفويض
» حساب	الجسم	سلسلة	لا	حساب الوكيل، يدعم الأرقام والحروف فقط.
» limit	body	عدد صحيح	لا	الحد الأقصى لحجم البيانات، الوحدة: GB، القيمة 0 تعني عدم وجود حد أقصى

مثال على الاستجابة

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": null
}

نتيجة الاستجابة

رمز الحالة	معنى رمز الحالة	وصف	نموذج البيانات
200	OK	طلب اكتمال	في السطر

إرجاع هيكل البيانات

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» رسالة	نص	خطأ	لا شيء	رسالة الحالة
» data	فارغ	خطأ	لا شيء	لا يوجد

الاستعلام عن سجلات المرور

تجميع استخدام بيانات المرور حسب اليوم باستخدام GET

GET /openapi/user-usage-flow/total

معلمات الطلب

الاسم	الموقع	النوع	إلزامي	شرح
app_key	query	string(password)	نعم	مفتاح الاعتماد
start_time	query	سلسلة (Y-m-d H:i:s)	لا	وقت البدء، يمكن أن يكون دقيقًا بالثانية. يرجى ملاحظة أن تسجيلات الدخول متأخرة بما يصل إلى 5 دقائق. الافتراضي في غضون 7 أيام.
end_time	query	string(Y-m-d H:i:s)	لا	الموعد النهائي، يمكن أن يكون دقيقًا بالثواني. يرجى ملاحظة أن تسجيل الدخول يتأخر في غضون 5 دقائق. الوقت الافتراضي هو الوقت الحالي.
اسم المستخدم	استعلام	سلسلة	لا	اسم الحساب الفرعي، بشكل افتراضي يتم الاستعلام عن جميع الحسابات، ويمكن تحديد حساب فرعي. يرجى ملاحظة أنه إذا قمت بإضافة حسابات فرعية بنفس الاسم، فسيعرض هذا الاستعلام جميع سجلات استخدام حسابات الوكيل التي تحمل نفس الاسم.
product_type	query	number	لا	نوع الباقة

مثال على الاستجابة

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"day": "2022-08-01",
				"flow": 0
			}
		]
	}
}

النتائج المُعادة

رمز الحالة	معنى رمز الحالة	ملاحظات	نموذج البيانات
200	OK	طلب إلى	في السطر

هيكل بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	وصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» رسالة	نص	خطأ	لا شيء	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا يوجد
»» قائمة	[كائن]	خطأ	لا يوجد	لا يوجد
»»» يوم	نص	خطأ	لا شيء	تاريخ
»»» تدفق	عدد صحيح	خطأ	لا شيء	استهلاك حركة البيانات، الوحدة كيلوبايت

التحقق من الباقة

GET قائمة الباقات المشتراة

GET /openapi/user-product/list

معاملات الطلب

اسم	الموقع	النوع	إلزامي	الوصف
app_key	query	سلسلة(password)	نعم	مفتاح الاعتماد
trade_no	query	string	لا	رقم الطلب، يرجى إدخال رقم الطلب كاملاً. البحث التقريبي غير مدعوم.
صفحة	استعلام	رقم	لا	ترقيم الصفحات، الافتراضي: 1
حجم	استعلام	رقم	لا	عدد عناصر عرض الصفحة الواحدة، القيمة الافتراضية: 20
نوع المنتج	استعلام	رقم	لا	نوع الباقة

مثال على الإرجاع

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"created_at": "2022-05-13 12:14:15",
				"expired_at": "2022-05-13 12:14:15",
				"product_type": 9,
				"trade_no": "2022051312134339861461465434",
				"order": {
					"created_at": "2022-05-13 12:13:43",
					"pay_at": "2022-05-13 12:13:43",
					"title": "入门级"
				}
			}
		],
		"page": 1,
		"page_size": 20,
		"total_count": 0,
		"total_page": 0
	}
}

نتيجة الإرجاع

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب أصبح	Inline

بنية بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا شيء
»» قائمة	[كائن]	خطأ	لا شيء	لا يوجد
»»» id	عدد صحيح	خطأ	لا يوجد	رقم الباقة
»»» created_at	نص	خطأ	لا شيء	وقت تفعيل الباقة
»»» expired_at	سلسلة	خطأ	لا شيء	وقت انتهاء صلاحية الباقة، لا يمكن استخدام حركة المرور بعد انتهاء الصلاحية.
»»» نوع_المنتج	أنواع_المنتجات	خطأ	لا أحد	نوع الباقة، 9 باقة بيانات سكنية ديناميكية، 11 IP سكني ديناميكي، 14 IP مركز بيانات ثابت، 25 IP سكني ثابت
»»» trade_no	string	false	لا يوجد	رقم تعريف معاملة الطلب
»»» order	كائن	خطأ	لا شيء	لا شيء
»»»» created_at	سلسلة	خطأ	لا أحد	وقت إنشاء الطلب
»»»» pay_at	نص	خطأ	لا شيء	وقت دفع الطلب
»»»» title	نص	خطأ	لا يوجد	وصف الطلب
»» صفحة	عدد صحيح	خطأ	لا شيء	الترقيم الحالي
»» page_size	عدد صحيح	خطأ	لا شيء	حجم الصفحة
»» total_count	عدد صحيح	خطأ	لا شيء	إجمالي عدد السجلات
»» total_page	عدد صحيح	خطأ	لا يوجد	إجمالي عدد الصفحات

قيم التعداد

خاصية	قيمة
product_type	9
product_type	11
product_type	14
product_type	25

استخراج IP

GET استخراج IP

GET /openapi/ip/v3

معلمات الطلب

الاسم	الموقع	النوع	إلزامي	شرح
app_key	query	string(password)	لا	مفتاح الوصول
نسخة كربونية	استعلام	سلسلة نصية	لا	الدولة أو المنطقة
ولاية	استعلام	سلسلة	لا	الولاية أو المقاطعة
مدينة	استعلام	سلسلة	لا	مدينة
تنسيق	استعلام	نص	لا	الحصول على تنسيق
رطل	استعلام	سلسلة نصية	لا	فاصل، صالح لتنسيق النص فقط
رقم	استعلام	رقم	لا	استخراج الكمية
حياة	استعلام	رقم	لا	فترة الاستبقاء - بالدقائق
ep	استعلام	سلسلة نصية	لا	شبكة الوكيل

مثال الإرجاع

200 استجابة

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			[
				"150.109.114.72:1140",
				"150.109.114.72:1141",
				"150.109.114.72:1142",
				"150.109.114.72:1143",
				"150.109.114.72:1144",
				"150.109.114.72:1145",
				"150.109.114.72:1146",
				"150.109.114.72:1147",
				"150.109.114.72:1148",
				"150.109.114.72:1149"
			]
		]
	}
}

النتائج المُعادة

رمز الحالة	معنى رمز الحالة	ملاحظات	نموذج البيانات
200	OK	هيئة الطلب	في الخط

هيكل بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	وصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 تعني نجاح، 3 تعني app_key غير صالح، 156 تعني أن الحساب لم يتم التحقق منه
» رسالة	نص	خطأ	لا شيء	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا أحد
»» قائمة	[any]	خطأ	لا أحد	لا يوجد

GET قائمة المدن

GET /openapi/ip/dynamic-citys

مثال للإرجاع

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"city": null,
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

نتائج الاسترجاع

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب ناجح	مضمن

هيكل البيانات المُعاد

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	وصف
» رمز	عدد صحيح	خطأ	لا شيء	رمز الحالة,200 نجاح، 3 app_key غير صالح، 156 الحساب لم يتم التحقق منه بالهوية
» msg	string	false	لا يوجد	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا شيء
»» قائمة	[كائن]	خطأ	لا شيء	قائمة
»»» name_zh_cn	سلسلة	خطأ	لا شيء	اسم الدولة أو المنطقة
»»» name_en	سلسلة	خطأ	لا أحد	اسم الدولة أو المنطقة
»»» continent_code	سلسلة نصية	خطأ	لا يوجد	رمز القارة
»»» country_code	سلسلة نصية	خطأ	لا شيء	رمز البلد أو المنطقة
»»» العناصر	[كائن]	خطأ	لا شيء	المقاطعة أو الولاية
»»»» المدينة	نص	خطأ	لا شيء	اسم المدينة
»»»» state	نص	خطأ	لا يوجد	رمز اسم المقاطعة أو الولاية
»»»» continent_code	سلسلة نصية	خطأ	لا شيء	رمز القارة
»»»» country_code	سلسلة	خطأ	لا شيء	رمز البلد أو المنطقة

GET بحث المدينة

GET /openapi/ip/dynamic-citys/search

معلمات الطلب

اسم	الموقع	النوع	إلزامي	الوصف
رمز البلد	استعلام	نص	نعم	رمز الدولة أو المنطقة
الولاية	استعلام	سلسلة نصية	نعم	رمز الولاية أو المقاطعة

مثال للإرجاع

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

إرجاع النتائج

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب أصبح	Inline

بنية بيانات الإرجاع

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	الوصف
» code	عدد صحيح	خطأ	لا شيء	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير مصادق عليه
» msg	سلسلة نصية	خطأ	لا شيء	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا شيء
»» قائمة	[نص]	خطأ	لا شيء	قائمة

GET قائمة الولايات

GET /openapi/ip/dynamic-states

مثال على الاسترجاع

200 Response

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

نتائج الاسترجاع

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	طلب ناجح	في الخط الواحد

هيكل البيانات المُعاد

رمز الحالة 200

الاسم	النوع	إلزامي	قيود	وصف
» رمز	عدد صحيح	خطأ	لا شيء	رمز الحالة,200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» msg	string	false	لا يوجد	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا شيء
»» قائمة	[كائن]	خطأ	لا شيء	قائمة
»»» name_zh_cn	سلسلة	خطأ	لا شيء	اسم الدولة أو المنطقة
»»» name_en	سلسلة	خطأ	لا أحد	اسم الدولة أو المنطقة
»»» continent_code	سلسلة نصية	خطأ	لا يوجد	رمز القارة
»»» country_code	سلسلة نصية	خطأ	لا شيء	رمز البلد أو المنطقة
»»» العناصر	[كائن]	خطأ	لا شيء	المقاطعة أو الولاية
»»»» state	string	false	none	رمز اسم الولاية أو المقاطعة
»»»» continent_code	سلسلة نصية	خطأ	لا يوجد	رمز القارة
»»»» country_code	سلسلة نصية	خطأ	لا شيء	رمز الدولة أو المنطقة

الحصول على بحث عن ولاية/مقاطعة

GET /openapi/ip/dynamic-states/search

معلمات الطلب

اسم	موقع	النوع	إلزامي	الوصف
country_code	query	string	هو	رمز البلد أو المنطقة

مثال على الاستجابة

استجابة 200

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

نتيجة الاسترجاع

رمز الحالة	معنى رمز الحالة	وصف	نموذج البيانات
200	OK	طلب اكتمال	في السطر

بنية بيانات الإرجاع

رمز الحالة 200

اسم	النوع	إلزامي	قيود	شرح
» code	عدد صحيح	خطأ	لا يوجد	رمز الحالة، 200 نجاح، 3 app_key غير صالح، 156 الحساب غير موثق
» msg	سلسلة	خطأ	لا شيء	رسالة الحالة
» data	كائن	خطأ	لا شيء	لا شيء
»» قائمة	[سلسلة]	خطأ	لا شيء	قائمة

GET للحصول على قائمة IP ثابتة

GET /ip/get-static-ip

معلمات الطلب

اسم	الموقع	النوع	إلزامي	الوصف
رمز البلد	استعلام	نص	لا	رمز البلد أو المنطقة
product_type	query	number	لا	نوع المنتج, 25: IP سكنية ثابتة, 14: IP مركز البيانات
trade_no	query	سلسلة	لا	تصفية IP عن طريق رقم الطلب
صفحة	استعلام	رقم	لا	رقم الصفحة
حجم	استعلام	رقم	لا	عدد العناصر في كل صفحة
الحالة	الاستعلام	رقم	لا	الحالة، 1: فعال، 2: غير فعال، 3: يقترب من الانتهاء، 4: قيد الصيانة

قيم التعداد

الخاصية	قيمة
product_type	14
product_type	25
الحالة status	1
الحالة	2
الحالة	3
الحالة	4

مثال للإرجاع

استجابة 200

{}

نتيجة الإرجاع

رمز الحالة	معنى رمز الحالة	شرح	نموذج البيانات
200	OK	لا يوجد	في السطر

هيكل البيانات المُعاد

نموذج البيانات

productTypes

أنواع الباقات، 9 باقة بيانات سكنية ديناميكية، 11 IP سكني ديناميكي، 14 IP مركز بيانات ثابت، 25 IP سكني ثابت

الخصائص

الاسم	النوع	إلزامي	قيود	الاسم الصيني	وصف
مجهول	عدد صحيح	خطأ	لا شيء		نوع الباقة، 9 باقة بيانات سكنية ديناميكية، 11 IP سكني ديناميكي، 14 IP مركز بيانات ثابت، 25 IP سكني ثابت

قيم التعداد

الخاصية	القيمة
مجهول	9
مجهول	11
مجهول	14
مجهول	25

مفتاح API

null

مفتاح الاعتماد

الاسم	النوع	إلزامي	قيود	الاسم الصيني	وصف
مجهول	عدد صحيح	خطأ	لا شيء		رمز الحالة، 200 نجاح، 3 app_key غير صالح

responseMsg

"success"

رسالة الاستجابة

خاصية

الاسم	النوع	إلزامي	قيود	الاسم بالصينية	الوصف
مجهول	نص	خطأ	لا شيء		رسالة الرد