پارس‌کدرز چگونه کار می‌کند؟

از پارس‌کدرز بیشترین بهره را ببرید و رویای کاری خود را زندگی کنید.

پارس‌کدرز خریداران یا کارفرمایان را به مجری‌ها /فریلنسرهای خبره‌ای متصل می‌کند که برای انجام پروژه آماده هستند.

اتصال یک api به اسکریپت فریر

پنج سال پیش منتشر شده

تعداد بازدید: 765

کد پروژه: 94017


شرح پروژه

سایت دارم که در اون میشه کاربر ساخت و مدت زمان اکانت بهش تخصیص داد

میخام از طریق api اون سایت این کار در اسکریپت فریر انجام بشه

یکی کاربر روی سایتی جدا یوزر خودش رو بسازه و یا تمدید کنه

مستندات لازم :

اتصال

برای اتصال باید درخواست خود را بسته به نوع درخواست با یکی از متد های GET یا POST یا PUT یا DELETE به آدرس زیر بفرستید:

https://api.vpnmakers.com/resellers/v2/

همه درخواست ها باید header های X-Auth-Name که همان یوزرنیم نماینده و همچنین X-Auth-Key که همان رمز API هست را داشته باشند.

حداکثر تعداد مجاز درخواست از API در هر ساعت 500 عدد می باشد. توجه داشته باشید که برای درخواست های ساخت کاربر جدید و تغییر اعتبار کاربر، همانند پنل یک عدد point هم کسر می شود.

نتیجه هر درخواست با فرمت JSON ارسال می شود. در صورت موفق بودن، پارامتر success مثبت بوده و نتایج درخواست در پارامتر result فرستاده می شود. در صورت نا موفق بودن درخواست، پارامتر success منفی بوده و علت های خطا در پارامتر errors ارسال می شوند.

کد های وضعیت HTTP

نتیجه هر درخواست همچنین از طریق کد وضعیت HTTP پاسخ درخواست، مطابق جدول زیر قابل بررسی می باشد.

کد وضعیت توضیح 200 OK موفقیت آمیز 401 Unauthorized یوزرنیم یا API Key صحیح نیست 403 Forbidden درخواست مجاز نمی باشد (معمولا به دلیل خطا در پارامترهای ارسالی) 404 Not Found لینک درخواستی اشتباه است 405 Method Not Allowed متد HTTP درخواستی اشتباه است 429 Too Many Requests تعداد درخواست ها از حداکثر مجاز بیشتر است

پارامتر های ارسالی

عملکرد پارامتر ها و کاراکترهای مجاز در آن ها مطابق جدول زیر است.

اسم توضیح کاراکترهای مجاز username نام کاربری vpn حروف کوچک و اعداد انگلیسی و . و - و _ (حداقل 3 حرف) password رمز عبور vpn حروف کوچک و بزرگ و اعداد انگلیسی (حداقل 4 حرف) credit اعتبار کاربر بر حسب روز اعداد انگلیسی

درخواست اعتبار باقی مانده نماینده (متد GET)

این درخواست برای دریافت اعتبار باقی مانده و مقدار points نماینده است.

GET /info

نمونه درخواست با cURL

curl -X GET "https://api.vpnmakers.com/resellers/v2/info" \
     -H "X-Auth-Name: username" \
     -H "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e" \
     -H "Content-Type: application/json"

نمونه درخواست با PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.vpnmakers.com/resellers/v2/info");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Auth-Name: username", "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e"));
$result = curl_exec($ch);

نمونه پاسخ

{
  "success": true,
  "errors": null,
  "result": {
    "reseller": {
      "credit": 620,
      "points": 60
    }
  }
}

درخواست مشخصات کاربر (متد GET)

این درخواست برای دریافت اعتبار باقی مانده و تاریخ شروع و رمز عبور و وضعیت اتصال فعلی و آخرین اتصال کاربر vpn است.

GET /user/{username}

نمونه درخواست با cURL

curl -X GET "https://api.vpnmakers.com/resellers/v2/user/test" \
     -H "X-Auth-Name: username" \
     -H "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e" \
     -H "Content-Type: application/json"

نمونه درخواست با PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.vpnmakers.com/resellers/v2/user/test");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Auth-Name: username", "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e"));
$result = curl_exec($ch);

نمونه پاسخ

{
  "success": true,
  "errors": null,
  "result": {
    "user": {
      "username": "test",
      "credit": 31,
      "start_date": "2016-11-02",
      "password": "1234",
      "connection_count": 1,
      "connection_status": "online",
      "last_login": null,
      "last_login_en": "never",
      "started": true,
    }
  }
}

درخواست ساخت یوزر جدید (متد POST)

این درخواست برای ساخت یک یوزر جدید vpn است. پارامتر های مورد نیاز credit (اعتبار بر حسب روز) و password (رمز عبور) می باشند.

POST /user/{username}

نمونه درخواست با cURL

curl -X POST "https://api.vpnmakers.com/resellers/v2/user/test" \
     -H "X-Auth-Name: username" \
     -H "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e" \
     -H "Content-Type: application/json" \
     --data '{"credit":31,"password":"1234"}'

نمونه درخواست با PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.vpnmakers.com/resellers/v2/user/test");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Auth-Name: username", "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e"));
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(array("credit"=>31, "password"=>"1234")));
$result = curl_exec($ch);

نمونه پاسخ

{
  "success": true,
  "errors": null,
  "result": {
    "message": "user is created successfully",
    "user": {
      "username": "test",
      "credit": 31,
      "password": "1234"
    },
    "reseller": {
      "spent_credit": 31,
      "spent_points": 1,
      "remaining_credit": 589,
      "remaining_points": 59
    }
  }
}

درخواست تغییر رمز عبور (متد PUT)

این درخواست برای تغییر رمز عبور کاربر vpn است. تنها پارامتر مورد نیاز password (رمز عبور جدید) می باشد.

PUT /user/{username}/password

نمونه درخواست با cURL

curl -X PUT "https://api.vpnmakers.com/resellers/v2/user/test/password" \
     -H "X-Auth-Name: username" \
     -H "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e" \
     -H "Content-Type: application/json" \
     --data '{"password":"123456"}'

نمونه درخواست با PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.vpnmakers.com/resellers/v2/user/test/password");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Auth-Name: username", "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e"));
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(array("password"=>"123456")));
$result = curl_exec($ch);

نمونه پاسخ

{
  "success": true,
  "errors": null,
  "result": {
    "message": "password is updated successfully",
    "user": {
      "username": "test",
      "password": "123456"
    }
  }
}

درخواست تغییر اعتبار (متد PUT)

این درخواست برای تغییر (افرایش یا کاهش) اعتبار کاربر vpn است. تنها پارامتر مورد نیاز credit (اعتبار جدید) می باشد.

PUT /user/{username}/credit

نمونه درخواست با cURL

curl -X PUT "https://api.vpnmakers.com/resellers/v2/user/test/credit" \
     -H "X-Auth-Name: username" \
     -H "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e" \
     -H "Content-Type: application/json" \
     --data '{"credit":93}'

نمونه درخواست با PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.vpnmakers.com/resellers/v2/user/test/credit");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Auth-Name: username", "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e"));
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(array("credit"=>93)));
$result = curl_exec($ch);

نمونه پاسخ

{
  "success": true,
  "errors": null,
  "result": {
    "message": "credit is updated successfully",
    "user": {
      "username": "test",
      "old_credit": 31,
      "new_credit": 93
    },
    "reseller": {
      "spent_credit": 62,
      "spent_points": 1,
      "remaining_credit": 527,
      "remaining_points": 58
    }
  }
}

درخواست حذف کاربر (متد DELETE)

این درخواست برای حذف کاربر vpn می باشد.

DELETE /user/{username}

نمونه درخواست با cURL

curl -X DELETE "https://api.vpnmakers.com/resellers/v2/user/test" \
     -H "X-Auth-Name: username" \
     -H "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e" \
     -H "Content-Type: application/json"

نمونه درخواست با PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.vpnmakers.com/resellers/v2/user/test");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("X-Auth-Name: username", "X-Auth-Key: 97164b7120cac59f7ec137fe996ebf3e"));
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
$result = curl_exec($ch);

نمونه پاسخ

{
  "success": true,
  "errors": null,
  "result": {
    "message": "user is deleted successfully",
    "user": {
      "username": "test"
    },
    "reseller": {
      "received_credit": 93,
      "remaining_credit": 620
    }
  }
}

مهارت ها و تخصص های مورد نیاز

PHP

بودجه

5,000 تومان تا 100,000 تومان

مهلت برای انجام

30روز

وضعیت مناقصه

انجام شده


درباره کارفرما

عضویت پنج سال پیش

4 پروژه ثبت شده ،
1 پروژه در حال انجام ،
0 پروژه آماده دریافت پیشنهاد ،
نرخ پذیرش پیشنهاد 50%

برای پیدا کردن پروژه‌های مشابه ثبت نام کنید و پروفایل خود را بسازید.

ورود با گوگل
یا
نام نباید خالی باشد.
نام خانوادگی نباید خالی باشد.

نیاز به استخدام فریلنسر یا سفارش پروژه مشابه دارید؟

سفارش پروژه مشابه

قادر به انجام این پروژه هستید؟

ثبت نام کنید

مهلت ارسال پیشنهاد قیمت برای این پروژه تمام شده است

سری به پروژه‌های مشابه بزنید

روش کار در پارس‌کدرز

به رایگان یک حساب کاربری بسازید

مهارت‌ها و تخصص‌های خود را ثبت کنید، رزومه و نمونه‌کارهای خود را نشان دهید و سوابق کاری خود را شرح دهید.

به شیوه‌ای که دوست دارید کار کنید

برای پروژه‌های دلخواه در زمان دلخواه پیشنهاد قیمت خود را ثبت کنید و به فرصت‌های شغلی منحصر به فرد دسترسی پیدا کنید.

با اطمینان دستمزد دریافت کنید

از زمان شروع کار تا انتهای کار به امنیت مالی شما کمک خواهیم کرد. وجه پروژه را از ابتدای کار به امانت در سایت نگه خواهیم داشت تا تضمین شودکه بعد از تحویل کار دستمزد شما پرداخت خواهد شد.

می‌خواهید شروع به کار کنید؟

یک حساب کاربری بسازید


بهترین مشاغل فریلنسری را پیدا کنید
رشد شغلی شما به راحتی ایجاد یک حساب کاربری رایگان و یافتن کار (پروژه) متناسب با مهارت‌های شما است.

پیدا کردن کار (پروژه)

تماشای دمو روش کار