الكتالوج

سرد الخدمات

يعرض كل خدمة يمكنك طلبها، مع سعرك الخاص والحدود والوسوم والحقول الإضافية وحدود التغذية التدريجية والتوفر. كل خدمة كائن واحد، وجميع الحقول من الإصدارات السابقة ما زالت موجودة.

POSThttps://notpanel.com/api/v3action=services

مفتاح API مطلوب
تجاوز حد الطلبات
الجسم:application/x-www-form-urlencoded

خزّن القائمة مؤقتًا

يقتصر services على 10 طلبًا في الدقيقة لكل حساب. اجلبه وفق جدول زمني واحتفظ بنسختك الخاصة بدلًا من استدعائه قبل كل طلب.

المعاملات

يُرسل دائمًا

keystringمطلوب: مفتاح API الخاص بك.
actionstringمطلوب: servicesيجب أن يكون السلسلة النصية الحرفية "services".

معاملات الإجراء

languagestringاختياري: لغة الأسماء. اتركه فارغًا للإنجليزية. الاسم بالإنجليزية موجود دائمًا في canonical_name.en · es · pt · ru · tr · ar · hi · id · fr · zh
servicestring (CSV)اختياري: يعيد هذه الخدمات فقط. حتى 100 من معرّفات الخدمات مفصولة بفواصل.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=services&service=7,12"

const res = await fetch("https://notpanel.com/api/v3", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "services",
    service: "7,12",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "services",
    "service": "7,12",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'services',
    'service' => '7,12',
]);

$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $body,
        'ignore_errors' => true,
    ],
]));

print_r(json_decode($response, true));

استبدل YOUR_API_KEY بالمفتاح من صفحة API.

الاستجابة200 OK

[
  {
    "service": "7",
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "1.20",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true,
    "dripfeed": true,
    "type_key": "default",
    "canonical_name": "Instagram Followers",
    "name_language": "en",
    "platform": "instagram",
    "tags": ["refill", "cancel", "drip_feed"],
    "fields": [],
    "drip_feed": {
      "mode": "batches",
      "min_runs": 2,
      "max_runs": 100,
      "min_interval_minutes": 1,
      "max_interval_minutes": 1440,
      "max_total_minutes": 2880
    },
    "step": 1,
    "availability": "available",
    "average_time_minutes": 30
  },
  {
    "service": "12",
    "name": "Telegram Post Reactions",
    "type": "Default",
    "category": "Telegram Reactions",
    "rate": "0.90",
    "min": "10",
    "max": "50000",
    "refill": false,
    "cancel": false,
    "dripfeed": false,
    "type_key": "default",
    "canonical_name": "Telegram Post Reactions",
    "name_language": "en",
    "platform": "telegram",
    "tags": ["reactions"],
    "fields": [
      {
        "key": "reactions",
        "kind": "reactions",
        "required": false,
        "label": "Reactions",
        "allowed": ["👍", "👎", "❤️", "🔥", "🥰", "👏", "😁", "🤔", "🤯", "😱", "🤬", "😢", "🎉", "🤩", "🤮", "💩", "🙏", "👌", "🕊️", "🤡", "🥱", "🥴", "😍", "🐳", "❤️‍🔥", "🌚", "🌭", "💯", "🤣", "⚡", "🍌", "🏆", "💔", "🤨", "😐", "🍓", "🍾", "💋", "🖕", "😈", "😴", "😭", "🤓", "👻", "👨‍💻", "👀", "🎃", "🙈", "😇", "😨", "🤝", "✍️", "🤗", "🫡", "🎅", "🎄", "☃️", "💅", "🤪", "🗿", "🆒", "💘", "🙉", "🦄", "😘", "💊", "🙊", "😎", "👾", "🤷‍♂️", "🤷", "🤷‍♀️", "😡"],
        "max_distinct": 11,
        "modes": ["mix", "exact"]
      }
    ],
    "drip_feed": null,
    "step": 1,
    "availability": "available",
    "average_time_minutes": null
  }
]

الأخطاء

400
{"error":"Invalid language: not_allowed","error_code":"INVALID_PARAMETER","retryable":false,"details":{"param":"language","rule":"not_allowed"}}
اللغة ليست من رموز اللغات المدعومة.
400
{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}
تحتوي قائمة الخدمات على أكثر من 100 معرّفًا.
429
{"error":"Rate limit exceeded","error_code":"API_RATE_LIMITED","retryable":true,"retry_after":12}
أكثر من 10 طلبًا في دقيقة واحدة. انتظر عدد الثواني الوارد في Retry-After.

كل رموز الحالة

حقول الردّ

الردّ مصفوفة فيها كائن واحد لكل خدمة. كل حقل من الإصدارات السابقة لم يتغير؛ والحقول tags وfields وdrip_feed وstep وavailability وaverage_time_minutes جديدة، ويعني cancel الآن ما يقوله اسمه.

حقول الاستجابة

serviceinteger: معرّف رقمي ثابت للخدمة. استخدمه بصفة service في add.
namestring: اسم الخدمة باللغة المطلوبة.
typestring: اسم نوع الخدمة. للمنطق البرمجي استخدم type_key.
categorystring: اسم الفئة.
ratestring: سعرك الخاص لكل 1000 وحدة بالدولار الأمريكي، كسلسلة نصية. يتضمن خصم حسابك بالفعل. بالنسبة للباقة، هو سعر طلب واحد.
mininteger: أصغر كمية لطلب واحد.
maxinteger: أكبر كمية لطلب واحد.
refillboolean: true عندما تعمل إعادة التعبئة لهذه الخدمة عبر API.
cancelboolean: true عندما تكون طلبات الإلغاء مدعومة بعد أول 15 ثانية. الإلغاء الفوري في البداية يعمل على كل طلب ولا يظهر هنا.
dripfeedboolean: true عندما تقبل الخدمة التغذية التدريجية، إما بـ runs مع interval أو بـ drip_feed_total_minutes.
type_keystring: مفتاح نوع ثابت مثل default أو custom_comments. يخبرك بالحقول الإضافية المتوقعة.
canonical_namestring: الاسم بالإنجليزية، حتى عند تعيين language.
name_languagestring: لغة name.
platformstring | null: مفتاح المنصة مثل instagram، أو null عندما لا يكون للخدمة منصة.
tagsstring[]: وسوم قصيرة لما تقدمه الخدمة. انظر القائمة أدناه.
fieldsobject[]: المدخلات الإضافية التي تقبلها الخدمة مع حدودها. فارغة عندما يلزم الرابط والكمية فقط.
drip_feedobject | null: حدود التغذية التدريجية، أو null عندما لا تتوفر في الخدمة.
stepinteger: يجب أن تكون الكمية من مضاعفات هذا الرقم.
availabilitystring: available أو paused. انظر التوفر أدناه.
average_time_minutesinteger | null: متوسط الدقائق حتى يبدأ التسليم، أو null عندما يكون عدد الطلبات المعروفة قليلًا جدًا.

الحقول الإضافية

يصف fields كل مدخل إضافي تقبله الخدمة: مفتاحه ونوعه وما إذا كان مطلوبًا وحدوده. أرسل كل حقل بمفتاحه في add. تسرد التفاعلات الرموز التعبيرية المسموح بها والأوضاع. تشرح الصفحة التالية كل حقل وقواعده.

الحقول والخيارات

حدود التغذية التدريجية

قيمة drip_feed هي null أو إحدى صيغتين. خدمات batches تقبل عدد مرات التشغيل والدقائق بينها. خدمات unit_delay توزّع الطلب كله على وقت إجمالي. وفي الحالتين يمكن أن يستغرق الطلب كله 48 ساعة (2880 دقيقة) كحد أقصى.

mode: batches

{
  "mode": "batches",
  "min_runs": 2,
  "max_runs": 100,
  "min_interval_minutes": 1,
  "max_interval_minutes": 1440,
  "max_total_minutes": 2880
}

mode: unit_delay

{
  "mode": "unit_delay",
  "max_total_minutes": 2880
}

تغذية تدريجية

التوفر

لا تُدرج إلا الخدمات التي يمكنها استقبال الطلبات الآن. الخدمة المعطّلة أو الموقوفة مؤقتًا أو المحذوفة لا تظهر في القائمة؛ وإذا عادت فإنها تحتفظ بمعرّف service نفسه، لذا ينبغي للوحات التي تعكس هذه القائمة أن تحتفظ بارتباط الخدمة الغائبة بدلًا من حذفه. تكون قيمة availability هي paused ما دامت طلبات خدمة مدرجة معلّقة مؤقتًا، ويعيد add الرمز SERVICE_PAUSED خلال ذلك. ولا تُدرج الاشتراكات أبدًا.

أخطاء الخدمة عند الطلب

يعيد add هذه الأخطاء عندما لا تستطيع الخدمة التي اخترتها قبول طلب.

404
SERVICE_NOT_FOUND
Service not found
لا توجد خدمة بهذا المعرّف، أو أنها غير متاحة لك. صحّح الطلب أولًا.
410
SERVICE_DISCONTINUED
Service has been discontinued
أُوقفت الخدمة نهائيًا. صحّح الطلب أولًا.
409
SERVICE_PAUSED
Service is temporarily unavailable
الخدمة متوقفة مؤقتًا حاليًا. حاول لاحقًا. قد تفيد إعادة المحاولة.

إجراءات قراءة أخرى

يعيد action=catalog الخدمات كقائمة مقسّمة إلى صفحات، مع المنصة والفئة ومتوسط الوقت وحقول الطلب. عوامل تصفية اختيارية: page، limit، search، platform، category، type، refill، dripfeed، available، min_rate، max_rate، sort وlanguage. يقتصر catalog على 30 طلبًا في الدقيقة لكل حساب.

يعيد action=account_status إجمالي إنفاقك، ومستوى حد API لديك، وخصمك.

الكتالوج

سرد الخدمات

POSThttps://notpanel.com/api/v3action=services

مفتاح API مطلوب
تجاوز حد الطلبات
الجسم:application/x-www-form-urlencoded

خزّن القائمة مؤقتًا

المعاملات

يُرسل دائمًا

keystringمطلوب: مفتاح API الخاص بك.
actionstringمطلوب: servicesيجب أن يكون السلسلة النصية الحرفية "services".

معاملات الإجراء

languagestringاختياري: لغة الأسماء. اتركه فارغًا للإنجليزية. الاسم بالإنجليزية موجود دائمًا في canonical_name.en · es · pt · ru · tr · ar · hi · id · fr · zh
servicestring (CSV)اختياري: يعيد هذه الخدمات فقط. حتى 100 من معرّفات الخدمات مفصولة بفواصل.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=services&service=7,12"

const res = await fetch("https://notpanel.com/api/v3", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "services",
    service: "7,12",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "services",
    "service": "7,12",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'services',
    'service' => '7,12',
]);

$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $body,
        'ignore_errors' => true,
    ],
]));

print_r(json_decode($response, true));

استبدل YOUR_API_KEY بالمفتاح من صفحة API.

الاستجابة200 OK

[
  {
    "service": "7",
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "1.20",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true,
    "dripfeed": true,
    "type_key": "default",
    "canonical_name": "Instagram Followers",
    "name_language": "en",
    "platform": "instagram",
    "tags": ["refill", "cancel", "drip_feed"],
    "fields": [],
    "drip_feed": {
      "mode": "batches",
      "min_runs": 2,
      "max_runs": 100,
      "min_interval_minutes": 1,
      "max_interval_minutes": 1440,
      "max_total_minutes": 2880
    },
    "step": 1,
    "availability": "available",
    "average_time_minutes": 30
  },
  {
    "service": "12",
    "name": "Telegram Post Reactions",
    "type": "Default",
    "category": "Telegram Reactions",
    "rate": "0.90",
    "min": "10",
    "max": "50000",
    "refill": false,
    "cancel": false,
    "dripfeed": false,
    "type_key": "default",
    "canonical_name": "Telegram Post Reactions",
    "name_language": "en",
    "platform": "telegram",
    "tags": ["reactions"],
    "fields": [
      {
        "key": "reactions",
        "kind": "reactions",
        "required": false,
        "label": "Reactions",
        "allowed": ["👍", "👎", "❤️", "🔥", "🥰", "👏", "😁", "🤔", "🤯", "😱", "🤬", "😢", "🎉", "🤩", "🤮", "💩", "🙏", "👌", "🕊️", "🤡", "🥱", "🥴", "😍", "🐳", "❤️‍🔥", "🌚", "🌭", "💯", "🤣", "⚡", "🍌", "🏆", "💔", "🤨", "😐", "🍓", "🍾", "💋", "🖕", "😈", "😴", "😭", "🤓", "👻", "👨‍💻", "👀", "🎃", "🙈", "😇", "😨", "🤝", "✍️", "🤗", "🫡", "🎅", "🎄", "☃️", "💅", "🤪", "🗿", "🆒", "💘", "🙉", "🦄", "😘", "💊", "🙊", "😎", "👾", "🤷‍♂️", "🤷", "🤷‍♀️", "😡"],
        "max_distinct": 11,
        "modes": ["mix", "exact"]
      }
    ],
    "drip_feed": null,
    "step": 1,
    "availability": "available",
    "average_time_minutes": null
  }
]

الأخطاء

400
{"error":"Invalid language: not_allowed","error_code":"INVALID_PARAMETER","retryable":false,"details":{"param":"language","rule":"not_allowed"}}
اللغة ليست من رموز اللغات المدعومة.
400
{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}
تحتوي قائمة الخدمات على أكثر من 100 معرّفًا.
429
{"error":"Rate limit exceeded","error_code":"API_RATE_LIMITED","retryable":true,"retry_after":12}
أكثر من 10 طلبًا في دقيقة واحدة. انتظر عدد الثواني الوارد في Retry-After.

كل رموز الحالة

حقول الردّ

حقول الاستجابة

serviceinteger: معرّف رقمي ثابت للخدمة. استخدمه بصفة service في add.
namestring: اسم الخدمة باللغة المطلوبة.
typestring: اسم نوع الخدمة. للمنطق البرمجي استخدم type_key.
categorystring: اسم الفئة.
ratestring: سعرك الخاص لكل 1000 وحدة بالدولار الأمريكي، كسلسلة نصية. يتضمن خصم حسابك بالفعل. بالنسبة للباقة، هو سعر طلب واحد.
mininteger: أصغر كمية لطلب واحد.
maxinteger: أكبر كمية لطلب واحد.
refillboolean: true عندما تعمل إعادة التعبئة لهذه الخدمة عبر API.
cancelboolean: true عندما تكون طلبات الإلغاء مدعومة بعد أول 15 ثانية. الإلغاء الفوري في البداية يعمل على كل طلب ولا يظهر هنا.
dripfeedboolean: true عندما تقبل الخدمة التغذية التدريجية، إما بـ runs مع interval أو بـ drip_feed_total_minutes.
type_keystring: مفتاح نوع ثابت مثل default أو custom_comments. يخبرك بالحقول الإضافية المتوقعة.
canonical_namestring: الاسم بالإنجليزية، حتى عند تعيين language.
name_languagestring: لغة name.
platformstring | null: مفتاح المنصة مثل instagram، أو null عندما لا يكون للخدمة منصة.
tagsstring[]: وسوم قصيرة لما تقدمه الخدمة. انظر القائمة أدناه.
fieldsobject[]: المدخلات الإضافية التي تقبلها الخدمة مع حدودها. فارغة عندما يلزم الرابط والكمية فقط.
drip_feedobject | null: حدود التغذية التدريجية، أو null عندما لا تتوفر في الخدمة.
stepinteger: يجب أن تكون الكمية من مضاعفات هذا الرقم.
availabilitystring: available أو paused. انظر التوفر أدناه.
average_time_minutesinteger | null: متوسط الدقائق حتى يبدأ التسليم، أو null عندما يكون عدد الطلبات المعروفة قليلًا جدًا.

الحقول الإضافية

الحقول والخيارات

حدود التغذية التدريجية

mode: batches

{
  "mode": "batches",
  "min_runs": 2,
  "max_runs": 100,
  "min_interval_minutes": 1,
  "max_interval_minutes": 1440,
  "max_total_minutes": 2880
}

mode: unit_delay

{
  "mode": "unit_delay",
  "max_total_minutes": 2880
}

تغذية تدريجية

التوفر

أخطاء الخدمة عند الطلب

يعيد add هذه الأخطاء عندما لا تستطيع الخدمة التي اخترتها قبول طلب.

404
SERVICE_NOT_FOUND
Service not found
لا توجد خدمة بهذا المعرّف، أو أنها غير متاحة لك. صحّح الطلب أولًا.
410
SERVICE_DISCONTINUED
Service has been discontinued
أُوقفت الخدمة نهائيًا. صحّح الطلب أولًا.
409
SERVICE_PAUSED
Service is temporarily unavailable
الخدمة متوقفة مؤقتًا حاليًا. حاول لاحقًا. قد تفيد إعادة المحاولة.

إجراءات قراءة أخرى

يعيد action=account_status إجمالي إنفاقك، ومستوى حد API لديك، وخصمك.