وب سرویس API خرید گیفت کارت (Beta 0.001) (بروزرسانی : 1402/08/26)
مقدمه
با وبسرویس گیفت کارت شما میتونید تمامی محصولات مارو تو سایت یا اپلیکیشن خودتون داشته باشین و بدون داشتن هزینه
زیاد برای موجودی گیفت کارت ها ، از همه سرویس های ما استفاده کنید ، برای گرفتن کلید وبسرویس با پشتیبانی در تماس
باشد .
موجودی کیف پول
موجودی شمارو برای وبسرویس بهتون نمایش میده
GET
https://gifkart.com/gapi/?APIKEY=[YOURAPIKEY]&Balance=USD
اطلاعات ارسالی
| پارامتر |
اجباری |
توضیحات |
| APIKEY |
* |
کلید وبسرویس |
| Balance |
* |
متد درخواست موجودی |
پاسخ سرویس
| پارامتر |
توضیحات |
| UserBalance |
مقدار موجودی شما برای وبسرویس |
| currency |
واحد پولی |
تاریخچه گیفت کارت های خریداری شده
آخرین خرید هاتون رو میتونین ببینید ، مثل لیست سفارشات سایت
GET
https://gifkart.com/gapi/?APIKEY=[YOURAPIKEY]&CardHistory=All
اطلاعات ارسالی
| پارامتر |
اجباری |
توضیحات |
| APIKEY |
* |
کلید وبسرویس |
| CardHistory |
* |
متد نمایش تاریخچه کد های خریداری شده |
پاسخ سرویس
| پارامتر |
توضیحات |
| WalletCode |
کد گیفت کارت |
| Name |
اسم گیفت کارت به فارسی |
| time |
زمان خرید به Timestamp |
| order_id |
شماره سفارش |
نمایش محصولات
میتونین همه محصولات سایت رو با مشصخات و قیمت ببینید
GET
https://gifkart.com/gapi/?APIKEY=[YOURAPIKEY]&GetAllProducts=All
اطلاعات ارسالی
| پارامتر |
اجباری |
توضیحات |
| APIKEY |
* |
کلید وبسرویس |
| GetAllProducts |
* |
متد نمایش محصولات |
پاسخ سرویس
| پارامتر |
توضیحات |
| name |
اسم گیفت کارت |
| priceT |
قیمت به تومان ( قیمتی که داخل سایت نمایش میدیم ) |
| priceT_OFF |
قیمت تخفیف خورده به تومان ( قیمتی که داخل سایت نمایش میدیم ) |
| PriceinUSD |
قیمت به دلار برای شما که از کیف پول شما برای وبسرویس کسر میشه |
| product_id |
سریال محصول ( برای خرید باید ارسال کنین ) |
| Stock |
موجودی محصول ( به دلیل اینکه تو هر سفارش یک عدد کارت میتونین سفارش بدین فعلا روی 1 ست شده ) |
| deliver_time |
اگه مقدارش instant باشه تحویل فوری هستش اگه نباشه زمان تحویل رو به عنوان مقدار برمیگردونه |
ایجاد سفارش
سفارش رو اینجا میکنین و تا 10 دقیق زمان دارین سفارشتون رو با درخواست GetCode نهایی و کد رو دریافت کنین .
GET
https://gifkart.com/gapi/?APIKEY=[YOURAPIKEY]&CreateOrder=[product_id]
اطلاعات ارسالی
| پارامتر |
اجباری |
توضیحات |
| APIKEY |
* |
کلید وبسرویس |
| CreateOrder |
* |
سریال محصول رو به عنوان مقدار قرار بدین |
پاسخ سرویس
| پارامتر |
توضیحات |
| order_id |
شماره سفارش ( برای پیگیری سمت خودتون ذخیره کنین ) |
| ExpireTime |
زمان منقضی شدن سفارش شما |
| Status |
وضعیت سفارش ( آخر متسندات حالات این مقدار رو میتونین بررسی کنین ) |
| Extra |
یه آرایه که اطلاعات در مورد محصول بهتون میده |
تکمیل سفارش
با شماره سفارش ، سفارشتون رو نهایی کنین و کد تحویل بگیرین
GET
https://gifkart.com/gapi/?APIKEY=[YOURAPIKEY]&GetCode=[order_id]
اطلاعات ارسالی
| پارامتر |
اجباری |
توضیحات |
| APIKEY |
* |
کلید وبسرویس |
| GetCode |
* |
شماره سفارش رو به عنوان مقدار قرار بدین |
پاسخ سرویس
| پارامتر |
توضیحات |
| CardCode |
کد گیفت کارت ( اگه محصول بصورت فوری نباشه بهتون dly-dly-dly رو برمیگردونه و بعدا میتونین از OrderStatus کد
رو دریافت کنین ) |
| Status |
وضعیت سفارش |
وضعیت سفارش
با شماره سفارش ، میتونید وضعیت سفارش رو بررسی کنین
GET
https://gifkart.com/gapi/?APIKEY=[YOURAPIKEY]&OrderStatus=[order_id]
اطلاعات ارسالی
| پارامتر |
اجباری |
توضیحات |
| APIKEY |
* |
کلید وبسرویس |
| OrderStatus |
* |
شماره سفارش رو به عنوان مقدار قرار بدین |
پاسخ سرویس
| پارامتر |
توضیحات |
| order_id |
شماره سفارش |
| ExpireTime |
زمان منقضی شدن سفارش شما |
| Status |
وضعیت سفارش ( آخر متسندات حالات این مقدار رو میتونین بررسی کنین ) |
| Extra |
یه آرایه که اطلاعات در مورد محصول بهتون میده |
خطا و توضیحات
توضیحات تکمیلی در مورد خطا هایی که ممکنه به شما بده
| پارامتر |
توضیحات |
| Status |
میتونه Active (فعال) ، Expired (منقضی باشه) یا Completed (تحویل شد) باشه ، نکته تو سفارش های تحویل با تاخیر
همون اول وضعیت سفارش Completed میشه . |
| Access Denied |
معمولا بخاطر آیپی آدرس هستش که ثبت نشده |
| missing APIKEY |
کلید وبسرویس اشتباهه یا نفرستادین |
| Insufficient balance |
موجودی کافی نیست |
| product_id NotFound |
سریال محصول که فرستادین اشتباهه یا نیست تو لیست ما |
| product not in stock |
موجودی این محصول به پایان رسیده |
| try again |
خطای وبسرویس |
| order_id NotFound |
این سفارش پیدا نشد |
| idk |
ممکنه باگ باشه ، بهم اطلاع بدین ، وقتی همه شرط ها رو رد کنه و نتونه جوابی بهتون برگردونه idk میده . |