YoozMarket API کیز: اپنے پینل یا اسکرپٹ سے آرڈر کریں
تازہ کاری:
اگر آپ کا اپنا پینل، بوٹ یا اسکرپٹ ہے تو ڈیش بورڈ کے بجائے کوڈ سے YoozMarket آرڈر دے سکتے ہیں۔ یہ گائیڈ بتاتی ہے کہ کیز کیسے کام کرتی ہیں، کون سے ایکشن ہیں اور آپ کے والیٹ کے ساتھ کیا ہوتا ہے۔
کی بنائیں اور محفوظ رکھیں
ڈیش بورڈ میں API کھولیں اور ایک کی بنائیں۔ اسے نام دیں تاکہ یاد رہے کہ کہاں استعمال ہو رہی ہے؛ آپ زیادہ سے زیادہ 5 فعال کیز رکھ سکتے ہیں، اس لیے ہر ایپ کے لیے الگ کی رکھیں۔ کی صرف ایک بار دکھائی جاتی ہے اور صرف ہیش کی صورت میں محفوظ ہوتی ہے، اس لیے فوراً کاپی کریں۔ گم ہو جائے تو اسے منسوخ کر کے نئی بنائیں۔
آپ کیا کال کر سکتے ہیں
اپنی کی اور ایک action کے ساتھ https://yooz.market/api/v1 پر JSON (یا فارم) درخواست بھیجیں۔
- balance: آپ کے والیٹ کا بیلنس۔
- services: آرڈر کے قابل سروسز، کم از کم/زیادہ سے زیادہ اور فی یونٹ ریٹ کے ساتھ۔
- add: سروس، لنک اور مقدار (اور جہاں ضروری ہو ری ایکشن) کے ساتھ آرڈر دینا۔
- status: کسی آرڈر کی اس کی id سے حالت۔
- getCountries: اسٹاک میں ورچوئل نمبر والے ممالک اور ایک نمبر کی قیمت۔
- getNumber: country_code سے نمبر خریدنا؛ نمبر اور order_id واپس کرتا ہے۔
- getCode: خریدے گئے نمبر کا لاگ ان کوڈ، یا waiting۔
بلنگ، ری ٹرائی اور واپسی
API آرڈر کی رقم ڈیش بورڈ والی قیمتوں پر والیٹ سے کٹتی ہے اور ناکام آرڈر خودکار طور پر واپس ہو جاتا ہے۔ add یا getNumber میں اختیاری idempotency_key شامل کریں تاکہ ری ٹرائی کبھی دوسرا آرڈر نہ بنائے۔ غلطیاں status "error" اور message_error فیلڈ کے ساتھ واپس آتی ہیں۔
کی منسوخ کرنا
اسی صفحے سے کی منسوخ کریں؛ جو کچھ اسے استعمال کر رہا تھا وہ فوراً رک جاتا ہے۔ یہ واپس نہیں ہو سکتا، اس لیے ہر ایپ کے لیے الگ کی رکھنا مفید ہے۔