وب سرویس API خرید گیفت کارت
با وبسرویس گیفت کارت شما میتونید تمامی محصولات مارو تو سایت یا اپلیکیشن خودتون داشته باشین و بدون داشتن هزینهی زیاد برای موجودی گیفت کارتها، از همهی سرویسهای ما استفاده کنید. برای گرفتن کلید وبسرویس با پشتیبانی در تماس باشید.
موجودی کیف پول
موجودی شمارو برای وبسرویس بهتون نمایش میده
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 میده.