كتالوج الخطط

الكتالوج

مسار واحد، بلا ترقيم وبلا مرشِّحات. يعرض الخطط النشطة، والخطط المتقاعدة مستبعَدة هنا لا محذوفة، لأنها تحتفظ بمشتركيها. وللاطلاع على الخطة السارية واستهلاكها، انظر الخطط والحصص.

عنصر الكتالوج

# NOT public — the caller must already have a workspace.
curl https://whats.azzamkh.sa/api/v1/plans \
  -H "Authorization: Bearer $WA_API_KEY"

# 200 OK
# {
#   "data": [
#     {
#       "id": "pln_...",
#       "code": "standard",
#       "version": 3,
#       "name": "Standard",
#       "description": null,
#       "price_amount_minor": null,
#       "currency": null,
#       "billing_interval": null,
#       "entitlements": [
#         { "key": "monthly_message_quota", "type": "number",
#           "unlimited": false, "value": 10000 },
#         { "key": "campaigns_enabled", "type": "boolean",
#           "unlimited": false, "value": true }
#       ]
#     }
#   ]
# }

الاستحقاقات

يحمل كل عنصر key وtype وراية unlimited وvalue. وتظهر المفردات نفسها في الخطة الحالية مقترنةً بما استُهلك منها.

• القيمة unlimited حالة، وليست قيمة دلالية مثل -1 أبدًا. فاستحقاق العدد إما بلا حدّ وإما يحمل قيمة.
• «بلا حدّ» ليس كـ«مفتاح غائب». فالصف بلا حدّ يقول إن الخطة قررت ألا تحدّه، والمفتاح الغائب يقول إن الخطة لا تحدّه أصلًا.
• الاستحقاق المنطقي مفتاح ميزة. وغيابه يعني السماح — ولا يمنع إلا false صريحة.
• الاستحقاقات تخص نسخة خطة. فمقارنة خطتين تعني مقارنة النسختين اللتين وردتا إليك لا مقارنة رمزين.

التسعير

لا توجد نقطة نهاية تغيّر خطة مساحة عمل. فتغيير الخطة يُرتَّب مع المشغّل ويطبّقه هو، إما فورًا وإما في نهاية الفترة.