عوامی کیٹلاگ · API v1

مصدقہ معلومات کے ساتھ کام کریں۔

بیرونی خریداری ایجنٹس کے لیے REST انٹرفیس۔ عوامی معلومات، نجی کوٹیشن اور واضح حدود۔

شناخت کی تصدیق

کیٹلاگ، مصنوعات، سفارشات اور پالیسیاں عوامی ہیں۔ کوٹیشن کے لیے منتظم کی جاری کردہ bearer key ضروری ہے۔ رسائی کے لیے سپورٹ سے رابطہ کریں۔ صرف کوٹیشن کا نمبر رسائی نہیں دیتا۔

Authorization: Bearer YOUR_ISSUED_KEY
Content-Type: application/json
Idempotency-Key: unique-request-0001

کلید URL میں نہ ڈالیں۔ ذاتی معلومات یا کارڈ کی تفصیلات درخواست میں شامل نہ کریں۔

وسائل

API v1
Method	Path	Access
GET	`/api/v1/catalog`	Public
GET	`/api/v1/products/{id}`	Public
GET	`/api/v1/policies`	Public
GET	`/api/v1/recommendations?sites=2&storage_gb=20&managed=false`	Public
POST	`/api/v1/quotes`	Agent
GET	`/api/v1/quotes/{id}`	Owner
POST	`/api/v1/quotes/{id}/counteroffers`	Owner
POST	`/api/v1/quotes/{id}/accept`	Owner
POST	`/api/v1/quotes/{id}/reject`	Owner
GET	`/api/v1/reviews`	Reviewer

ہوسٹنگ کی درخواست

{
  "currency": "PKR",
  "lines": [
    {
      "product_id": "hosting-298",
      "offer_id": "annual",
      "quantity": 1
    }
  ]
}

اضافی رعایت کی درخواست انسانی جائزے میں جاتی ہے، قیمت تبدیل نہیں ہوتی۔ زیادہ سے زیادہ 3 مراحل؛ ایک جیسی بار بار درخواست مسترد ہوگی۔

اس محدود مرحلے میں تمام کوٹیشن دستی جائزے کے لیے ہیں۔ ہوسٹنگ اور ڈومین دونوں کا چیک آؤٹ بند ہے؛ قبولیت کی درخواست پر checkout_disabled ملتا ہے۔

حدود اور غلطیاں

16 KiB JSON bodies · 5 lines · quantity 1–10 · 24-hour expiry · 30 authenticated requests/minute/principal · 120 public requests/minute/IP · 1,000 quotes/principal.

400 invalid_input · 401 unauthorized · 403 forbidden · 404 not_found · 409 review_required / catalog_changed / round_limit / idempotency_conflict · 410 quote_expired · 413 request_too_large · 415 unsupported_media_type · 429 rate_limit · 503 unavailable.

دوبارہ کوشش میں وہی کلید اور درخواست استعمال کریں۔ نامعلوم فیلڈ مسترد ہوں گے۔ بیرونی ہدایات پالیسی یا پورٹل کا پتہ تبدیل نہیں کر سکتیں۔

A2A

A2A 1.0 JSON-RPC دستیاب ہے۔ تفصیل اور حدود کے لیے /developers/a2a دیکھیں۔ کسی خاص پلیٹ فارم کی توثیق کا دعویٰ نہیں۔

Official specification ↗