تخطَّ إلى المحتوى
Core Cloud cloud.core.gen.tr

للمطوّرين

C2 Cloud API

كل ما يمكن سؤاله أو طلبه من أجهزتك وأقراصك وشبكاتك وسجلات DNS واشتراكاتك عبر HTTP. تُنشأ هذه الصفحة من الوصف نفسه الذي يقرأه مولّد العملاء، فلا يمكنها أن تذكر شيئًا لا تفعله الواجهة البرمجية.

العنوان الأساسي
https://cloud.core.gen.tr/api/v1
الإصدار
1.0.0
العمليات
414
في هذه الصفحة

01 نظرة عامة

ما هذه الواجهة البرمجية

واجهة API الخاصة بعملاء السحابة على https://cloud.core.gen.tr.

يجري التحقق من الهوية برمز وصول شخصي يُنشأ في حسابك ضمن الإعدادات ← رموز API، ويُرسل في الترويسة Authorization: Bearer <token>.

يحمل كل رمز مجموعة من الصلاحيات. ويُرفض بالرمز 403 كل طلب لا يحمل رمزه الصلاحية التي تشترطها نقطة النهاية، بصرف النظر عما يُسمح لمالك الرمز بفعله خلاف ذلك.

الأخطاء هي تفاصيل مشكلات وفق RFC 9457 بنوع الوسائط application/problem+json.

الوصف الذي أُنشئت منه هذه الصفحة منشور أيضًا، فيمكنك توليد عميلك بدلًا من كتابته يدويًا: OpenAPI بصيغة YAML · OpenAPI بصيغة JSON

استخدمها من مساعد

كل ما يلي هو HTTP، موجّه لبرنامج تكتبه أنت. أما إن كنت تريد أن تسأل مساعدًا بكلماتك — Claude Code أو Claude Desktop أو المساعد الموجود في حسابك أصلًا — فالسحابة نفسها متاحة عبر Model Context Protocol، بالرموز نفسها والفحوص نفسها.

استخدمه من Claude

02 المصادقة

الرمز، وما الذي يصل إليه

أنشئ رمز وصول شخصيًا من حسابك في الإعدادات ← رموز API، وأرسله مع كل طلب:

curl 'https://cloud.core.gen.tr/api/v1/me' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

يصل الرمز إلى الأضيق من حدّين

الصلاحية تقول ما أُنشئ الرمز لفعله. أمّا صلاحية حسابك فتقول ما يُسمح لك بفعله اليوم. يُفحص كل طلب في ضوء الاثنين معًا، فلا يمنح الرمز صاحبه شيئًا لا يسمح به حسابه أصلًا — ومن ضُيّقت صلاحياته بعد إنشاء رمزه لا يمكنه الاستمرار بالمستوى القديم من خلاله.

كلا الرفضين يعيد 403، والسبب مذكور في حقل detail من مستند الخطأ. اسأل GET /me عن الصلاحيات التي يحملها الرمز فعلًا، بدل تجريب نقاط النهاية وجمع الرفض.

الصلاحيات التي قد يحملها الرمز

الصلاحية ما الذي تتيحه صلاحية الحساب نقاط النهاية التي يفتحها
cloud:read يقرأ سحابتك — الأجهزة الافتراضية ووحدات التخزين ولقطاتها وملفات ISO والقوالب وقواعد جدار الحماية وعناوين IP العامة وVPN ومجموعات التقارب والعروض التي تقوم عليها، وسجلات استخدامك. كما يكشف كلمة المرور المحفوظة للجهاز. cloud: view GET /affinity-groups GET /compute-offerings GET /disk-offerings GET /egress-rules GET /ingress-rules GET /instances GET /instances/{instance} GET /instances/{instance}/annotations GET /instances/{instance}/events GET /instances/{instance}/networks GET /instances/{instance}/password GET /instances/{instance}/schedules GET /instances/{instance}/vm-snapshots GET /isos GET /isos/{iso} GET /networks GET /networks/{network} GET /public-ip-addresses GET /public-ip-addresses/{publicIPAddress} GET /public-ip-addresses/{publicIPAddress}/move-plan GET /templates GET /templates/{template} GET /usage GET /volumes GET /volumes/{volume} GET /volumes/{volume}/snapshot-policies GET /volumes/{volume}/snapshots GET /volumes/{volume}/snapshots/{snapshot} GET /vpn GET /vpn/users
cloud:write يشغّل أجهزتك ويوقفها ويعيد تشغيلها ويعيد تسميتها، ويعيد ضبط كلمة المرور ويفتح وحدة تحكم، ويربط ملفات ISO ووحدات التخزين ويفصلها، ويأخذ لقطات للأقراص، ويدير قواعد جدار الحماية ومستخدمي VPN ومجموعات التقارب. cloud: manage POST /affinity-groups DELETE /affinity-groups/{affinityGroup} PATCH /affinity-groups/{affinityGroup} POST /egress-rules DELETE /egress-rules/{egressRule} POST /ingress-rules DELETE /ingress-rules/{ingressRule} PATCH /ingress-rules/{ingressRule} PATCH /instances/{instance} POST /instances/{instance}/actions/attach-iso POST /instances/{instance}/actions/detach-iso POST /instances/{instance}/actions/reset-password POST /instances/{instance}/actions/restart POST /instances/{instance}/actions/start POST /instances/{instance}/actions/stop POST /instances/{instance}/annotations DELETE /instances/{instance}/annotations/{annotation} GET /instances/{instance}/console POST /instances/{instance}/networks/{network}/actions/attach POST /instances/{instance}/networks/{network}/actions/change-ip POST /instances/{instance}/networks/{network}/actions/detach POST /instances/{instance}/networks/{network}/actions/make-primary POST /instances/{instance}/networks/{network}/actions/move POST /instances/{instance}/schedules DELETE /instances/{instance}/schedules/{schedule} PATCH /instances/{instance}/schedules/{schedule} POST /instances/{instance}/vm-snapshots DELETE /instances/{instance}/vm-snapshots/{vmSnapshot} POST /instances/{instance}/vm-snapshots/{vmSnapshot}/actions/revert POST /isos/uploads DELETE /isos/uploads/{upload} GET /isos/uploads/{upload} POST /isos/uploads/{upload}/actions/complete POST /isos/uploads/{upload}/chunks DELETE /isos/{iso} PATCH /isos/{iso} DELETE /networks/{network} PATCH /networks/{network} POST /public-ip-addresses/{publicIPAddress}/actions/move PATCH /volumes/{volume} POST /volumes/{volume}/actions/attach POST /volumes/{volume}/actions/detach POST /volumes/{volume}/snapshot-policies POST /volumes/{volume}/snapshots DELETE /volumes/{volume}/snapshots/{snapshot} POST /volumes/{volume}/snapshots/{snapshot}/actions/restore PATCH /vpn POST /vpn/users DELETE /vpn/users/{vpnUser}
dns:read يقرأ نطاقات DNS الخاصة بك وكل سجل فيها. dns: view GET /dns-zones GET /dns-zones/{zone} GET /dns-zones/{zone}/records
dns:write ينشئ نطاقات DNS ويحذفها، ويضيف السجلات ويعدّلها ويزيلها، ويضبط سجل DNS العكسي لعنوان IP عام. dns: manage POST /dns-zones DELETE /dns-zones/{zone} POST /dns-zones/{zone}/records DELETE /dns-zones/{zone}/records/{record} PATCH /dns-zones/{zone}/records/{record} PATCH /public-ip-addresses/{publicIPAddress}
billing:read يقرأ اشتراكاتك وطلباتك ومدفوعاتك والمبالغ المستردة والبطاقات المحفوظة ورصيد حسابك وكتالوج المنتجات. billing: view GET /billing/account GET /billing/credits GET /credit-cards GET /domain-name-products GET /domain-name-products/{domainNameProduct} GET /ip-address-products GET /ip-address-products/{ipAddressProduct} GET /network-products GET /network-products/{networkProduct} GET /payments GET /payments/{payment} GET /payments/{payment}/invoice GET /payments/{payment}/proforma GET /refunds GET /service-products GET /service-products/{serviceProduct} GET /subscriptions GET /subscriptions/{subscription} GET /subscriptions/{subscription}/resize-quote GET /virtual-machine-products GET /virtual-machine-products/{virtualMachineProduct} GET /volume-products GET /volume-products/{volumeProduct}
billing:write يدفع فاتورة مفتوحة ببطاقة محفوظة، ويطلب استردادًا ضمن مهلة الاسترداد، ويؤكد الموافقة على إلغاء فاتورة شركتك، ويحذف بطاقة محفوظة. الدفع يخصم من البطاقة دون أي تأكيد إضافي؛ والبطاقة التي تحتاج إلى 3-D Secure تُعاد إلى المتصفح. ولا تُضاف البطاقة إلا من الموقع. billing: manage PATCH /billing/pay-day DELETE /credit-cards/{creditCard} POST /invoice-refund-requests/{invoiceRefundRequest}/actions/confirm POST /payments/{payment}/actions/pay POST /subscriptions/{subscription}/actions/refund
order:write يضع الطلبات ويغيّر حجم الاشتراكات ويلغيها. والطلب وتغيير الحجم ينفقان مالًا — إذ يُنفَّذان دون تأكيد إضافي، وتُدفع الفاتورة المستحقة من صفحة الفوترة أو باستخدام billing:write. لا تمنح هذه الصلاحية إلا لعميل تثق به في مالك. shop: manage POST /orders POST /subscriptions/{subscription}/actions/cancel POST /subscriptions/{subscription}/actions/cancel-resize POST /subscriptions/{subscription}/actions/resize
account:read يقرأ ملفك الشخصي وبيانات الاتصال الخاصة بك وصلاحيات الرمز المستخدم. account: view GET /account/billing-information GET /activity-log GET /me GET /me/settings
account:write يغيّر ملفك الشخصي وإعدادات الإشعارات الخاصة بك وبيانات الفوترة الخاصة بالحساب. account: manage PATCH /account/billing-information PATCH /me PATCH /me/settings
tickets:read يقرأ تذاكر الدعم الخاصة بك والردود عليها. tickets: view GET /tickets GET /tickets/{ticket}
tickets:write يفتح تذاكر الدعم ويردّ عليها ويغلقها — ويصل كلٌّ منها إلى فريق الدعم باسمك. tickets: manage POST /tickets POST /tickets/{ticket}/actions/close POST /tickets/{ticket}/comments
ai:read يقرأ مفاتيح بوابة الذكاء الاصطناعي الخاصة بك، والحدود التي وضعها فريقنا عليها، وما أنفقته. ai: view GET /ai/keys GET /ai/usage
ai:write ينشئ مفتاحًا لبوابة الذكاء الاصطناعي يُعرض سرّه مرة واحدة، ويلغي مفتاحًا. أما حدود المفاتيح فيضعها فريقنا ولا يمكن تغييرها من هنا. ai: manage POST /ai/keys DELETE /ai/keys/{aiKey}
admin:read admin يقرأ حساب أي عميل وأجهزته ونطاقات DNS واشتراكاته وسجلات التدقيق. يتطلب أيضًا دور المسؤول — لا يمنح الرمز أبدًا صلاحية لا يملكها صاحبه. — GET /admin/accounts GET /admin/accounts/{accountId} GET /admin/ai-conversations GET /admin/ai-conversations/public/{sessionId} GET /admin/ai-conversations/{conversationId} GET /admin/ai-gateway/models GET /admin/ai/prompts GET /admin/audit-logs GET /admin/audit-logs/search GET /admin/audit-logs/{auditLog} GET /admin/blog/front-page GET /admin/blog/posts GET /admin/carts GET /admin/carts/{cart} GET /admin/catalogue GET /admin/catalogue/building-blocks GET /admin/chargebacks GET /admin/cloud-scans GET /admin/coupons GET /admin/coupons/{coupon} GET /admin/customers GET /admin/customers/{user} GET /admin/customers/{user}/account GET /admin/customers/{user}/dns-zones GET /admin/customers/{user}/firewall-rules GET /admin/customers/{user}/instances GET /admin/customers/{user}/isos GET /admin/customers/{user}/isos/uploads/{upload} GET /admin/customers/{user}/snapshots GET /admin/customers/{user}/subscriptions GET /admin/dns-records GET /admin/dns-zones GET /admin/domain-prices GET /admin/dunning-preview GET /admin/exchange-rates GET /admin/failed-jobs GET /admin/failed-jobs/{failedJob} GET /admin/failed-payments GET /admin/faqs GET /admin/faqs/{faq} GET /admin/health GET /admin/horizon GET /admin/instances GET /admin/instances/{instance} GET /admin/invitations GET /admin/invoice-cancellations GET /admin/invoice-worklist GET /admin/jobs GET /admin/join-requests GET /admin/legal-documents GET /admin/legal-documents/{legalDocument} GET /admin/legal-documents/{legalDocument}/compare GET /admin/legal-documents/{legalDocument}/revisions GET /admin/networks GET /admin/news GET /admin/news/{news} GET /admin/partner-applications GET /admin/partner-rebates GET /admin/partner-setoffs GET /admin/partner-statements GET /admin/payments GET /admin/payments/{payment} GET /admin/price-notices GET /admin/privacy-requests GET /admin/product-prices GET /admin/public-ip-addresses GET /admin/referral-rewards GET /admin/refunds GET /admin/renewal-preview GET /admin/retained-resources GET /admin/roles GET /admin/screenshots GET /admin/seller-identity GET /admin/settings GET /admin/snapshots GET /admin/staff-invitations GET /admin/staged-actions GET /admin/staged-actions/{stagedAction} GET /admin/subscriptions GET /admin/subscriptions/{subscription} GET /admin/support-assignments GET /admin/tags GET /admin/tickets GET /admin/tickets/{ticket} GET /admin/usage GET /admin/volumes GET /admin/work-queues
admin:write admin يشغّل جهاز أي عميل ويوقفه ويعيد تشغيله، ويربط عليه ملف ISO أو يفصله، ويكتب مسودات الأخبار والأسئلة الشائعة والوثائق القانونية، ويرد على تذاكر الدعم ويسندها، ويدير الدعوات وإسنادات الدعم وتعليقات الاحتفاظ. أما النشر ومنح الرصيد وحظر تسجيل الدخول وكل إجراء آخر موجّه إلى الخارج فلا يفعل سوى وضعه في قائمة انتظار الموافقات، حيث يقرر فيه مسؤول من قسم الإدارة. يتطلب أيضًا دور المسؤول — لا يمنح الرمز أبدًا صلاحية لا يملكها صاحبه. — POST /admin/accounts/{accountId}/ai-limits POST /admin/accounts/{accountId}/bill-notices POST /admin/accounts/{accountId}/block POST /admin/accounts/{accountId}/combine-bills POST /admin/accounts/{accountId}/default-interest POST /admin/accounts/{accountId}/members/invite POST /admin/accounts/{accountId}/members/{member}/capabilities POST /admin/accounts/{accountId}/members/{member}/remove POST /admin/accounts/{accountId}/merge POST /admin/accounts/{accountId}/partner POST /admin/accounts/{accountId}/partner-bank-details POST /admin/accounts/{accountId}/partnership-end POST /admin/accounts/{accountId}/partnership-end/{notice}/outcome POST /admin/accounts/{accountId}/pay-day POST /admin/accounts/{accountId}/quotas POST /admin/ai/prompts POST /admin/audit-logs/verify POST /admin/blog/front-page POST /admin/blog/front-page/arrange POST /admin/blog/front-page/{cmsPostId}/unfeature POST /admin/carts/{cart}/clear POST /admin/carts/{cart}/coupon POST /admin/carts/{cart}/lines POST /admin/carts/{cart}/lines/{cartItem} POST /admin/carts/{cart}/lines/{cartItem}/move POST /admin/carts/{cart}/lines/{cartItem}/remove POST /admin/carts/{cart}/partner-code POST /admin/catalogue/translate POST /admin/cloud-scans POST /admin/coupons/{coupon} POST /admin/coupons/{coupon}/attach POST /admin/coupons/{coupon}/detach POST /admin/credit-grants/{creditGrant}/reduce POST /admin/credit-grants/{creditGrant}/remove POST /admin/customers POST /admin/customers/{user}/account/ai-limits POST /admin/customers/{user}/account/bill-notices POST /admin/customers/{user}/account/block POST /admin/customers/{user}/account/default-interest POST /admin/customers/{user}/account/members/invite POST /admin/customers/{user}/account/members/{member}/capabilities POST /admin/customers/{user}/account/members/{member}/remove POST /admin/customers/{user}/account/merge POST /admin/customers/{user}/account/partner POST /admin/customers/{user}/account/partner-bank-details POST /admin/customers/{user}/account/partnership-end POST /admin/customers/{user}/account/partnership-end/{notice}/outcome POST /admin/customers/{user}/account/pay-day POST /admin/customers/{user}/account/quotas POST /admin/customers/{user}/billing-info POST /admin/customers/{user}/delete POST /admin/customers/{user}/dns-records/{record} POST /admin/customers/{user}/dns-records/{record}/delete POST /admin/customers/{user}/dns-zones/{zone}/records POST /admin/customers/{user}/egress-rules POST /admin/customers/{user}/egress-rules/{egressRule}/delete POST /admin/customers/{user}/ingress-rules POST /admin/customers/{user}/ingress-rules/{ingressRule} POST /admin/customers/{user}/ingress-rules/{ingressRule}/delete POST /admin/customers/{user}/instances/{instance}/actions/attach-iso POST /admin/customers/{user}/instances/{instance}/actions/detach-iso POST /admin/customers/{user}/instances/{instance}/actions/restart POST /admin/customers/{user}/instances/{instance}/actions/start POST /admin/customers/{user}/instances/{instance}/actions/stop POST /admin/customers/{user}/instances/{instance}/rename POST /admin/customers/{user}/isos/uploads POST /admin/customers/{user}/isos/uploads/{upload}/abort POST /admin/customers/{user}/isos/uploads/{upload}/chunks POST /admin/customers/{user}/isos/uploads/{upload}/complete POST /admin/customers/{user}/notifications POST /admin/customers/{user}/password-reset POST /admin/customers/{user}/profile POST /admin/customers/{user}/public-ip-addresses/{address}/reverse-dns POST /admin/customers/{user}/retention/purge POST /admin/customers/{user}/snapshots/{snapshot}/delete POST /admin/customers/{user}/snapshots/{snapshot}/restore POST /admin/customers/{user}/tickets POST /admin/customers/{user}/volumes/{volume}/attach POST /admin/customers/{user}/volumes/{volume}/detach POST /admin/customers/{user}/volumes/{volume}/snapshots POST /admin/domain-prices POST /admin/exchange-rates/refresh POST /admin/invoice-cancellations/{invoiceCancellation}/confirm POST /admin/invoice-cancellations/{invoiceCancellation}/decline POST /admin/invoice-cancellations/{invoiceCancellation}/resolve POST /admin/invoice-cancellations/{invoiceCancellation}/retry POST /admin/news POST /admin/news/{news} POST /admin/news/{news}/publish POST /admin/news/{news}/schedule POST /admin/news/{news}/unschedule POST /admin/partner-rebates/{partnerRebate}/document POST /admin/partner-setoffs/{setoff}/return-request POST /admin/partner-setoffs/{setoff}/write-off POST /admin/partners/{partner}/reapplication POST /admin/partners/{partner}/statements POST /admin/payments/{payment}/chargebacks POST /admin/payments/{payment}/default-interest/restore POST /admin/payments/{payment}/default-interest/waive POST /admin/payments/{payment}/invoice POST /admin/payments/{payment}/reminder POST /admin/referrals/{referral}/refusal POST /admin/refunds/{refund}/retry POST /admin/refunds/{refund}/settle POST /admin/retention/networks/{network}/purge POST /admin/retention/{retainedResource}/reinstate POST /admin/roles POST /admin/roles/assignments POST /admin/roles/{role} POST /admin/roles/{role}/delete POST /admin/screenshots/{screenshot} POST /admin/screenshots/{screenshot}/delete POST /admin/screenshots/{screenshot}/publish POST /admin/seller-identity POST /admin/settings POST /admin/staff-invitations POST /admin/staff-invitations/{invitation}/resend POST /admin/staff-invitations/{invitation}/revoke POST /admin/subscriptions/{subscription}/agreed-price POST /admin/subscriptions/{subscription}/agreed-price/release POST /admin/tags POST /admin/tags/{tag} POST /admin/tags/{tag}/delete POST /admin/tickets/{ticket}/assignment POST /admin/tickets/{ticket}/close POST /admin/tickets/{ticket}/comments POST /admin/tickets/{ticket}/priority POST /admin/tickets/{ticket}/unassign POST /admin/token-revocation/break-glass
support:read support يقرأ حسابات العملاء المسندين إليك ومواردهم وسجلات التدقيق الخاصة بهم. يتطلب أيضًا دور الدعم، ويمرّ بنفس فحوصات الإسناد الموجودة في قسم الدعم. — GET /support/customers GET /support/customers/{user} GET /support/customers/{user}/audit-logs GET /support/customers/{user}/dns-zones GET /support/customers/{user}/instances GET /support/customers/{user}/subscriptions GET /support/customers/{user}/subscriptions/{subscription}/resize-quote GET /support/staged-actions/{stagedAction}
support:write support ينفّذ إجراءات على العملاء المسندين إليك كما يفعل قسم الدعم — أجهزتهم وشبكاتهم وشبكة VPN واللقطات وDNS وتذاكر الدعم والملف الشخصي وبيانات الفوترة والأعضاء، وإجراءات الفوترة المتاحة للدعم — كلٌّ منها فقط حيث يتيح لك إسنادك الإدارة. أما رصيد الحساب فلا يكون إلا طلبًا يوافق عليه مدير. يتطلب أيضًا دور الدعم. — POST /support/customers/{user}/billing-information POST /support/customers/{user}/billing/bill-notices POST /support/customers/{user}/billing/pay-day POST /support/customers/{user}/billing/refunds-block POST /support/customers/{user}/billing/shop-block POST /support/customers/{user}/credits POST /support/customers/{user}/credits/{creditGrant}/actions/adjust POST /support/customers/{user}/credits/{creditGrant}/actions/remove POST /support/customers/{user}/dns-zones POST /support/customers/{user}/dns-zones/{zone}/actions/delete POST /support/customers/{user}/dns-zones/{zone}/records POST /support/customers/{user}/dns-zones/{zone}/records/{record} POST /support/customers/{user}/dns-zones/{zone}/records/{record}/actions/delete POST /support/customers/{user}/instances/{instance}/actions/rename POST /support/customers/{user}/instances/{instance}/actions/restart POST /support/customers/{user}/instances/{instance}/actions/start POST /support/customers/{user}/instances/{instance}/actions/stop GET /support/customers/{user}/instances/{instance}/console POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/attach POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/change-ip POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/detach POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/make-primary POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/move POST /support/customers/{user}/instances/{instance}/vm-snapshots POST /support/customers/{user}/instances/{instance}/vm-snapshots/{vmSnapshot}/actions/delete POST /support/customers/{user}/instances/{instance}/vm-snapshots/{vmSnapshot}/actions/revert POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/confirm POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/decline POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/resolve POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/retry POST /support/customers/{user}/members/{member} POST /support/customers/{user}/members/{member}/actions/remove POST /support/customers/{user}/networks/{network}/actions/release POST /support/customers/{user}/password POST /support/customers/{user}/payments/{payment}/chargebacks POST /support/customers/{user}/profile POST /support/customers/{user}/public-ip-addresses/{publicIPAddress}/networks/{network}/actions/move POST /support/customers/{user}/social-accounts/{socialAccount}/actions/unlink POST /support/customers/{user}/subscriptions/{subscription}/actions/cancel POST /support/customers/{user}/subscriptions/{subscription}/actions/force-refund POST /support/customers/{user}/subscriptions/{subscription}/actions/lift-suspension POST /support/customers/{user}/subscriptions/{subscription}/actions/lock POST /support/customers/{user}/subscriptions/{subscription}/actions/request-invoice-cancellation POST /support/customers/{user}/subscriptions/{subscription}/actions/unlock POST /support/customers/{user}/subscriptions/{subscription}/actions/unstage-resize POST /support/customers/{user}/tickets/{ticket}/actions/close POST /support/customers/{user}/tickets/{ticket}/comments POST /support/customers/{user}/volumes/{volume}/snapshot-policies POST /support/customers/{user}/volumes/{volume}/snapshots POST /support/customers/{user}/volumes/{volume}/snapshots/{snapshot}/actions/delete POST /support/customers/{user}/volumes/{volume}/snapshots/{snapshot}/actions/restore POST /support/customers/{user}/vpn POST /support/customers/{user}/vpn/users POST /support/customers/{user}/vpn/users/{vpnUser}/actions/delete

03 القواعد المشتركة

ما تفعله كل نقطة نهاية بالطريقة نفسها

الطلبات والاستجابات

أرسل JSON واطلب JSON. يعود المورد المفرد تحت المفتاح data، وتعود القائمة تحت data ومعها meta وlinks. تتطلب كل عملية كتابة أن يكون بريد الحساب مُوثّقًا، تمامًا كما في الموقع.

التصفّح

تقبل القوائم page وper_page. القيمة الافتراضية لـ per_page هي 25، وكل قيمة فوق 100 تُخفَّض إلى 100. تحمل meta الإجماليات، ويحمل links الصفحات المجاورة.

حدود المعدّل

تُحسب الحدود لكل رمز لا لكل حساب، فلا يستهلك تكامل مبرمَج نصيب غيره. القراءات 120 في الدقيقة، والكتابات 60، وقراءة موظّف لبيانات عميل آخر 30، والطلب 5، والقراءة التي تُزامِن مع السحابة (refresh=true) 10 — وهذه الأخيرة تصل إلى السحابة نفسها فلا تُستخدم للاستطلاع المتكرر.

تحمل كل استجابة الترويسات RateLimit-Limit وRateLimit-Remaining وRateLimit-Reset، والأخيرة بالثواني. وعند تجاوز الحد تكون الاستجابة 429 مع Retry-After.

إعادة المحاولة بأمان

يتطلب الطلب ترويسة Idempotency-Key من اختيارك. يُحجز المفتاح قبل تنفيذ الطلب، فتحصل المحاولة المكرّرة أثناء تنفيذ الأولى على 409 بدل خصم ثانٍ، وتكرار طلب مكتمل يعيد الاستجابة الأولى بدل تنفيذ طلب جديد.

الأخطاء

شكل خطأ واحد للواجهة كلها — تفاصيل مشكلة وفق RFC 9457 تُقدَّم بنوع application/problem+json — فلا يحتاج أي عميل إلى التفريع بين صيغتين. فرّع على الحقل type، وهو معرّف ثابت واحد لكل رمز حالة. ولا تحمل أخطاء الخادم أي تفاصيل داخلية في بيئة التشغيل.

الحقل النوع الوصف
type string معرّف URI ثابت يحدد صنف الخطأ. واحد لكل رمز حالة.
title string ملخص قصير ثابت لصنف الخطأ — النص نفسه لكل حدوث لقيمة `type` واحدة، فيمكن عرضه أو المطابقة عليه بأمان. أما ما حدث هذه المرة فيحمله `detail`.
status integer رمز حالة HTTP، مكرَّرًا في الجسم.
detail string شرح مقروء للبشر لهذه الحالة بعينها. وفي استجابات 5xx يكون نصًا ثابتًا غير محدَّد في بيئة الإنتاج — إذ تُسجَّل التفاصيل الداخلية في السجلات ولا تُقدَّم أبدًا.
instance string مسار الطلب الذي أخفق.
errors اختياري object لا يظهر إلا في 422. يربط اسم الحقل بقائمة الرسائل.
{
    "type": "https://cloud.core.gen.tr/api/errors/validation-failed",
    "title": "Validation failed",
    "status": 422,
    "detail": "The name field is required.",
    "instance": "/api/v1/me"
}

العمليات

Identity

لمن يعود الرمز المُقدَّم.

GET /me #

الهوية الكامنة خلف الرمز المميز المقدَّم

account:read api.read

يعيد المستخدم المُوثَّق مع الصلاحيات التي يحملها الرمز المميز المستخدم في هذا الطلب. استدعِ هذه العملية لمعرفة ما يجوز للرمز المميز فعله، بدلًا من استكشاف نقاط النهاية وجمع ردود 403.

الاستجابات

  • 200 المستخدم المُوثَّق.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/me' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /activity-log #

قراءة سجل نشاطك

account:read api.read

كل سجل تدقيق يخصّك، الأحدث أولًا — وهو سجل النشاط على الموقع. ولا تُنشر أبدًا سلسلة السلامة ولا التغييرات المسجَّلة ولا سياق الطلب.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
domain اختياري query string one of cloud, billing, dns, tickets, account, auth, shop, privacy, partner, system

الاستجابات

  • 200 صفحة من سجلات التدقيق.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/activity-log' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Account

ملفك الشخصي وإعدادات الإشعارات الخاصة بك، وبيانات الفوترة الخاصة بالحساب — account:read للقراءة وaccount:write للتغيير. أما كلمات المرور وطرق الدخول ومفتاحا الأمان واتفاقية الترخيص فتبقى على الموقع.

PATCH /me #

تغيير ملفك الشخصي

account:write api.read api.write

نموذج الملف الشخصي على الموقع، حقلًا بحقل وبالقواعد نفسها: اسمك الكامل، وتاريخ ميلادك، ورقم هويتك (أو، للعميل الذي لغته ليست التركية، القيمة البديلة 22222222222 ورقم جواز سفر)، ورقم هاتفك، ولغتك. ويُحكم على وثيقة الهوية بلغتك أنت، كما يفعل الموقع. ويُتحقق من رقم الهوية التركي مقابل سجل السكان حيث يفعل النظام ذلك، ويكون الرفض 422 على الحقل identity_number. ولا تُعاد وثائق الهوية أبدًا.

يتطلب account:write، ويجب أن يملك صاحبه account: manage — وهذا أشد من الموقع، حيث يعدّل كل عضو ملفه الشخصي.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string اسمك الكامل — كلمتان على الأقل.
birthdate مطلوب string تاريخ ميلادك؛ يجب ألا يقل عمرك عن 18 عامًا.
identity_number مطلوب string رقم هويتك التركية، أو `22222222222` مع رقم جواز السفر.
passport_number اختياري string رقم جواز سفرك — مطلوب ما دامت لغتك ليست التركية ولا يوجد رقم محفوظ.
phone مطلوب string رقم هاتفك بالصيغة الدولية، يبدأ بـ `+`.
language مطلوب string اللغة التي تقرأ بها الموقع وإشعاراتك.

الاستجابات

  • 200 ملفك الشخصي بعد حفظه.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/me' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Ayşe Yılmaz",
    "birthdate": "string",
    "identity_number": "string",
    "phone": "+90 532 000 00 00",
    "language": "tr-TR"
}'
GET /me/settings #

إعدادات الإشعارات الخاصة بك

account:read api.read

مفاتيح الإشعارات الخاصة بك، ومفتاحا الأمان اللذان لا يُغيَّران إلا على الموقع.

الاستجابات

  • 200 إعداداتك.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/me/settings' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /me/settings #

تغيير إعدادات الإشعارات

account:write api.read api.write

يشغّل الإشعارات عبر البريد الإلكتروني والهاتف أو يوقفها؛ والحقل الذي لا ترسله يحتفظ بقيمته. ولا يُقبل هنا مفتاح الدخول بخطوتين عبر Telegram ولا مفتاح إلغاء رموز API — فلكلٍّ منهما بابه المُثبَت على الموقع، والرمز هو بالضبط بيانات الاعتماد التي ستستعملها جلسة مسروقة لإضعافهما. ويُسجَّل كل تغيير في سجل التدقيق.

جسم الطلب مطلوب

الحقل النوع الوصف
enable_email_notifications اختياري boolean الإشعارات عبر البريد الإلكتروني.
enable_phone_notifications اختياري boolean الإشعارات عبر الهاتف (Telegram).

الاستجابات

  • 200 إعداداتك بعد حفظها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/me/settings' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "enable_email_notifications": true,
    "enable_phone_notifications": true
}'
GET /account/billing-information #

بيانات الفوترة الخاصة بالحساب

account:read api.read

الجهة التي تُصدَر لها كل فاتورة وفاتورة مبدئية للحساب، والعملة التي تُحصَّل بها فواتيره.

الاستجابات

  • 200 بيانات الفوترة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/account/billing-information' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /account/billing-information #

تغيير بيانات الفوترة الخاصة بالحساب

account:write api.read api.write

نموذج الفوترة على الموقع، بالقواعد نفسها. تجعل corporate: true اسم الشركة والرقم الضريبي مطلوبين، والمكتب الضريبي أيضًا إذا كان بلد الفوترة تركيا؛ أما الشركة التي تُفوتَر في بلد آخر فتُدخل رقمها الضريبي الخاص ولا تحتاج إلى مكتب ضريبي. ويبقى حساب الشريك مؤسسيًا أيًّا كانت قيمة corporate: فالطلب الذي يتركه بلا اسم شركة ولا رقم ضريبي يُرفض بالرمز 422 على الحقل corporate. ويحدد البلدُ العملةَ التي تُحصَّل بها الفواتير (تركيا: الليرة التركية، وأي مكان آخر: الدولار)، ولذلك يُرفض بالرمز 422 على الحقل country كل تغيير ينقل العملة ما دامت هناك فواتير مفتوحة — سدِّدها أولًا. والاسم على الفاتورة هو دائمًا اسم مالك الحساب.

يتطلب account:write، ويجب أن يملك صاحبه account: manage — وهو الباب نفسه على الموقع.

جسم الطلب مطلوب

الحقل النوع الوصف
corporate اختياري boolean فاتورة مؤسسية. إن غاب أو كان false فهي فاتورة شخصية — إلا في حساب الشريك، الذي يبقى مؤسسيًا أيًّا كانت قيمة هذا الحقل.
company_name اختياري string اسم الشركة؛ مطلوب للفاتورة المؤسسية.
tax_number اختياري string الرقم الضريبي للشركة؛ مطلوب للفاتورة المؤسسية. أرقام إذا كان بلد الفوترة تركيا؛ وفي أي مكان آخر الرقم الضريبي الخاص بالشركة — أحرف وأرقام ومسافات وشرطات ونقاط، بحد أقصى 32، ويُحفظ مشذَّبًا وبأحرف كبيرة.
tax_office اختياري string المكتب الضريبي للشركة؛ مطلوب للفاتورة المؤسسية التي تُفوتَر في تركيا، واختياري في أي مكان آخر.
trade_registry_office اختياري string مكتب السجل التجاري، أو الجهة التي سجّلت الشركة في الخارج. اختياري، غير أنه لا يمكن حذفه لدى الشريك. وإن غاب بقي كما هو.
trade_registry_number اختياري string رقم السجل التجاري. اختياري، غير أنه لا يمكن حذفه لدى الشريك. وإن غاب بقي كما هو.
address مطلوب string عنوان الشارع.
city مطلوب string المدينة.
state اختياري string الولاية أو المقاطعة أو المنطقة — اختيارية. إن غابت بقيت القيمة المحفوظة كما هي، وإن أُرسلت فارغة حُذفت. خارج تركيا يُسجَّل النطاق بالولاية التي تعرفها جهة تسجيل النطاقات لذلك البلد، باسمها أو برمزها.
postal_code مطلوب string الرمز البريدي.
country مطلوب string بلد الفوترة — رمز ISO 3166 (`TR`، `792`) أو اسمه.
incorporation_country اختياري string بلد التأسيس، بالصيغ نفسها التي يقبلها `country`؛ وإن كان فارغًا فهو بلد الفوترة. وإن غاب بقي كما هو.

الاستجابات

  • 200 بيانات الفوترة بعد حفظها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/account/billing-information' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "string",
    "city": "string",
    "postal_code": "string",
    "country": "TR"
}'

العمليات

AI gateway

مفاتيح الحساب لبوابة الذكاء الاصطناعي — اعرضها واعرض ما أنفقته (ai:read)، وأنشئ مفتاحًا وألغِه (ai:write). أما حدود المفاتيح فيضعها فريقنا. وتجيب كل المسارات بـ 403 ما دامت البوابة معطَّلة.

GET /ai/keys #

عرض مفاتيح بوابة الذكاء الاصطناعي الخاصة بالحساب

ai:read api.read

كل مفتاح في الحساب، ساريًا كان أو ملغًى، الأحدث أولًا — دون أي سرّ أبدًا. ويحمل meta الحد الأقصى لمفاتيح الحساب، وعدد المفاتيح السارية، وعنوان البوابة الذي يتجه إليه برنامجك. وما دامت بوابة الذكاء الاصطناعي معطَّلة في النظام تجيب كل المسارات هنا بـ 403.

الاستجابات

  • 200 المفاتيح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/ai/keys' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /ai/keys #

إنشاء مفتاح لبوابة الذكاء الاصطناعي

ai:write api.read api.order

يُنشئ مفتاحًا على ميزانية البوابة الخاصة بالحساب ويجيب بـ 201 مع secret. السرّ موجود في هذه الاستجابة وحدها — لا يُحفظ في أي مكان، ويُستبدل السرّ المفقود بإنشاء مفتاح جديد. ويُحتسب المفتاح ضمن max_keys للحساب؛ فعند بلوغ الحد، أو أثناء إنشاء مفتاح آخر للحساب، أو ما دام المستخدم أو الحساب محظورًا، يُرفض الطلب بـ 409 ولا يُنشأ شيء. أما الحدود التي تقيّد المفتاح (الميزانية، والطلبات والرموز في الدقيقة، والنماذج المسموح بها) فيضعها فريقنا ولا يمكن تغييرها من هنا. ويُسجَّل كل مفتاح يُنشأ في سجل التدقيق.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string الاسم الذي تعطيه للمفتاح — به تميّزه حين يجب إلغاء أحدها.
expires_at اختياري string الوقت الذي يتوقف فيه المفتاح عن العمل من تلقاء نفسه؛ ويجب أن يكون في المستقبل. أغفله ليبقى بلا انتهاء.

الاستجابات

  • 201 المفتاح مع سرّه — يُعرض هذه المرة فقط.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 409 بلغ الحساب حد المفاتيح، أو يجري إنشاء مفتاح آخر، أو المستخدم أو الحساب محظور. لم يُنشأ شيء.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/ai/keys' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "ci runner"
}'
DELETE /ai/keys/{aiKey} #

إلغاء مفتاح لبوابة الذكاء الاصطناعي

ai:write api.read api.write

يطلب من البوابة التوقف عن قبول المفتاح، ثم يسجّل الإلغاء — لا بالعكس أبدًا، فالمفتاح الذي يظهر ملغًى يكون ميتًا فعلًا. ويجوز لكل عضو يدير مفاتيح الذكاء الاصطناعي للحساب أن يلغي مفتاحًا أنشأه زميل. متكافئ التكرار: إلغاء مفتاح ملغًى أصلًا يجيب بـ 200 معه. ومفتاح حساب آخر يجيب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
aiKey مطلوب path integer معرّف المفتاح.

الاستجابات

  • 200 المفتاح بعد إلغائه.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/ai/keys/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /ai/usage #

حدود بوابة الذكاء الاصطناعي والإنفاق

ai:read api.read

الحدود التي وضعها فريقنا على فريق البوابة الخاص بالحساب — الميزانية، والطلبات والرموز في الدقيقة، والنماذج التي يجوز للمفاتيح استدعاؤها — وما أنفقه الفريق، مقروءًا مباشرة من البوابة. والحدود هنا للقراءة فقط: فالموقع أيضًا لا يوفر بابًا لتغييرها. وحين لا تجيب البوابة تظل الحدود مقروءة ويذكر spend.error سبب غياب الرقم. وكلاهما null قبل أول مفتاح للحساب.

الاستجابات

  • 200 الحدود والإنفاق.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/ai/usage' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Compute

الأجهزة الافتراضية.

GET /instances #

سرد الأجهزة الافتراضية

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true للمطابقة مع المزوّد أولًا — فهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من الأجهزة الافتراضية.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /instances/{instance} #

قراءة جهاز افتراضي واحد

cloud:read api.read

لا يوجد DELETE للجهاز عن قصد: فالجهاز اشتراك مدفوع، ويُزال بإلغاء ذلك الاشتراك — POST /subscriptions/{subscription}/actions/cancel، والمعرّف هو اشتراك هذا الجهاز في GET /subscriptions. ويوقف الإلغاءُ الفوترةَ ويسلّم الجهاز إلى طابور الاحتفاظ، وهو المسار نفسه الذي يسلكه زر الإلغاء على الموقع.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 الجهاز الافتراضي.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /instances/{instance} #

إعادة تسمية جهاز افتراضي

cloud:write api.read api.write

السمة الوحيدة القابلة للتعديل. أما تغيير الحجم فهو حدث فوترة (POST /orders)، وتغييرات دورة الحياة فعمليات.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string

الاستجابات

  • 200 الجهاز الافتراضي بعد التحديث.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/instances/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
GET /instances/{instance}/networks #

سرد شبكات جهاز

cloud:read api.read

الشبكات التي عليها هذا الجهاز — واجهاته، مقروءةً من السحابة مباشرة — وشبكات الطالب التي يمكنه الانضمام إليها. ولا يُطابَق شيء: فالواجهة على شبكة لا يسمّيها أي سجل مخزّن بعد تُرجِع id: null. للقراءة فقط؛ لا يكتب شيئًا ولا يحذف شيئًا.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 شبكات الجهاز.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1/networks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /instances/{instance}/vm-snapshots #

سرد اللقطات الحية لجهاز

cloud:read api.read

نسخ الجهاز كاملًا، للجهاز الذي تتضمنها خطته. يُجاب من قاعدة البيانات؛ ومرّر refresh=true للمطابقة مع السحابة أولًا (بحدّ أضيق، وهي تحذف السجلات المحلية التي لم تعد السحابة تُدرجها). ولا تُدرج النسخ المنتظرة في طابور الاحتفاظ.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من اللقطات الحية.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1/vm-snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/vm-snapshots #

أخذ لقطة حية لجهاز

cloud:write api.read api.write

يبدأ نسخة من الجهاز كاملًا (مع ذاكرته إذا كانت with_memory صحيحة). ويُرفض بـ 409 ما دامت اللقطات الحية مُعطَّلة، أو إذا كانت خطة الجهاز لا تتضمنها أو استُنفد رصيدها، أو أثناء تغيير حجم الجهاز.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
description اختياري string
with_memory اختياري boolean

الاستجابات

  • 201 اللقطة، ويجري أخذها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/vm-snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
DELETE /instances/{instance}/vm-snapshots/{vmSnapshot} #

حذف لقطة حية

cloud:write api.read api.write

يحذف النسخة في السحابة. ولا يمكن التراجع عنه. والنسخة التي ما زال يجري أخذها تُرجِع 409.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
vmSnapshot مطلوب path integer

الاستجابات

  • 204 حُذفت.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/instances/1/vm-snapshots/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/vm-snapshots/{vmSnapshot}/actions/revert #

إعادة جهاز إلى لقطة حية

cloud:write api.read api.write

يعيد الجهاز إلى هذه النسخة في مكانه — فيضيع كل ما جرى بعدها. ويجب أن يكون الجهاز متوقفًا. وتُرفض النسخة التي تتضمن الذاكرة ما دام طلب استرداد يحتجز الجهاز. وكل رفض 409 يقول السبب.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
vmSnapshot مطلوب path integer

الاستجابات

  • 200 الجهاز بعد الإعادة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/vm-snapshots/1/actions/revert' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /instances/{instance}/schedules #

سرد جداول تشغيل جهاز

cloud:read api.read

جداول تشغيل الجهاز وإيقافه وإعادة تشغيله كما هي مخزّنة. ويسمّي paused_by الاحتجاز (التعليق، الاحتفاظ) الذي أوقف جدول تشغيل.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الجداول.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1/schedules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/schedules #

إضافة جدول تشغيل

cloud:write api.read api.write

جدول cron تنفّذه السحابة بنفسها. ولا يمكن إعطاء جهاز معلَّق جدولًا؛ ويُرفض جدول التشغيل بـ 409 ما دام طلب استرداد يحتجز الجهاز.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
action مطلوب string
name اختياري string
description اختياري string
cron_expression مطلوب string
timezone مطلوب string
enabled اختياري boolean
start_at اختياري string
end_at اختياري string

الاستجابات

  • 201 الجدول.
  • 202 أُنشئ، ولم تُدرجه السحابة بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/schedules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "start",
    "cron_expression": "0 8 * * 1-5",
    "timezone": "Europe/Istanbul"
}'
PATCH /instances/{instance}/schedules/{schedule} #

تعديل جدول تشغيل أو تبديله

cloud:write api.read api.write

يغيّر الجدول؛ وأرسل enabled لتشغيله أو إيقافه. وتشغيل جدول التشغيل تشغيلٌ للجهاز، فيُرفض على جهاز معلَّق، وبـ 409 ما دام طلب استرداد يحتجزه. والتبديل الصريح يمسح paused_by.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
schedule مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
name اختياري string
description اختياري string
cron_expression مطلوب string
timezone مطلوب string
enabled اختياري boolean
start_at اختياري string
end_at اختياري string

الاستجابات

  • 200 الجدول.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/instances/1/schedules/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "cron_expression": "0 8 * * 1-5",
    "timezone": "Europe/Istanbul"
}'
DELETE /instances/{instance}/schedules/{schedule} #

حذف جدول تشغيل

cloud:write api.read api.write

يحذف الجدول في السحابة وهنا.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
schedule مطلوب path integer

الاستجابات

  • 204 حُذف.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/instances/1/schedules/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /instances/{instance}/annotations #

سرد ملاحظات جهاز

cloud:read api.read

الملاحظات المحفوظة على الجهاز، مقروءةً من السحابة مباشرة. لا يكتب شيئًا ولا يحذف شيئًا.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الملاحظات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1/annotations' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/annotations #

إضافة ملاحظة إلى جهاز

cloud:write api.read api.write

يضيف ملاحظة إلى الجهاز.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
annotation مطلوب string

الاستجابات

  • 201 الملاحظة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/annotations' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "annotation": "string"
}'
DELETE /instances/{instance}/annotations/{annotation} #

حذف ملاحظة

cloud:write api.read api.write

يحذف إحدى ملاحظات هذا الجهاز؛ والملاحظة على جهاز آخر تُرجِع 404.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
annotation مطلوب path string

الاستجابات

  • 204 حُذفت.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/instances/1/annotations/annotation' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /instances/{instance}/events #

سرد أحداث جهاز

cloud:read api.read

ما جرى للجهاز — التشغيل والإيقاف والاستعادة — مقروءًا من سجل أحداث السحابة مباشرة. لا يكتب شيئًا ولا يحذف شيئًا.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الأحداث.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1/events' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/networks/{network}/actions/attach #

إضافة جهاز إلى شبكة أخرى

cloud:write api.read api.write

يضيف {network} إلى الجهاز بوصفها شبكة إضافية، مع إبقاء الشبكات التي عليها الجهاز في مكانها — وهو زر الإضافة على الموقع. ويجب أن يكون الجهاز والشبكة كلاهما للطالب (وما يعود لحساب آخر يُرجِع 404). والجهاز المقفل، أو رفض السحابة، يُرجِع 409 يقول الحقل detail فيه السبب.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
network مطلوب path integer

الاستجابات

  • 200 الجهاز كما هو مخزّن بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/networks/1/actions/attach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/networks/{network}/actions/detach #

إزالة جهاز من شبكة

cloud:write api.read api.write

يزيل الجهاز من {network} — وهو زر الفصل على الموقع. ويُرفض بـ 409 إذا كانت الشبكة الوحيدة للجهاز أو شبكته الأساسية، أو إذا ما زالت قواعد تُوجِّه إليه هناك.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
network مطلوب path integer

الاستجابات

  • 200 الجهاز كما هو مخزّن بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/networks/1/actions/detach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/networks/{network}/actions/make-primary #

جعل شبكة الشبكةَ الأساسية للجهاز

cloud:write api.read api.write

ينقل المسار الافتراضي للجهاز إلى {network}، التي يجب أن يكون عليها أصلًا. ويُوقَف الجهاز لذلك ولا يُعاد تشغيله.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
network مطلوب path integer

الاستجابات

  • 200 الجهاز كما هو مخزّن بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/networks/1/actions/make-primary' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/networks/{network}/actions/move #

نقل جهاز إلى شبكة أخرى

cloud:write api.read api.write

ينقل الجهاز من from_network_id إلى {network} في خطوة واحدة — وهو زر النقل على الموقع. ويُوقَف الجهاز لذلك. ويُرفض بـ 409 إذا تعذّر على الجهاز مغادرة الشبكة التي هو عليها.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
network مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
from_network_id مطلوب integer الشبكة التي يغادرها الجهاز (إحدى `GET /networks`).

الاستجابات

  • 200 الجهاز كما هو مخزّن بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/networks/1/actions/move' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "from_network_id": 1
}'
POST /instances/{instance}/networks/{network}/actions/change-ip #

تغيير العنوان الخاص للجهاز على شبكة

cloud:write api.read api.write

يمنح الجهاز العنوان الخاص ip_address على {network}. ويُوقَف الجهاز لذلك. والعنوان نفسه الذي يحمله أصلًا يُرجِع 422؛ أما العنوان خارج الشبكة أو المحجوز فيُرجِع 409 يقول ذلك.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer
network مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
ip_address مطلوب string

الاستجابات

  • 200 الجهاز كما هو مخزّن بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/networks/1/actions/change-ip' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "ip_address": "10.1.1.20"
}'
POST /instances/{instance}/actions/start #

تشغيل جهاز افتراضي

cloud:write api.read api.write

متكافئة التكرار (idempotent): تشغيل جهاز افتراضي يعمل أصلًا يعيد 200 فورًا دون الاتصال بالسحابة. فأدوات مثل Terraform وما شابهها تطابق الحالة المرغوبة بدل إصدار الأوامر، ولذلك يجب ألّا يؤدي طلب حالة يكون الجهاز الافتراضي فيها أصلًا إلى خطأ أبدًا.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الجهاز الافتراضي بعد تشغيله (أو وهو يعمل أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/actions/start' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/actions/stop #

إيقاف جهاز افتراضي

cloud:write api.read api.write

متكافئة التكرار (idempotent): إيقاف جهاز افتراضي متوقف أصلًا يعيد 200 فورًا دون الاتصال بالسحابة، للسبب نفسه المذكور في start.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الجهاز الافتراضي بعد إيقافه (أو وهو متوقف أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/actions/stop' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/actions/restart #

إعادة تشغيل جهاز افتراضي

cloud:write api.read api.write

غير متكافئة التكرار (idempotent) — فخلافًا لـstart/stop لا توجد حالة هدف تُقارَن بها، ولذلك يصل هذا الطلب إلى السحابة دائمًا مهما كانت حالة الجهاز الافتراضي الراهنة.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الجهاز الافتراضي بعد إعادة التشغيل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/actions/restart' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/actions/reset-password #

إعادة تعيين كلمة مرور جهاز افتراضي

cloud:write api.read api.write

غير متكافئة التكرار (idempotent): كل استدعاء يولّد كلمة مرور جديدة تمامًا ويحفظها، فتحلّ محل السابقة. اجلب النتيجة بعد ذلك من GET /instances/{instance}/password أو من data في هذه الاستجابة — أما كلمة المرور نفسها فلا تُدرج هنا أبدًا (انظر Instance).

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الجهاز الافتراضي بعد إعادة تعيين كلمة المرور.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/actions/reset-password' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /instances/{instance}/password #

قراءة كلمة مرور جهاز افتراضي

cloud:read api.read

يُجاب من قاعدة البيانات؛ ولا يتصل بالسحابة إطلاقًا. ويعيد null بدلًا من 403 عندما يكون الاشتراك المالك مقفلًا ولم يكن الطالب من الموظفين — فالجهاز الافتراضي مرئي، وكلمة مروره وحدها ليست كذلك.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 كلمة مرور الجهاز الافتراضي.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1/password' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /instances/{instance}/console #

فتح جلسة كونسول لجهاز افتراضي

cloud:write api.read api.write

يُنشئ في كل استدعاء جلسة كونسول جديدة لمرة واحدة في السحابة — وهي عملية على المزوّد لا قراءة من قاعدة البيانات، ولهذا تتطلب cloud:write لا cloud:read وتخضع لحد المعدل نفسه المطبَّق على عمليات دورة الحياة.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 عنوان URL لجلسة الكونسول.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/instances/1/console' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /instances/{instance}/actions/attach-iso #

إرفاق صورة ISO بجهاز افتراضي

cloud:write api.read api.write

متكافئة التكرار (idempotent): إرفاق صورة ISO مركّبة أصلًا على هذا الجهاز الافتراضي يعيد 200 فورًا دون الاتصال بالسحابة.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
iso_id مطلوب integer يجب أن يشير إلى صورة ISO يراها المستدعي (عامة أو خاصة به). والمعرّف الخاص بغيره أو غير الموجود يفشل في التحقق (422) لا بـ404 — فالمورد المخاطَب هو الجهاز الافتراضي، لا صورة ISO.

الاستجابات

  • 200 الجهاز الافتراضي بعد إرفاق صورة ISO (أو وهي مرفقة أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/actions/attach-iso' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "iso_id": 5
}'
POST /instances/{instance}/actions/detach-iso #

فصل صورة ISO المركّبة على جهاز افتراضي

cloud:write api.read api.write

متكافئة التكرار (idempotent): فصل صورة ISO عن جهاز افتراضي لا صورة مرفقة به يعيد 200 فورًا دون الاتصال بالسحابة.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer

الاستجابات

  • 200 الجهاز الافتراضي بعد فصل صورة ISO عنه (أو وهي مفصولة أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/instances/1/actions/detach-iso' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /isos/{iso} #

إعادة تسمية إحدى صور ISO الخاصة بك

cloud:write api.read api.write

يغيّر اسم صورة رفعتها ووصفها وعلامة قابلية الإقلاع — وهو نموذج التعديل على الموقع، بحقوله الثلاثة. وتُرفض الصورة العامة أو صورة حساب آخر.

المعاملات

الاسم الموضع النوع الوصف
iso مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
description مطلوب string
bootable مطلوب boolean

الاستجابات

  • 200 صورة ISO.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/isos/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "bootable": true
}'
DELETE /isos/{iso} #

حذف إحدى صور ISO الخاصة بك

cloud:write api.read api.write

يحذف صورة رفعتها، في السحابة وهنا. ولا يمكن التراجع عنه. وتُرفض الصورة العامة أو صورة حساب آخر.

المعاملات

الاسم الموضع النوع الوصف
iso مطلوب path integer

الاستجابات

  • 204 حُذفت.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/isos/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /isos/uploads #

بدء رفع ISO على أجزاء

cloud:write api.read api.write

يفتح رفعًا لصورة حجمها size بايت (4 GiB على الأكثر). أرسلها أجزاءً حجم كلٍّ منها chunk_size بايت (16 MiB؛ وقد يكون الأخير أقصر) عبر POST /isos/uploads/{upload}/chunks، بأي ترتيب ومن جديد بعد أي إخفاق، ثم POST …/actions/complete. ويجوز أن يكون للحساب ثلاث عمليات رفع مفتوحة في آن واحد؛ والرابعة تُرجِع 422. وتُحذف عمليات الرفع الخاملة ست ساعات.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
description مطلوب string
bootable مطلوب boolean
filename مطلوب string اسم الملف؛ ويجب أن ينتهي بـ `.iso` أو `.img`.
size مطلوب integer

الاستجابات

  • 201 عملية الرفع المفتوحة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/isos/uploads' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "bootable": true,
    "filename": "string",
    "size": 1
}'
GET /isos/uploads/{upload} #

قراءة عملية رفع مفتوحة

cloud:write api.read

عملية الرفع وأرقام الأجزاء المستلمة، فيرسل العميل الذي فقد موضعه ما ينقص فقط. وعملية رفع حساب آخر تُرجِع 404.

المعاملات

الاسم الموضع النوع الوصف
upload مطلوب path string

الاستجابات

  • 200 عملية الرفع المفتوحة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/isos/uploads/upload' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
DELETE /isos/uploads/{upload} #

إلغاء عملية رفع

cloud:write api.read api.write

يتخلى عن عملية الرفع ويحذف أجزاءها فورًا.

المعاملات

الاسم الموضع النوع الوصف
upload مطلوب path string

الاستجابات

  • 204 أُلغيت.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/isos/uploads/upload' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /isos/uploads/{upload}/chunks #

إرسال جزء من عملية رفع

cloud:write api.read api.write

جزء واحد بصيغة multipart/form-data: index (يبدأ من 0) وfile. ويجب أن يكون كل جزء عدا الأخير chunk_size بايت تمامًا؛ والجزء ذو الحجم الخاطئ، أو الرقم خارج عملية الرفع، يُرجِع 422. وإرسال الجزء مرة أخرى يستبدله.

المعاملات

الاسم الموضع النوع الوصف
upload مطلوب path string

الاستجابات

  • 200 عملية الرفع وقد استُلم هذا الجزء.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/isos/uploads/upload/chunks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /isos/uploads/{upload}/actions/complete #

إكمال عملية رفع وتسجيل ISO

cloud:write api.read api.write

يجمع الأجزاء ويسجّل الصورة لدى السحابة. 201 مع ISO؛ و202 حين تستلم السحابة الصورة ولم تُدرجها بعد — فتظهر في GET /isos حين تفعل. والجزء الناقص يُرجِع 422. وتزول عملية الرفع بعد ذلك في الحالتين.

المعاملات

الاسم الموضع النوع الوصف
upload مطلوب path string

الاستجابات

  • 201 ISO المسجَّلة.
  • 202 سُجِّلت، ولم تُدرجها السحابة بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/isos/uploads/upload/actions/complete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Storage

وحدات التخزين وملفات ISO.

GET /volumes #

سرد الأقراص

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true للمطابقة مع المزوّد أولًا — فهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من الأقراص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/volumes' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /volumes/{volume} #

قراءة قرص واحد

cloud:read api.read

لا يوجد DELETE للقرص عن قصد: فالقرص الإضافي اشتراك مدفوع، ويُزال بإلغاء ذلك الاشتراك — POST /subscriptions/{subscription}/actions/cancel، والمعرّف هو اشتراك هذا القرص في GET /subscriptions. أما القرص الجذري للجهاز فيذهب مع الجهاز.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 القرص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/volumes/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /volumes/{volume} #

إعادة تسمية قرص

cloud:write api.read api.write

هذه هي الخاصية الوحيدة القابلة للتعديل. أما الربط والفصل فهما إجراءان، وتغيير الحجم حدث فوترة (POST /orders).

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string

الاستجابات

  • 200 القرص بعد التحديث.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/volumes/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /volumes/{volume}/actions/attach #

ربط قرص بأحد الأجهزة الافتراضية للمستدعي

cloud:write api.read api.write

متكافئة التكرار (idempotent): فربط قرص مرتبط أصلًا بالجهاز الافتراضي المذكور يُرجِع 200 فورًا دون الاتصال بالسحابة.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
instance_id مطلوب integer يجب أن يشير إلى جهاز افتراضي يملكه المستدعي. أما المعرّف العائد لغيره أو غير الموجود فيُخفق في التحقق (422) لا بـ 404 — لأن المورد المقصود هو القرص لا الجهاز الافتراضي.

الاستجابات

  • 200 القرص بعد ربطه (أو وهو مرتبط أصلًا بالجهاز الافتراضي المذكور).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/volumes/1/actions/attach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "instance_id": 17
}'
POST /volumes/{volume}/actions/detach #

فصل قرص عن الجهاز الافتراضي المرتبط به

cloud:write api.read api.write

متكافئة التكرار (idempotent): ففصل قرص مفصول أصلًا يُرجِع 200 فورًا دون الاتصال بالسحابة.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer

الاستجابات

  • 200 القرص بعد فصله (أو وهو مفصول أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/volumes/1/actions/detach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /volumes/{volume}/snapshots #

سرد لقطات قرص

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true لمطابقة لقطات القرص مع السحابة أولًا — فهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير، ولا يجوز استخدامها للاستطلاع الدوري، وتحذف سجلات اللقطات المحلية التي لم تعد السحابة تسردها. واللقطة المنقولة إلى طابور الاحتفاظ (بعد إسقاط اللقطات من خطة القرص) لا تُسرد.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من لقطات القرص، الأحدث أولًا.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/volumes/1/snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /volumes/{volume}/snapshots #

أخذ لقطة يدوية لقرص

cloud:write api.read api.write

تُؤخذ اللقطة في الخلفية: ويحملها الجواب في الحالة Creating. وتُحتسب اللقطة اليدوية ضمن حدّ اللقطات. ويُعاد 409 عند بلوغ الحدّ (لا تُحتسب إلا اللقطات اليدوية)، أو إذا لم تتضمّن خطة القرص لقطات، أو أثناء تغيير حجم القرص أو الجهاز الذي يتبعه؛ ويبيّن الحقل detail في الجسم أيّها. وتُحذف اللقطة عبر DELETE /volumes/{volume}/snapshots/{snapshot}، وتُستعاد إلى قرص جديد عبر POST …/{snapshot}/actions/restore، وتُجدوَل عبر /volumes/{volume}/snapshot-policies.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer

جسم الطلب اختياري

الحقل النوع الوصف
name اختياري string تسمية اختيارية للّقطة.

الاستجابات

  • 201 اللقطة، وقد طُلبت ويجري أخذها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/volumes/1/snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "before-upgrade"
}'
GET /volumes/{volume}/snapshots/{snapshot} #

قراءة لقطة واحدة لقرص

cloud:read api.read

يُجاب من قاعدة البيانات. وتُرجِع لقطةُ قرص آخر، واللقطة المحتجزة في طابور الاحتفاظ، والمعرّف غير الموجود كلها 404.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer
snapshot مطلوب path integer

الاستجابات

  • 200 اللقطة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/volumes/1/snapshots/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
DELETE /volumes/{volume}/snapshots/{snapshot} #

حذف لقطة

cloud:write api.read api.write

يحذف اللقطة في السحابة، وهو الفعل نفسه الذي يؤديه زر الحذف على الموقع. ولا يمكن التراجع عنه. أما اللقطة المحتجزة في طابور الاحتفاظ فليس حذفها لك، ويُرجِع طلبها 404.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer
snapshot مطلوب path integer

الاستجابات

  • 204 حُذفت.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/volumes/1/snapshots/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /volumes/{volume}/snapshots/{snapshot}/actions/restore #

استعادة لقطة إلى قرص جديد

cloud:write api.read api.write

يُنشئ قرصًا جديدًا باسم name من اللقطة — ولا يُرجع القرص الذي أُخذت منه إلى الوراء في مكانه أبدًا. ويُحتسب القرص الجديد ضمن max_vols، ولا تُستعاد اللقطة الواحدة إلا عددًا محدودًا من المرات؛ ويسمّي 409 الحدّ الذي بُلغ، أو يقول إن استعادة أخرى تبدأ الآن على الحساب. وتجري الاستعادة في الخلفية: فيظهر القرص الجديد في GET /volumes حين تُبلغ عنه السحابة، ويحمل الجواب اللقطة وقد تحرّك restore_count فيها.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer
snapshot مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string اسم القرص الجديد.

الاستجابات

  • 202 بدأت الاستعادة؛ واللقطة التي بدأت منها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/volumes/1/snapshots/1/actions/restore' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "restored-data"
}'
GET /volumes/{volume}/snapshot-policies #

سرد جداول الاحتفاظ لقرص

cloud:read api.read

الجداول التي تحتفظ بها السحابة لهذا القرص — "احتفظ بـ7 يومية و4 أسبوعية". وتأخذ السحابة كل لقطة وفق جدولها وتحذف الأقدم بعد تجاوز العدد. يُجاب من قاعدة البيانات.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer

الاستجابات

  • 200 جداول الاحتفاظ الخاصة بالقرص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/volumes/1/snapshot-policies' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /volumes/{volume}/snapshot-policies #

إضافة جدول احتفاظ إلى قرص

cloud:write api.read api.write

نموذج الاحتفاظ على الموقع: فاصل زمني وعدد اللقطات المحتفَظ بها. وتشغّل السحابة الجدول في وقت خارج الذروة بتوقيت UTC. ويحدّ max_snaps حدُّ لقطات الحساب — وعلى قرص الإقلاع لجهاز، خطةُ الجهاز — ويقول 409 ذلك إذا كانت الخطة لا تتضمن لقطات أقراص أصلًا. ولا يوجد حذف: فالموقع لا يتيحه كذلك.

المعاملات

الاسم الموضع النوع الوصف
volume مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
interval_type مطلوب string
max_snaps مطلوب integer عدد اللقطات المحتفَظ بها من هذا الجدول.

الاستجابات

  • 201 الجدول.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/volumes/1/snapshot-policies' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "interval_type": "HOURLY",
    "max_snaps": 1
}'
GET /isos #

سرد سجلات ISO

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true للمطابقة مع المزوّد أولًا — فهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري.

يشمل كل سجل ISO مرئي للطالب: سجلاته الخاصة، إضافةً إلى كل سجل ISO يعلّمه المزوّد بأنه عام.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من سجلات ISO.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/isos' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /isos/{iso} #

قراءة سجل ISO واحد

cloud:read api.read

يكون مرئيًا إن كان عامًا أو إن كان مملوكًا للطالب. أما سجل ISO خاص يعود لعميل آخر فيجيب بـ 404، دون تمييز له عن سجل غير موجود أصلًا.

المعاملات

الاسم الموضع النوع الوصف
iso مطلوب path integer
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 سجل ISO.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/isos/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Catalogue

القوالب والعروض — كتالوج المنتجات العالمي القابل للبيع الذي يُبنى منه كل جهاز افتراضي وكل وحدة تخزين. للقراءة فقط: راجع وصف كل نقطة نهاية لمعرفة سبب عدم إتاحة المزامنة هنا إطلاقًا.

GET /templates #

سرد القوالب

cloud:read api.read

مطابقة الكتالوج مع المزوّد عملية إدارية شاملة قد تُزيل منتجات قابلة للبيع، ولذلك لا تُتاح هنا عن قصد. وتقدّم هذه النقطة دائمًا ما يعرفه الموقع بالفعل.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من القوالب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/templates' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /templates/{template} #

قراءة قالب واحد

cloud:read api.read

مطابقة الكتالوج مع المزوّد عملية إدارية شاملة قد تُزيل منتجات قابلة للبيع، ولذلك لا تُتاح هنا عن قصد. وتقدّم هذه النقطة دائمًا ما يعرفه الموقع بالفعل.

المعاملات

الاسم الموضع النوع الوصف
template مطلوب path integer

الاستجابات

  • 200 القالب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/templates/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /compute-offerings #

سرد عروض الحوسبة

cloud:read api.read

مطابقة الكتالوج مع المزوّد عملية إدارية شاملة قد تُزيل منتجات قابلة للبيع، ولذلك لا تُتاح هنا عن قصد. وتقدّم هذه النقطة دائمًا ما يعرفه الموقع بالفعل.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من عروض الحوسبة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/compute-offerings' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /disk-offerings #

سرد عروض الأقراص

cloud:read api.read

مطابقة الكتالوج مع المزوّد عملية إدارية شاملة قد تُزيل منتجات قابلة للبيع، ولذلك لا تُتاح هنا عن قصد. وتقدّم هذه النقطة دائمًا ما يعرفه الموقع بالفعل.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من عروض الأقراص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/disk-offerings' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Network

قواعد جدار الحماية وعناوين IP العامة وشبكات VPN ومجموعات التقارب. راجع وصف كل نقطة نهاية جماعية لمعرفة النظير المُزامِن الذي وُجدت لإبقائه خارج مسار الطلب — فموارد الشبكة هي الموضع الذي تتراكم فيه هذه المزامنة أشدّ ما يكون، إذ إن قراءة قواعد جدار الحماية قد تُزامن الأجهزة الافتراضية أيضًا.

GET /ingress-rules #

سرد قواعد جدار الحماية للدخول

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true للمطابقة مع المزوّد أولًا — فهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري. وهي أيضًا القراءة الأشد تدميرًا في هذه الواجهة: فطريقة المطابقة التي تستدعيها تحذف قواعد جدار الحماية المحلية التي تغفلها قائمة المزوّد، كما يطابق فرع الإنشاء فيها أجهزة المستدعي الافتراضية أيضًا، فيحذف منها كل ما تغفله القائمة.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من قواعد الدخول.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/ingress-rules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /ingress-rules #

إنشاء قاعدة جدار حماية للدخول

cloud:write api.read api.write

يحوّل تركيبة عنوان IP عام ومنفذ عام إلى منفذ خاص على أحد أجهزة المستدعي الافتراضية. يجب أن يشير public_ip_address إلى أحد عناوين IP العامة المحفوظة للمستدعي، وinstance_id إلى أحد أجهزته الافتراضية؛ وإخفاق أيٍّ منهما في التحليل يعطي 422 لا 404 — فالمورد المخاطَب هو نقطة المجموعة هذه.

جسم الطلب مطلوب

الحقل النوع الوصف
public_ip_address مطلوب string
protocol مطلوب string
public_port_start مطلوب integer
public_port_end مطلوب integer يجب أن يكون أكبر من `public_port_start` أو مساويًا له.
private_port_start مطلوب integer
private_port_end مطلوب integer يجب أن يكون أكبر من `private_port_start` أو مساويًا له.
instance_id مطلوب integer

الاستجابات

  • 201 قاعدة الدخول الجديدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/ingress-rules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "public_ip_address": "203.0.113.10",
    "protocol": "tcp",
    "public_port_start": 1,
    "public_port_end": 1,
    "private_port_start": 1,
    "private_port_end": 1,
    "instance_id": 17
}'
PATCH /ingress-rules/{ingressRule} #

إعادة توجيه قاعدة جدار حماية للدخول

cloud:write api.read api.write

السمات القابلة للتعديل فقط: المنافذ الخاصة التي تُحوِّل إليها القاعدة، وأيّ جهاز افتراضي من أجهزة المستدعي تُحوِّل إليه. يجب أن يشير instance_id إلى جهاز افتراضي يملكه المستدعي؛ والمعرّف الغريب أو غير الموجود يفشل في التحقق (422) لا بـ404 — فالمورد المخاطَب هو القاعدة، وقد حُلّت وتأكّدت ملكيتها قبل تنفيذ هذا الطلب.

المعاملات

الاسم الموضع النوع الوصف
ingressRule مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
private_port_start مطلوب integer
private_port_end مطلوب integer يجب أن يكون أكبر من `private_port_start` أو مساويًا له.
instance_id مطلوب integer

الاستجابات

  • 200 قاعدة الدخول بعد التحديث.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/ingress-rules/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "private_port_start": 1,
    "private_port_end": 1,
    "instance_id": 17
}'
DELETE /ingress-rules/{ingressRule} #

حذف قاعدة جدار حماية للدخول

cloud:write api.read api.write

الاستثناء الموثَّق الوحيد لقاعدة «كل تعديل يعيد التمثيل الحالي»: فلا يبقى شيء يُعاد بعد الحذف، ولذلك تُجيب هذه العملية بالرمز 204 بجسم فارغ بدل 200 مع المورد المحذوف.

المعاملات

الاسم الموضع النوع الوصف
ingressRule مطلوب path integer

الاستجابات

  • 204 تم حذف القاعدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/ingress-rules/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /egress-rules #

سرد قواعد جدار الحماية للخروج

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true للمطابقة مع المزوّد أولًا — فهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من قواعد الخروج.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/egress-rules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /egress-rules #

إنشاء قاعدة جدار حماية للخروج

cloud:write api.read api.write

يسمح بمرور حركة البيانات من source_cidr نحو destination_cidr. ويجب أن يكون كلاهما كتلة CIDR صحيحة التكوين — فوصول CIDR مشوَّه إلى السحابة من نقطة خاصة بجدار الحماية عيبٌ أمني، لا مجرد تدقيق شكلي.

جسم الطلب مطلوب

الحقل النوع الوصف
source_cidr مطلوب string
destination_cidr مطلوب string
protocol مطلوب string
port_start مطلوب integer
port_end مطلوب integer يجب أن يكون أكبر من `port_start` أو مساويًا له.

الاستجابات

  • 201 قاعدة الخروج الجديدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/egress-rules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_cidr": "10.0.0.0/24",
    "destination_cidr": "0.0.0.0/0",
    "protocol": "tcp",
    "port_start": 1,
    "port_end": 1
}'
DELETE /egress-rules/{egressRule} #

حذف قاعدة جدار حماية للخروج

cloud:write api.read api.write

الاستثناء الموثَّق الوحيد لقاعدة «كل تعديل يعيد التمثيل الحالي»: فلا يبقى شيء يُعاد بعد الحذف، ولذلك تُجيب هذه العملية بالرمز 204 بجسم فارغ بدل 200 مع المورد المحذوف.

المعاملات

الاسم الموضع النوع الوصف
egressRule مطلوب path integer

الاستجابات

  • 204 تم حذف القاعدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/egress-rules/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /networks #

سرد الشبكات

cloud:read api.read

شبكات الطالب المعزولة الخاصة به، والمجانية أولًا. يُجاب من قاعدة البيانات ولا يُطابَق مع المزوّد أبدًا — فلا يوجد معامل refresh، لأن القراءة المُطابِقة تحذف السجلات المحلية. استخدم قيمة id من هنا بوصفها network_id في سطر الطلب.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الشبكات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/networks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /networks/{network} #

قراءة شبكة

cloud:read api.read

إحدى شبكات الطالب. وشبكة حساب آخر تُرجِع 404، تمامًا كمعرّف غير موجود.

المعاملات

الاسم الموضع النوع الوصف
network مطلوب path integer

الاستجابات

  • 200 الشبكة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/networks/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /networks/{network} #

تسمية شبكة

cloud:write api.read api.write

يعيّن اسم الطالب الخاص للشبكة — وهو وسم لا تراه السحابة أبدًا. وتعيده القيمة null أو النص الفارغ إلى الاسم المولَّد.

المعاملات

الاسم الموضع النوع الوصف
network مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
label اختياري string

الاستجابات

  • 200 الشبكة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/networks/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "label": "string"
}'
DELETE /networks/{network} #

تحرير شبكة

cloud:write api.read api.write

يعيد شبكة فارغة إلى السحابة مع العنوان العام الذي تحمله. ويُقرَّر إن كان يجوز تحرير هذه الشبكة لحظةَ التحرير: فأي شيء ما زال عليها — جهاز أو عنوان مشترى أو اشتراكها — يرفضه بـ 409 يقول ما هو. ولا يمكن التراجع عنه.

المعاملات

الاسم الموضع النوع الوصف
network مطلوب path integer

الاستجابات

  • 204 حُرِّرت.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/networks/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /public-ip-addresses #

سرد عناوين IP العامة

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true للمطابقة مع المزوّد أولًا — فهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري. وهي تحذف السجلات المحلية التي لا تتضمنها قائمة المزوّد.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من عناوين IP العامة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/public-ip-addresses' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /public-ip-addresses/{publicIPAddress} #

قراءة عنوان IP عام

cloud:read api.read

يُجاب من قاعدة البيانات افتراضيًا. مرّر refresh=true لمطابقة مجموعة عناوين الطالب كاملةً مع المزوّد أولًا ثم انتقاء هذا العنوان منها قبل الرد — إذ لا يوجد لدى المزوّد استعلام عن عنوان مفرد. وهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري، وهي، مثل نقطة نهاية المجموعة، تحذف السجلات المحلية التي لا تتضمنها قائمة المزوّد.

المعاملات

الاسم الموضع النوع الوصف
publicIPAddress مطلوب path integer
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 عنوان IP العام.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/public-ip-addresses/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /public-ip-addresses/{publicIPAddress} #

ضبط سجل DNS العكسي لعنوان IP عام

dns:write api.read api.write

يكتب سجل PTR عبر خدمة DNS ويكتب السجل المحلي. ولا يغيّر شيئًا في السحابة، ولذلك يتطلب dns:write لا cloud:write، لكنه يتحقق أولًا من أن العنوان ما زال تابعًا لهذا الحساب في القائمة الحية للسحابة: يُرجع 422 إن لم يكن كذلك، و502 إن تعذّرت قراءة القائمة. انظر DNSUserService::updatePublicIPAddress().

المعاملات

الاسم الموضع النوع الوصف
publicIPAddress مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
reverse_record مطلوب string اسم مضيف DNS صالح.

الاستجابات

  • 200 عنوان IP العام بعد التحديث.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/public-ip-addresses/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reverse_record": "host.example.com"
}'
POST /public-ip-addresses/{publicIPAddress}/actions/move #

نقل عنوان عام إلى شبكة أخرى

cloud:write api.read api.write

ينقل عنوانًا مشترى إلى شبكة أخرى من شبكات الطالب. ولا تستطيع السحابة نقل العنوان، فتُحرِّره هذه العملية وتحجز عنوانًا جديدًا على الشبكة الهدف: فيتغيّر العنوان ولا يمكن التراجع. ولا يُحصَّل شيء. ويُرفض كلٌّ من عنوان source NAT الخاص بالشبكة، والعنوان الذي عليه قواعد توجيه أو VPN، والشبكة الهدف التي لا يعمل عليها شيء بعد، بـ 409 يقول ذلك.

المعاملات

الاسم الموضع النوع الوصف
publicIPAddress مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
network_id مطلوب integer الشبكة الهدف (إحدى `GET /networks`).

الاستجابات

  • 200 العنوان الجديد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/public-ip-addresses/1/actions/move' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_id": 1
}'
GET /public-ip-addresses/{publicIPAddress}/move-plan #

قراءة أين يمكن نقل عنوان

cloud:read api.read

هل يمكن نقل هذا العنوان وإلى أي شبكات الطالب، مع السبب إن تعذّر. يُجاب من الشبكات المخزّنة؛ ولا يُطابَق شيء.

المعاملات

الاسم الموضع النوع الوصف
publicIPAddress مطلوب path integer

الاستجابات

  • 200 الخطة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/public-ip-addresses/1/move-plan' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /vpn #

سرد شبكات VPN الخاصة بالمستدعي

cloud:read api.read

مجموعة لا كائن واحد: فقد لا يكون لحساب العميل أي شبكة VPN مُهيَّأة، وقد يكون له من حيث المبدأ أكثر من واحدة. يعتمد على قاعدة البيانات افتراضيًا؛ ومرِّر refresh=true لمطابقة البيانات مع المزوّد أولًا — وهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري، وهي تحذف الصفوف المحلية التي لا ترد في قائمة المزوّد.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من شبكات VPN.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/vpn' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /vpn #

تشغيل بوابة VPN أو إيقافها

cloud:write api.read api.write

يشغّل بوابة VPN للوصول عن بُعد على أحد عناوين الطالب العامة أو يوقفها — وهو المفتاح على الموقع. وتظهر البوابة في GET /vpn?refresh=true حين تُبلغ عنها السحابة. والتبديل الذي لم تُنفّذه السحابة يُرجِع 409 يقول ذلك؛ ويُدار المستخدمون عبر /vpn/users.

جسم الطلب مطلوب

الحقل النوع الوصف
public_ip_address_id مطلوب integer
enabled مطلوب boolean

الاستجابات

  • 204 تم التبديل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/vpn' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "public_ip_address_id": 1,
    "enabled": true
}'
GET /vpn/users #

سرد مستخدمي VPN

cloud:read api.read

يُجاب من قاعدة البيانات؛ ولا يتصل بالسحابة إطلاقًا. لا يوجد معامل refresh — فبخلاف عناوين IP العامة وشبكات VPN، ليس لهذه النقطة نظير مُطابِق متاح عبر واجهة البرمجة.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من مستخدمي VPN.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/vpn/users' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /vpn/users #

إنشاء مستخدم VPN

cloud:write api.read api.write

يُنشئ مستخدم VPN في السحابة تحت حساب المستدعي. ويجب أن يكون username غير مستخدَم بين مستخدمي VPN الخاصين بالمستدعي؛ أما الاسم الذي يستخدمه عميل آخر فلا يُعدّ تعارضًا.

يُتحقَّق من الحقلين وفق قاعدة مزوّد السحابة نفسه لا وفق قاعدة أوسع من عندنا: فكلٌّ منهما يجب أن يبدأ بحرف أو رقم، ثم يجوز أن يستخدم الحروف والأرقام ومجموعة صغيرة من علامات الترقيم — @ . - _ لاسم المستخدم، و@ + = . - _ لكلمة المرور. وأي قيمة خارج ذلك تُجاب هنا بـ 422. وكانت القيمة تُقبل سابقًا ثم يرفضها المزوّد بعد ذلك، فيصل ذلك إلى المستدعي على هيئة 502 يذكر نظامًا لا يملك أي وصول إليه.

جسم الطلب مطلوب

الحقل النوع الوصف
username مطلوب string
password مطلوب string

الاستجابات

  • 201 مستخدم VPN الجديد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/vpn/users' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "jdoe",
    "password": "string"
}'
DELETE /vpn/users/{vpnUser} #

حذف مستخدم VPN

cloud:write api.read api.write

الاستثناء الموثَّق الوحيد لقاعدة «كل تعديل يعيد التمثيل الحالي»: فلا يبقى شيء يُعاد بعد الحذف، ولذلك تُجيب هذه العملية بالرمز 204 بجسم فارغ بدل 200 مع المورد المحذوف.

المعاملات

الاسم الموضع النوع الوصف
vpnUser مطلوب path integer

الاستجابات

  • 204 حُذف مستخدم VPN.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/vpn/users/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /affinity-groups #

سرد مجموعات التقارب

cloud:read api.read

يُجاب من قاعدة البيانات؛ ولا يتصل بالسحابة إطلاقًا. ولا يوجد معامل refresh: فالنسخة التي تُجري المطابقة لهذه النقطة مدمِّرة على نحو لا يماثله شيء آخر في هذه الواجهة البرمجية — إذ تحذف مجموعات التقارب المحلية التي تغفلها قائمة المزوّد، وتحذف معها صفوف عضوية الأجهزة — ولذلك لا تُكشف هنا أبدًا.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من مجموعات التقارب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/affinity-groups' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /affinity-groups #

إنشاء مجموعة تقارب

cloud:write api.read api.write

يجب أن يكون name فريدًا بين مجموعات تقارب جميع العملاء — فالمزوّد لا يفصل أسماء مجموعات التقارب بحسب الحساب. ويجب أن يشير كل عنصر في instances.* إلى أحد أجهزة المستدعي نفسه؛ والمعرّف العائد لغيره أو غير الموجود يعطي 422 لا 404.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
description اختياري string
affinity_type مطلوب string
instances اختياري array of integer

الاستجابات

  • 201 مجموعة التقارب الجديدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/affinity-groups' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "web-tier",
    "affinity_type": "Host Affinity"
}'
PATCH /affinity-groups/{affinityGroup} #

إعادة تحديد عضوية مجموعة تقارب

cloud:write api.read api.write

السمة الوحيدة القابلة للتعديل: أيّ أجهزة المستدعي الافتراضية تنتمي إلى المجموعة. ولا يدعم المزوّد إعادة تسمية مجموعة تقارب أو تغيير نوعها بعد إنشائها. ويجب أن يشير كل عنصر في instances.* إلى أحد أجهزة المستدعي نفسه؛ والمعرّف العائد لغيره أو غير الموجود يعطي 422 لا 404 — فالمورد المُخاطَب هو المجموعة، وقد جرى تحليلها والتحقق من ملكيتها قبل تنفيذ هذا الطلب. والمصفوفة الفارغة تمسح عضوية المجموعة.

المعاملات

الاسم الموضع النوع الوصف
affinityGroup مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
instances مطلوب array of integer

الاستجابات

  • 200 مجموعة التقارب بعد تحديثها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/affinity-groups/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "instances": [
        17
    ]
}'
DELETE /affinity-groups/{affinityGroup} #

حذف مجموعة تقارب

cloud:write api.read api.write

الاستثناء الموثَّق الوحيد لقاعدة «كل تعديل يعيد التمثيل الحالي»: فلا يبقى شيء يُعاد بعد الحذف، ولذلك تُجيب هذه العملية بالرمز 204 بجسم فارغ بدل 200 مع المورد المحذوف.

المعاملات

الاسم الموضع النوع الوصف
affinityGroup مطلوب path integer

الاستجابات

  • 204 حُذفت مجموعة التقارب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/affinity-groups/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

DNS

المناطق والسجلات في تكامل DNS الخاص بالموقع. استخدام refresh=true في أي قراءة هنا هو أوسع مزامنة أثرًا في واجهة API بأسرها — فلا توجد عملية أولية لمزامنة منطقة واحدة، ولذلك يُعاد دائمًا مزامنة حساب DNS الخاص بالمُستدعي بالكامل، لا المورد الذي يخاطبه الطلب فحسب.

GET /dns-zones #

سرد مناطق DNS

dns:read api.read

يُجاب من قاعدة البيانات افتراضيًا. أرسل refresh=true للمطابقة مع خدمة DNS أولًا — هذا الشكل محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري. وخلافًا للمعامل نفسه في /instances أو /volumes، تطابق مطابقة DNS حساب DNS بالكامل للمستدعي، لا هذه القائمة وحدها: إذ لا توجد في الخدمة الأساسية وسيلة أرخص لمطابقة منطقة واحدة. كما تحذف المناطق المحلية (وسجلاتها تبعًا لها) التي لم تعد قائمة خدمة DNS تتضمنها.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من مناطق DNS.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/dns-zones' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /dns-zones #

إنشاء منطقة DNS

dns:write api.read api.write

يتطلب أن يكون واحد على الأقل من اشتراكات المستدعي في حالة النشر، ويرفض المنطقة السادسة — ويُتحقَّق من الأمرين قبل إنشاء المنطقة في خدمة DNS، فلا يترك الطلب المرفوض أبدًا منطقة يتيمة لدى المزوّد.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string اسم النطاق الخاص بالمنطقة، دون نقطة في آخره.

الاستجابات

  • 201 منطقة DNS الجديدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/dns-zones' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "example.com"
}'
GET /dns-zones/{zone} #

قراءة منطقة DNS

dns:read api.read

يُجاب من قاعدة البيانات افتراضيًا. أرسل refresh=true للمطابقة قبل الاستجابة — وكما في نقطة المجموعة، تطابق هذه العملية حساب DNS بالكامل للمستدعي (إذ لا توجد عملية مطابقة لمنطقة واحدة)، ثم تختار هذه المنطقة من النتيجة. وهذا الشكل محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري.

المعاملات

الاسم الموضع النوع الوصف
zone مطلوب path integer
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 منطقة DNS.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/dns-zones/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
DELETE /dns-zones/{zone} #

حذف منطقة DNS

dns:write api.read api.write

يحذف المنطقة في خدمة DNS وصفَّها المحلي، ومعها الصفوف المحلية لجميع سجلاتها. وهو الاستثناء الموثَّق الوحيد لقاعدة «كل تعديل يعيد التمثيل الحالي»: فلا يبقى شيء يُعاد، ولذلك تُجيب هذه العملية بالرمز 204 بجسم فارغ بدل 200 مع المورد المحذوف.

المعاملات

الاسم الموضع النوع الوصف
zone مطلوب path integer

الاستجابات

  • 204 تم حذف المنطقة (وسجلاتها).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/dns-zones/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /dns-zones/{zone}/records #

سرد سجلات منطقة DNS

dns:read api.read

يقرأ من قاعدة البيانات افتراضيًا: قراءة بسيطة لسجلات المنطقة نفسها، دون أي استدعاء للمزوّد (يجب أن تكون المنطقة نفسها مملوكة للمستدعي — تُحلّ ويُردّ 404 قبل البحث عن أي سجل). أرسل refresh=true للمطابقة أولًا — وكما في نقاط المنطقة، تطابق هذه العملية حساب DNS بالكامل للمستدعي، لا هذه المنطقة وحدها، وهي محدودة المعدل بصرامة أكبر بكثير.

المعاملات

الاسم الموضع النوع الوصف
zone مطلوب path integer
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من سجلات DNS الخاصة بالمنطقة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/dns-zones/1/records' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /dns-zones/{zone}/records #

إنشاء سجل DNS

dns:write api.read api.write

يتطلب أن يكون واحد على الأقل من اشتراكات المستدعي في حالة النشر، ويرفض السجل الـ256 في هذه المنطقة — ويُتحقَّق من الأمرين قبل إنشاء السجل في خدمة DNS. كما يؤدي إنشاء السجل إلى مطابقة حساب DNS بالكامل للمستدعي، كأثر جانبي لإعادة قراءة السجل الجديد — إذ لا توجد وسيلة أرخص للحصول على صفّه المحلي، لأن استدعاء المزوّد الأساسي لا يعيده. وتُرفض القيمة الموجودة بالفعل للاسم والنوع نفسيهما بالرمز 422 على الحقل data قبل كتابة أي شيء: القيمة الواحدة سجل واحد.

المعاملات

الاسم الموضع النوع الوصف
zone مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string القيمة النسبية (مثل `www`) تُستكمل تلقائيًا باسم المنطقة نفسها؛ أما القيمة المؤهَّلة بالكامل (المنتهية بنقطة) فتُستخدم كما هي.
type مطلوب string
data مطلوب string

الاستجابات

  • 201 سجل DNS الجديد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/dns-zones/1/records' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "www",
    "type": "A",
    "data": "203.0.113.5"
}'
PATCH /dns-zones/{zone}/records/{record} #

تحديث سجل DNS

dns:write api.read api.write

السمتان القابلتان للتعديل فقط: type وdata. يُحدِّث السجل في خدمة DNS وفي الصف المحلي مباشرة، مع الحفاظ على id السجل — فالخدمة الأساسية لا تحفظ التغيير محليًا من تلقاء نفسها، والمطابقة عبر المزامنة الشاملة للحساب بدلًا من ذلك كانت ستحذف هذا السجل وتُنشئ آخر بمعرّف مختلف. ويُرفض type وdata جديدان يحملهما سجل آخر بهذا الاسم بالفعل بالرمز 422 على الحقل data قبل كتابة أي شيء؛ أما إرسال القيمة الحالية للسجل نفسه فمقبول ولا يغيّر شيئًا.

المعاملات

الاسم الموضع النوع الوصف
zone مطلوب path integer
record مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
type مطلوب string
data مطلوب string

الاستجابات

  • 200 سجل DNS بعد التحديث.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/dns-zones/1/records/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "A",
    "data": "203.0.113.6"
}'
DELETE /dns-zones/{zone}/records/{record} #

حذف سجل DNS

dns:write api.read api.write

يحذف السجل في خدمة DNS وصفَّه المحلي. وهو الاستثناء الموثَّق الوحيد لقاعدة «كل تعديل يعيد التمثيل الحالي»: فلا يبقى شيء يُعاد، ولذلك تُجيب هذه العملية بالرمز 204 بجسم فارغ بدل 200 مع المورد المحذوف. وإذا لم تعد خدمة DNS تحتفظ بقيمة هذا السجل، تُجيب العملية بالرمز 409 وتُبقي الصف المحلي، ويُزامنه refresh=true في قائمة سجلات النطاق.

المعاملات

الاسم الموضع النوع الوصف
zone مطلوب path integer
record مطلوب path integer

الاستجابات

  • 204 تم حذف السجل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/dns-zones/1/records/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Billing

الكتالوج القابل للبيع، والاشتراكات وإلغاؤها، والمدفوعات، وبطاقات الائتمان المحفوظة، والاستردادات، ورصيد الحساب، وتقديم الطلبات. تدفع POST /orders من رصيد الحساب فقط. ومع billing:write يمكن دفع فاتورة مفتوحة ببطاقة محفوظة اجتازت 3-D Secure — أما البطاقة التي لم تجتزه فتُعاد إلى الموقع مع approval_url، لأن تحقق البنك يحتاج إلى شخص في المتصفح — ويمكن طلب استرداد وحذف بطاقة محفوظة؛ وتبقى إضافة البطاقة على الموقع. وراجع وصف كل نقطة نهاية لمعرفة النظير المُزامِن — إن وُجد — الذي تُبقيه عمدًا خارج مسار الطلب.

GET /virtual-machine-products #

سرد منتجات الأجهزة الافتراضية

billing:read api.read

كتالوج الأجهزة الافتراضية القابلة للبيع. لا يوجد معامل refresh: فهذه النقطة تُبنى من قاعدة البيانات بحكم تصميمها — ولا يُطابَق أي شيء هنا مع السحابة، بخلاف التعريفات التي بُنيت منها. ولا تُرجَع إلا المنتجات المنشورة، مطابقةً لـ VirtualMachineProductPolicy::view().

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من منتجات الأجهزة الافتراضية.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/virtual-machine-products' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /virtual-machine-products/{virtualMachineProduct} #

قراءة منتج جهاز افتراضي واحد

billing:read api.read

يُرجِع 404 للمنتج غير المنشور، مطابقةً لـ VirtualMachineProductPolicy::view() — وقد أُعيد إنتاج القاعدة هنا كقيد على الاستعلام، تمامًا كما يُعيد GET /isos/{iso} إنتاج قاعدة الظهور في IsoPolicy::view، لا كفحص سياسة كان سيُرجِع 403 بدلًا من ذلك.

المعاملات

الاسم الموضع النوع الوصف
virtualMachineProduct مطلوب path integer

الاستجابات

  • 200 منتج الجهاز الافتراضي.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/virtual-machine-products/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /volume-products #

سرد منتجات الأقراص

billing:read api.read

كتالوج الأقراص القابلة للبيع. لا يوجد معامل refresh للسبب نفسه المذكور في GET /virtual-machine-products. ولا تُرجَع إلا المنتجات المنشورة.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من منتجات الأقراص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/volume-products' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /volume-products/{volumeProduct} #

قراءة منتج قرص واحد

billing:read api.read

يُرجِع 404 للمنتج غير المنشور، مطابقةً لـ VolumeProductPolicy::view() — وقد أُعيد إنتاج القاعدة كقيد على الاستعلام لا كفحص سياسة.

المعاملات

الاسم الموضع النوع الوصف
volumeProduct مطلوب path integer

الاستجابات

  • 200 منتج القرص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/volume-products/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /ip-address-products #

سرد منتجات عناوين IP العامة

billing:read api.read

كتالوج عناوين IPv4 العامة القابلة للبيع. ولا تُرجَع إلا المنتجات المنشورة والمسعَّرة معًا — وهي القاعدة نفسها التي تبيع بها POST /orders. اطلبها بسطر من نوع ip_address.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من منتجات عناوين IP العامة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/ip-address-products' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /ip-address-products/{ipAddressProduct} #

قراءة منتج عنوان IP عام واحد

billing:read api.read

يُرجِع 404 للمنتج غير المنشور أو الذي لا خطة دفع له، وهو الرد نفسه الذي يتلقاه معرّف غير موجود.

المعاملات

الاسم الموضع النوع الوصف
ipAddressProduct مطلوب path integer

الاستجابات

  • 200 منتج عنوان IP العام.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/ip-address-products/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /network-products #

سرد منتجات الشبكات

billing:read api.read

كتالوج الشبكات الإضافية القابلة للبيع. ولا تُرجَع إلا المنتجات المنشورة والمسعَّرة معًا. اطلبها بسطر من نوع network؛ ولكل حساب شبكة مجانية واحدة أصلًا، تحسبها max_networks.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من منتجات الشبكات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/network-products' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /network-products/{networkProduct} #

قراءة منتج شبكة واحد

billing:read api.read

يُرجِع 404 للمنتج غير المنشور أو الذي لا خطة دفع له.

المعاملات

الاسم الموضع النوع الوصف
networkProduct مطلوب path integer

الاستجابات

  • 200 منتج الشبكة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/network-products/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /service-products #

سرد منتجات الخدمات

billing:read api.read

الخدمات التي تُقدَّم مرة واحدة ويبيعها المتجر — للقراءة فقط هنا. تُشترى الخدمة على الموقع، لا عبر POST /orders أبدًا: فشراؤها يُلزم شخصًا بإنجاز العمل. ولا تُرجَع إلا الخدمات التي يستطيع العميل شراءها فعلًا (منشورة ومسعَّرة ومعروضة إما بحرية أو إلى جانب قالب واحد على الأقل).

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من منتجات الخدمات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/service-products' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /service-products/{serviceProduct} #

قراءة منتج خدمة واحد

billing:read api.read

يُرجِع 404 للخدمة التي لا يستطيع العميل شراءها — غير المنشورة، أو غير المسعَّرة، أو غير المعروضة لأي شيء، أو تدريب الشراكة.

المعاملات

الاسم الموضع النوع الوصف
serviceProduct مطلوب path integer

الاستجابات

  • 200 منتج الخدمة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/service-products/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /domain-name-products #

سرد منتجات أسماء النطاقات الخاصة بك

billing:read api.read

أسماء النطاقات التي في سلة حسابك أو التي اشتراها — للقراءة فقط، ولا يُتاح إلا عند تفعيل إعادة بيع النطاقات؛ وإلا فالرد 404. ولا تُسرد أسماء نطاقات حساب آخر أبدًا. ويُشترى النطاق على الموقع، حيث يُسأل السجل عمّا إذا كان الاسم متاحًا.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من منتجات أسماء النطاقات الخاصة بحسابك.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/domain-name-products' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /domain-name-products/{domainNameProduct} #

قراءة منتج اسم نطاق واحد

billing:read api.read

يُرجِع 404 ما دامت إعادة بيع النطاقات مُعطَّلة، وللمنتج غير المنشور أو غير المسعَّر، ولاسم نطاق ليس في أي سلة أو اشتراك لحسابك.

المعاملات

الاسم الموضع النوع الوصف
domainNameProduct مطلوب path integer

الاستجابات

  • 200 منتج اسم النطاق.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/domain-name-products/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /subscriptions #

سرد الاشتراكات

billing:read api.read

يُجاب من قاعدة البيانات فقط — ولا يوجد معامل refresh. فخلافًا للأقراص أو الأجهزة الافتراضية، ليست النسخة التي تُجري المطابقة هنا (BillingUserService::listSubscriptions()) «سؤال المزوّد عمّا هو موجود»: بل هي عملية إصلاح إدارية ترفع كل اشتراك دون deployed إلى deployed (حتى إن مجرد السرد كان سيَعُدّ تجهيز مزوّد Terraform منتهيًا)، وتُنهي الاشتراكات التي انتقل جهازها الافتراضي، وتحذف اشتراكات أقراص ROOT مع دفعاتها، وتتصل بالسحابة. وهي لا تنتمي خلف طلب GET لعميل مهما كان حدّ المعدّل.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الاشتراكات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/subscriptions' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /subscriptions/{subscription} #

قراءة اشتراك واحد

billing:read api.read

تُفرض الملكية بوصفها قيدًا على الاستعلام لا فحصًا للسياسة: فاشتراك عميل آخر يجيب هنا بـ 404، بينما كان مسار الموقع نفسه (الربط الضمني مع SubscriptionPolicy) سيجيب بـ 403. ولا يوجد معامل refresh، للسبب نفسه المذكور في GET /subscriptions.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer

الاستجابات

  • 200 الاشتراك.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/subscriptions/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /subscriptions/{subscription}/actions/cancel #

إلغاء اشتراك

order:write api.read api.write

يُنهي الاشتراك. ويتطلب order:write لا billing:read: فالإلغاء يُنهي أصلًا مدفوعًا، ولذلك يقع خلف الموافقة المتعمدة نفسها على الكتابة التجارية التي يقع خلفها الطلب، وإن كان لا شيء هنا يسحب من بطاقة — وتوثيق الصنف TokenAbility صريح في أن شبكة القراءة/الكتابة ليس المقصود «إكمالها» بصلاحية billing:write مخصصة.

وهو متكافئ التكرار (idempotent) على اشتراك مُنهىً سلفًا: فتكرار الاستدعاء يعيد 200 مع التمثيل الحالي (المُنهى سلفًا) بدلًا من 409 الذي كان إلغاء ثانٍ سيُنتجه، فلا يفشل أمر Terraform destroy الذي يعيد المحاولة بعد انتهاء المهلة.

ويرفض إلغاء أي شيء ليس في حالة deployed حاليًا — جهاز افتراضي ما يزال يعمل، أو قرص ما يزال موصولًا، أو جهاز افتراضي/قرص مفقود — فيجيب بـ 409، لأن كلًّا من هذه الحالات حالة تعارض على الطالب حلّها أولًا (أوقف الجهاز الافتراضي، افصل القرص)، لا طلبًا مُشوَّه البنية.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer

الاستجابات

  • 200 الاشتراك بعد إنهائه (أو المُنهى سلفًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/subscriptions/1/actions/cancel' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /subscriptions/{subscription}/resize-quote #

تسعير تغيير الحجم

billing:read api.read

يسعّر نقل هذا الجهاز أو القرص أو الشبكة إلى product_id — وهو منتج من النوع نفسه — دون تغيير أي شيء. ويُرفض بـ 409 بكلمات الخدمة نفسها ما دام الشراء قابلًا للاسترداد (فلا يُتاح تغيير الحجم داخل مهلة الاسترداد)، أو ما دامت فاتورة مفتوحة، أو لأي سبب آخر كان الموقع سيرفضه من أجله.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer
product_id مطلوب query integer

الاستجابات

  • 200 عرض السعر.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/subscriptions/1/resize-quote' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /subscriptions/{subscription}/actions/resize #

تغيير حجم جهاز أو قرص أو شبكة

order:write api.read api.order

ينفّذ تغيير الحجم الذي سعّره GET /subscriptions/{subscription}/resize-quote، باللحظة التي سُعِّر فيها: أرسل token الخاص به بوصفه quote_token، ويُرفض تغيير الحجم بـ 409 إذا تغيّر السعر منذئذ (تدوم عروض الأسعار خمس دقائق).

ويكتمل التصغير، أو الانتقال إلى السعر نفسه، فورًا: فيُعيد التصغير الجزء غير المستهلك من الفترة — إلى البطاقة التي دفعت متى أمكن، وإلى رصيد الحساب متى تعذّر — ويقول refunds أين ذهب كل جزء. أما التكبير فيُهيَّأ وتُترك فاتورته ليدفعها شخص على payment_url (202)، تمامًا كما في POST /orders: فأول سحب من البطاقة يتطلب خطوة 3-D Secure تفاعلية. ويبقى الجهاز بحجمه ويبقى الاشتراك scaling حتى تُدفع تلك الفاتورة؛ ودفعها يُتمّ تغيير الحجم. ويتراجع POST …/actions/cancel-resize على الاشتراك الجديد عن تغيير حجم مُهيَّأ. وإذا بقيت فاتورة تغيير حجم مُهيَّأ دون دفع ثلاثة أيام، يُتراجَع عنه تلقائيًا: يعود الاشتراك إلى حجمه الحالي وإلى فوترته المعتادة، وتُسحب الفاتورة، ولا تتحرك أي أموال، ويُبلَّغ الحساب. ولا تُسحب أبدًا فاتورة مدفوعة.

يتطلب order:write وصلاحية إدارة الفوترة. ويلزم Idempotency-Key.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer
Idempotency-Key مطلوب header string مفتاح يختاره المستدعي ويجعل تكرار هذا الطلب آمنًا. يُحجز المفتاح قبل تنفيذ الطلب: فالتكرار الذي يصل والطلب الأول ما زال قيد التنفيذ يجيب بـ `409` بدل تحصيل ثانٍ، وتكرار طلب اكتمل بالفعل يعيد الاستجابة الأصلية مع الترويسة `Idempotent-Replay: true` بدل الطلب من جديد. المفاتيح خاصة بالمستدعي وتُحترم لمدة 24 ساعة. وإعادة استخدام مفتاح مع جسم مختلف تجيب بـ `409`.

جسم الطلب مطلوب

الحقل النوع الوصف
product_id مطلوب integer
quote_token مطلوب string

الاستجابات

  • 200 اكتمل تغيير الحجم (تصغير، أو انتقال لا يكلّف شيئًا).
  • 202 هُيِّئ التكبير؛ وتنتظر فاتورته على `payment_url` ثلاثة أيام، يُتراجَع بعدها عن تغيير الحجم غير المدفوع.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/subscriptions/1/actions/resize' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Idempotency-Key: a-key-you-choose' \
  -H 'Content-Type: application/json' \
  -d '{
    "product_id": 1,
    "quote_token": "string"
}'
POST /subscriptions/{subscription}/actions/cancel-resize #

التراجع عن تغيير حجم مُهيَّأ

order:write api.read api.write

على الاشتراك الجديد الذي هيّأه تغيير الحجم (حالته scaling): تُحذف فاتورته غير المدفوعة، ويُستعاد الاشتراك الذي حلّ محله، ولا يتحرك مال. ويُرفض بـ 409 تغيير الحجم الذي دُفعت فاتورته. ويُعيد الاشتراك المستعاد.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer

الاستجابات

  • 200 الاشتراك المستعاد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/subscriptions/1/actions/cancel-resize' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /subscriptions/{subscription}/actions/refund #

طلب استرداد

billing:write api.read api.order

زر الاسترداد على الموقع، يعمل بالشيفرة نفسها. داخل مهلة الاسترداد (سبعة أيام من الشراء) يعود المال إلى البطاقة التي دفعت وينتهي الشراء؛ ويجب إيقاف الجهاز أولًا، ويُرفض الجهاز الذي اشتُريت له خدمة سارية حتى تُسترد الخدمة.

وحين تكون هناك فاتورة صادرة للشراء، يجب إلغاؤها قبل أن يعود أي مال: فتكون الإجابة حينها 202 مع outcome: invoice_cancellation_requested، ويُفتح طلب إلغاء فاتورة مع تذكرة دعم، ويُوقف الجهاز فورًا. وتؤكد الشركة الإلغاء عبر POST /invoice-refund-requests/{invoiceRefundRequest}/actions/confirm. ويُرفض الطلب من جديد ما دام ذلك الطلب قائمًا؛ أما الطلب من جديد بعد أن يلغي الفريق الفاتورة فيعيد محاولة الاسترداد المستحق.

200 مع outcome: refunded عند إتمام الاسترداد؛ و202 مع outcome: refund_pending بينما يسوّيه البنك. وكل رفض هو 409 يحمل جملة الموقع نفسها: انقضت المهلة، أو الاستردادات محظورة على الحساب، أو غُيِّر حجم الشراء، أو ما زال طلب سابق مفتوحًا، وما إلى ذلك. واشتراك حساب آخر يجيب بـ 404.

يتطلب billing:write، ويجب أن يملك صاحبه billing: manage — وهو الباب نفسه على الموقع.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer معرّف الاشتراك.

الاستجابات

  • 200 تم الاسترداد.
  • 202 الاسترداد قيد التسوية، أو يقوم مقامه طلب لإلغاء الفاتورة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 رُفض الاسترداد؛ ويحمل `detail` جملة الموقع نفسها.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/subscriptions/1/actions/refund' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /payments #

سرد الدفعات

billing:read api.read

يُجاب من قاعدة البيانات افتراضيًا. وتكون الحقول amount/subtotal/taxes/discount/applied_balance/taxable_base/list_total/ catalogue_discount بقيمة null في أي دفعة لم يُعَد احتسابها قط — فإعادة الاحتساب عملية كتابة، ولذلك لا يُطلقها طلب GET عادي أبدًا. مرّر refresh=true لإعادة احتساب كل دفعة في الصفحة المُعادة؛ وهذه الصيغة محدودة المعدّل بصرامة أكبر بكثير ولا يجوز استخدامها للاستطلاع الدوري.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من الدفعات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/payments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /payments/{payment} #

قراءة دفعة واحدة

billing:read api.read

تُفرض الملكية بوصفها قيدًا على الاستعلام: فدفعة عميل آخر تجيب بـ 404. مرّر refresh=true لفرض إعادة احتساب amount والحقول الشقيقة له قبل الرد — وانظر وصف GET /payments لتعرف لماذا لا تفعل القراءة العادية ذلك أبدًا. ويُنشر رد المبالغ الذي أجراه مصرف العميل في chargebacks — مبلغه وتاريخه، ولا يُنشر سببه ولا مرجع المصرف أبدًا.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 الدفعة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/payments/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /payments/{payment}/invoice #

تنزيل فاتورة دفعة

billing:read api.read

مستند الفاتورة الذي أصدره محاسبنا لهذه الدفعة بصيغة PDF. ويُرجِع 404 حتى يُحفظ مستند.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer

الاستجابات

  • 200 الفاتورة بصيغة PDF.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/payments/1/invoice' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /payments/{payment}/proforma #

تنزيل الفاتورة المبدئية لدفعة

billing:read api.read

الفاتورة المبدئية لهذه الدفعة بصيغة PDF — مستند الموقع، باللغة التركية.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer

الاستجابات

  • 200 الفاتورة المبدئية بصيغة PDF.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/payments/1/proforma' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /payments/{payment}/actions/pay #

دفع فاتورة مفتوحة ببطاقة محفوظة

billing:write api.read api.order

يخصم من إحدى بطاقاتك المحفوظة لفاتورة مفتوحة، تمامًا كما يفعل زر الدفع على الموقع: يُطبَّق رصيد الحساب الممنوح أولًا، ويُخصم الباقي من البطاقة دون أي تأكيد إضافي، ويُستكمل ما اشترته الفاتورة — تجديدًا كان أو تغييرًا للحجم أو جهازًا. هذه العملية تنفق المال.

لا يمكن الخصم من بطاقة لم تجتز 3-D Secure دون شخص: فتكون الإجابة حينها 409 يحمل مستند مشكلتها code: three_d_secure_required وapproval_url — وهي صفحة الفاتورة على الموقع حيث يُكمل شخص تحقق البنك. ولا يبدأ هنا أي تحقق. وكما يحدث على الموقع، تُسجَّل المحاولة على الفاتورة، فتظهر فاشلة حتى تُدفع.

ويُرفض بالرمز 409 وبجملة الموقع نفسها: فاتورة مدفوعة أو مستردة أو ملغاة أصلًا، وفاتورة أُدمجت في دفعة واحدة لكل ما على الحساب، وفاتورة طلب لا يبيعه المتجر اليوم. والبطاقة التي ليست لك تُرفض بـ 422 على credit_card_id. وفاتورة حساب آخر تجيب بـ 404.

متكافئة التكرار (idempotent). ترويسة Idempotency-Key مطلوبة: فإعادة المحاولة بعد انتهاء المهلة لا تخصم مرتين أبدًا.

يتطلب billing:write، ويجب أن يملك صاحبه billing: manage — وهو الباب نفسه على الموقع.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer معرّف الفاتورة.
Idempotency-Key مطلوب header string مفتاح يختاره المستدعي ويجعل تكرار هذا الطلب آمنًا. يُحجز المفتاح قبل تنفيذ الطلب: فالتكرار الذي يصل والطلب الأول ما زال قيد التنفيذ يجيب بـ `409` بدل تحصيل ثانٍ، وتكرار طلب اكتمل بالفعل يعيد الاستجابة الأصلية مع الترويسة `Idempotent-Replay: true` بدل الطلب من جديد. المفاتيح خاصة بالمستدعي وتُحترم لمدة 24 ساعة. وإعادة استخدام مفتاح مع جسم مختلف تجيب بـ `409`.

جسم الطلب مطلوب

الحقل النوع الوصف
credit_card_id مطلوب integer إحدى بطاقاتك المحفوظة، كما تعرضها `GET /credit-cards`.

الاستجابات

  • 200 الفاتورة بعد دفعها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 لا يمكن الخصم لهذه الفاتورة على حالها — أو أن البطاقة تحتاج إلى 3-D Secure، وحينها يحمل المستند `code: three_d_secure_required` و`approval_url`.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/payments/1/actions/pay' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Idempotency-Key: a-key-you-choose' \
  -H 'Content-Type: application/json' \
  -d '{
    "credit_card_id": 1
}'
GET /credit-cards #

سرد بطاقات الائتمان المحفوظة

billing:read api.read

يُجاب من قاعدة البيانات افتراضيًا. يبقى تسجيل البطاقة على الموقع، وهو محمي أصلًا بجلسة وبالمصادقة الثنائية — لا تقبل هذه الواجهة رقم البطاقة (PAN) أبدًا، ولذلك لا يوجد POST هنا.

يسأل refresh=true بوابة الدفع مباشرة عمّا إذا كانت لا تزال تعرف كل بطاقة، باستدعاء واحد لكل بطاقة، ويحذف الصف المحلي لأي بطاقة لم تعد البوابة تحتفظ بها — وهذا ليس استدعاءً مجانيًا «للتحقق من الحالة»، بل مطابقة مدمِّرة يختارها المستدعي عن قصد. وهو محدود المعدل بصرامة أكبر بكثير من قراءة عادية.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
refresh اختياري query boolean default false المطابقة مع المزوّد قبل الإجابة بدل القراءة من قاعدة البيانات المحلية. يخضع لحدّ معدّل أضيق بكثير؛ لا تستخدمه للاستطلاع الدوري.

الاستجابات

  • 200 صفحة من بطاقات الائتمان المحفوظة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/credit-cards' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
DELETE /credit-cards/{creditCard} #

حذف بطاقة محفوظة

billing:write api.read api.write

يزيل إحدى بطاقاتك المحفوظة، تمامًا كما يفعل الموقع: يُفصل عنها كل اشتراك كان يتجدد بها (فتنتظر فاتورته التالية بطاقة أو تُرسل إليك)، وتُحذف البطاقة من بوابة الدفع أيضًا. والبطاقة التي حفظها مستخدم آخر — ولو في الحساب نفسه — تجيب بـ 404: فالبطاقات ملك للمستخدم الذي حفظها. أما إضافة بطاقة فتتطلب خطوة 3-D Secure لدى البنك وتبقى على الموقع.

يتطلب billing:write، ويجب أن يملك صاحبه billing: manage — وهو الباب نفسه على الموقع.

المعاملات

الاسم الموضع النوع الوصف
creditCard مطلوب path integer معرّف البطاقة، كما تعرضه `GET /credit-cards`.

الاستجابات

  • 204 حُذفت البطاقة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X DELETE 'https://cloud.core.gen.tr/api/v1/credit-cards/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /refunds #

سرد الاستردادات

billing:read api.read

استردادات الطالب وحده. ولا يوجد معامل refresh: فالاسترداد سجل لأمر وقع فعلًا (أو ما يزال معلقًا)، لا مورد حي لدى المزوّد تجري مطابقته.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الاستردادات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/refunds' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /invoice-refund-requests/{invoiceRefundRequest}/actions/confirm #

تأكيد جواز إلغاء فاتورة شركتك

billing:write api.read api.write

لا تُلغى فاتورة الشركة إلا بموافقتها: وهذا يسجّل الموافقة تمامًا كما يفعل زر التأكيد على الموقع، ثم يلغي الفريق الفاتورة ويُجري الاسترداد. ويُرفض بـ 409 إن لم يكن الطلب بانتظار تأكيد. وطلب حساب آخر يجيب بـ 404.

يتطلب billing:write، ويجب أن يملك صاحبه billing: manage — وهو الباب نفسه على الموقع.

المعاملات

الاسم الموضع النوع الوصف
invoiceRefundRequest مطلوب path integer معرّف طلب إلغاء الفاتورة، كما أعادته إجابة الاسترداد.

الاستجابات

  • 200 تم التأكيد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 الطلب ليس بانتظار تأكيد.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/invoice-refund-requests/1/actions/confirm' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /billing/account #

قراءة رصيد المستدعي وإجمالي المستحق عليه

billing:read api.read

لا يوجد معامل refresh: فكلٌّ من balance وdue مشتقّ مباشرة من صفوف مخزّنة، فليس ثمة ما تجري مطابقته مع مزوّد.

الاستجابات

  • 200 ملخّص حساب المستدعي.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/billing/account' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /billing/credits #

سرد الأرصدة الممنوحة

billing:read api.read

الأرصدة التي منحها فريقنا للحساب، الأحدث أولًا — ما مُنح، وما تبقى، ومتى تنتهي صلاحيته. يُمنح الرصيد ولا يُشترى، ويُطبَّق خصمًا عند دفع الفاتورة.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الأرصدة الممنوحة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/billing/credits' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
PATCH /billing/pay-day #

ضبط يوم الدفع للحساب

billing:write api.read api.write

يوم الشهر (1–28) الذي تتجدد فيه كل اشتراكات حسابك، فيتلقى الحساب فاتورة واحدة في الشهر — وهو إعداد يوم الدفع على الموقع. وتعيد القيمة null كل اشتراك إلى تاريخه الخاص. ولا يتغير شيء سبقت فوترته: يغطي التجديد التالي لكل اشتراك الأيام حتى يوم الدفع فقط بسعره اليومي المعتاد، ثم يتجدد بعد ذلك في يوم الدفع. ويحتفظ الاشتراك السنوي بشهره ويتجدد في يوم الدفع من ذلك الشهر. يجب إرسال pay_day؛ والقيمة خارج 1–28 تجيب بـ 422.

يتطلب billing:write، ويجب أن يملك صاحبه billing: manage — وهو الباب نفسه على الموقع.

جسم الطلب مطلوب

الحقل النوع الوصف
pay_day مطلوب integer يوم الشهر، أو null ليتجدد كل اشتراك في تاريخه الخاص.

الاستجابات

  • 200 حُفظ يوم الدفع.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X PATCH 'https://cloud.core.gen.tr/api/v1/billing/pay-day' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "pay_day": 1
}'
POST /orders #

إنشاء طلب يُخصم منه رصيد الحساب

order:write api.read api.order

يشتري أجهزة افتراضية وأقراصًا وعناوين IPv4 عامة وشبكات إضافية، ويطبّق ما يحمله الحساب من رصيد ممنوح بوصفه خصمًا، ويترك الباقي للبطاقة. وكما في تغيير الحجم، فإنه يُلزم الحساب بإنفاق المال؛ وتُسدَّد الفاتورة التي يتركها في متصفح على العنوان payment_url، أو ببطاقة محفوظة سبق أن اجتازت 3-D Secure عبر POST /payments/{id}/actions/pay (billing:write).

لا يوجد مسار للبطاقة هنا، وهذا أمر بنيوي لا إعداد يمكن تغييره: فأول عملية سحب على بطاقة محفوظة تتطلب دائمًا تحدي 3-D Secure تفاعليًا داخل المتصفح (القيمة الافتراضية لـ global_settings.shop_threeds_only هي true ولـ credit_cards.threeds_authorized هي false)، وهو ما لا يستطيع أي عميل بلا واجهة إتمامه. ولذلك يُنشأ الطلب وتُنشأ الاشتراكات، وتُترك الفاتورة كاملةً على الدفعة ليُسوّيها شخصٌ: يقول needs_card إن كان الأمر كذلك، ويقول credit_applied ما سيخصمه رصيد الحساب منها، ويقول payable ما يُطلب من البطاقة بعد ذلك، وpayment_url هو المكان الذي يُتمّ فيه متصفحٌ العملية. ولا تُحمَّل أي بطاقة في صمت.

وإنشاء الطلب لا يحرّك مالًا. لا يُؤخذ هنا شيء من الرصيد — إذ يُطبَّق الرصيد عند تسوية الدفعة، شأنه شأن أي فاتورة أخرى، فلا يحتجز الطلبُ الذي لا يدفعه أحد شيئًا من رصيد العميل. ولذلك فإن credit_applied وpayable تقديرٌ لما سيحدث عند الدفع، بينما يحمل كائن payment المتداخل حالَ السجل الآن: حقل amount فيه هو المبلغ الكامل، وحقل applied_balance هو 0.00 حتى تُدفع.

والرصيد الممنوح خصم يُطرح من المبلغ الصافي ومحدود بحصة منه، فيبقى عادةً في الطلب الذي له سعر مبلغ مستحق مهما كَبُر الرصيد. ولم يعد الطلب يُرفض لعدم كفاية الرصيد.

يمنح فريقنا الرصيد ولا يُشترى؛ ولا توجد وسيلة لإضافته من الواجهة البرمجية ولا من الموقع.

غير متزامنة. الدفع لا يعني التجهيز. إذ يتفاعل مستمع في الطابور مع الطلب ويتصل بالسحابة، فينقل كل اشتراك عبر new → pending → deployed أو failed. والاستجابة هي 202 وتحمل ترويسة Location تشير إلى الاشتراك الأول؛ ومن هناك استطلع GET /subscriptions/{id}. والاشتراك الذي لا يغادر pending أبدًا هو تجهيز فاشل لم يُسجَّل بعد — فراجع failure_reason على الاشتراك.

متكافئة التكرار (idempotent). ترويسة Idempotency-Key مطلوبة. ويُحجز المفتاح قبل تنفيذ الطلب، فالعميل الذي تنتهي مهلته ويعيد المحاولة بينما الطلب الأول ما يزال جاريًا يتلقى 409 لا عملية سحب ثانية؛ وبعد انتهاء الطلب الأول، يعيد المفتاح نفسه مع الجسم نفسه إرسال استجابة 202 الأصلية دون إنشاء أي شيء.

الشروط المسبقة، ويُتحقق من كلٍّ منها هنا تمامًا كما تفرضها صفحة الدفع على الموقع، ويُرفض الطلب بـ 422 يسمّي الشرط غير المستوفى: وجود معلومات الفوترة، وقبول اتفاقية ترخيص المستخدم النهائي، وتسجيل رقم هوية أو جواز سفر، وكون المتجر مفتوحًا، وعدم تجاوز حصص max_vms وmax_vols وmax_ips وmax_networks الخاصة بالطالب. ويتطلب العنوان كذلك شبكة يعمل عليها جهاز بالفعل — أو جهازًا لتلك الشبكة في الطلب نفسه (network). وليست نقطة النهاية هذه وسيلة لتجاوز أي حد يفرضه الموقع.

تتطلب صلاحية order:write، وهي مُعطَّلة افتراضيًا عند إصدار الرمز المميز ولا تتضمنها أي صلاحية أخرى ضمنًا.

المعاملات

الاسم الموضع النوع الوصف
Idempotency-Key مطلوب header string مفتاح يختاره المستدعي ويجعل تكرار هذا الطلب آمنًا. يُحجز المفتاح قبل تنفيذ الطلب: فالتكرار الذي يصل والطلب الأول ما زال قيد التنفيذ يجيب بـ `409` بدل تحصيل ثانٍ، وتكرار طلب اكتمل بالفعل يعيد الاستجابة الأصلية مع الترويسة `Idempotent-Replay: true` بدل الطلب من جديد. المفاتيح خاصة بالمستدعي وتُحترم لمدة 24 ساعة. وإعادة استخدام مفتاح مع جسم مختلف تجيب بـ `409`.

جسم الطلب مطلوب

الحقل النوع الوصف
items مطلوب array of object مُدخل واحد لكل وحدة مطلوبة. كرّر المُدخل لشراء نسختين من الشيء نفسه.

الاستجابات

  • 202 دُفع الطلب وأُدرج التجهيز في الطابور. وتشير `Location` إلى الاشتراك الأول.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 409 مفتاح `Idempotency-Key` مستخدَم من طلب ما يزال جاريًا، أو سبق استخدامه مع جسم مختلف.
  • 422 رُفض الطلب ولم يُنشأ شيء ولم يُحصَّل أي مبلغ. ويسمّي الحقل `errors` السبب: `items.*` لمنتج غير متاح أو خطة دفع غير مطابقة أو شبكة لا تخص الطالب، و`billing_info` أو `eula` أو `identity_number` أو `shop` أو `max_vms` أو `max_vols` أو `max_ips` أو `max_networks` أو `network` (عنوان في شبكة لا يعمل عليها شيء بعد) لشرط مسبق غير مستوفى. ولم يعد نقص الرصيد (`balance`) من بينها — فالرصيد غير الكافي لا يرفض الطلب، بل يخصم منه أقل ويترك مبلغًا أكبر في `payable`.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/orders' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Idempotency-Key: a-key-you-choose' \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [
        {
            "type": "virtual_machine",
            "product_id": 1,
            "payment_plan_id": 1
        }
    ]
}'

العمليات

Tickets

تذاكر الدعم الخاصة بحسابك: اقرأها، وافتح تذكرة، وردّ عليها، وأغلقها. وكل كتابة تصل إلى فريق الدعم فورًا باسم مالك الرمز، ولا يمكن التراجع عنها. ولا تُرفق الملفات إلا من الموقع.

GET /tickets #

سرد تذاكر الدعم الخاصة بك

tickets:read api.read

كل تذاكر الدعم في حساب المستدعي، بما فيها ما فتحه زملاؤه — القائمة التي تعرضها صفحة الدعم على الموقع. تحمل القائمة الحقائق الأساسية لكل تذكرة؛ اقرأ تذكرة واحدة لرؤية رسائلها.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من التذاكر.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/tickets' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /tickets #

فتح تذكرة دعم

tickets:write api.read api.write

يفتح تذكرة باسم مالك الرمز ويرسلها إلى فريق الدعم فورًا؛ فيُبلَّغ الفريق ويقرؤها. ولا يمكن التراجع عن ذلك. ولا يمكن إرفاق ملفات هنا — أضفها من صفحة التذكرة على الموقع.

جسم الطلب مطلوب

الحقل النوع الوصف
title مطلوب string سطر موضوع قصير.
body مطلوب string الرسالة.
category اختياري string موضوع التذكرة. `general` إن لم يُذكر.

الاستجابات

  • 201 التذكرة الجديدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/tickets' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Mail bounces since this morning",
    "body": "Every mail to our domain has bounced since 08:00."
}'
GET /tickets/{ticket} #

قراءة إحدى تذاكر الدعم الخاصة بك

tickets:read api.read

التذكرة مع رسالتها الأولى وكل رد عليها، من الأقدم إلى الأحدث. وتجيب تذكرة حساب آخر بـ 404، تمامًا كتذكرة غير موجودة.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer

الاستجابات

  • 200 التذكرة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/tickets/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /tickets/{ticket}/comments #

الرد على إحدى تذاكر الدعم الخاصة بك

tickets:write api.read api.write

يضيف ردًّا باسم مالك الرمز؛ فيُبلَّغ فريق الدعم ويقرؤه. ولا يمكن التراجع عن ذلك. ولا تقبل التذكرة التي بلغت solved أو ما بعدها أي رد وتجيب بـ 409 — افتح تذكرة جديدة بدلًا من ذلك. ولا يمكن إرفاق ملفات هنا.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer

جسم الطلب مطلوب

الحقل النوع الوصف
comment مطلوب string الرد.

الاستجابات

  • 201 الرد الجديد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 التذكرة محلولة أو مغلقة ولا تقبل ردودًا أخرى.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/tickets/1/comments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "comment": "It works again, thank you."
}'
POST /tickets/{ticket}/actions/close #

إغلاق إحدى تذاكر الدعم الخاصة بك

tickets:write api.read api.write

يغلق التذكرة؛ ويُبلَّغ فريق الدعم. ويجيب بـ 409 للتذكرة المغلقة أصلًا، ولتذكرة أمر العمل الخاصة بخدمة مشتراة ما زال بالإمكان استرداد ثمنها — فإغلاق تلك التذكرة يُنهي حق الاسترداد، ولذلك لا تُغلق إلا من صفحة التذكرة على الموقع.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer

الاستجابات

  • 200 التذكرة المغلقة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 التذكرة مغلقة أصلًا، أو هي أمر عمل لخدمة ما زال بالإمكان استرداد ثمنها.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/tickets/1/actions/close' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Usage

ما استهلكته سحابتك — ساعات الأجهزة والتخزين وساعات عناوين IP وحركة الشبكة. كميات فقط؛ والفاتورة ضمن الفوترة.

GET /usage #

قراءة ما استهلكته سحابتك

cloud:read api.read

ما ترسمه صفحة الاستخدام على الموقع: ساعات الأجهزة والتخزين وساعات عناوين IP وحركة الشبكة خلال فترة، مع سطر لكل جهاز ولكل قرص وسطر لكل يوم. كميات فقط — الفاتورة في /payments.

تُحدَّد الفترة بـ days (7 أو 30 أو 90؛ و30 إن غابت أو كانت أي قيمة أخرى) أو بـ from وto معًا. وتنتهي بالأمس على الأكثر، لأن اليوم لم يُحتسب بعد، ولا تتجاوز 365 يومًا. ويحصر instance_id أو volume_id الأرقام بأحد أجهزتك أو أقراصك؛ وما ليس لك يجيب بـ 404. ولا يبقى بعد الحصر إلا ما تقيسه السحابة لكل جهاز أو لكل قرص — يحتفظ الجهاز بساعاته وبتخزين أقراصه، والقرص بتخزينه. أما ساعات عناوين IP وحركة الشبكة واللقطات والقوالب فتُقاس لكل عنوان أو شبكة أو صورة، فلا تُقاس هناك: يذكر unmetered كل مفتاح من هذه باسمه، ورقمه ليس قياسًا ولا يعني أبدًا حركة صفرية.

يقرأ هذا سجلات الاستخدام الخاصة بالسحابة نفسها، ولذلك يُحتسب على ميزانية القراءة المُزامِنة الأضيق. وتُحفظ الفترة بعد قراءتها لمدة ساعة. وتعني available: false أن السجلات تعذّرت قراءتها الآن.

المعاملات

الاسم الموضع النوع الوصف
days اختياري query integer 7 أو 30 أو 90. يُتجاهل عند إعطاء `from` و`to` معًا.
from اختياري query string اليوم الأول، بصيغة YYYY-MM-DD (بتوقيت غرينتش).
to اختياري query string اليوم الأخير، بصيغة YYYY-MM-DD (بتوقيت غرينتش)؛ الأمس على الأكثر.
instance_id اختياري query integer أحد أجهزتك، بمعرّفه.
volume_id اختياري query integer أحد أقراصك، بمعرّفه. يُتجاهل عند إعطاء `instance_id`.

الاستجابات

  • 200 أرقام الفترة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/usage' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Admin

قراءات الموظفين لكامل التثبيت، إضافة إلى مجموعة صغيرة عن قصد من عمليات الكتابة على دورة حياة الجهاز الافتراضي، وهي متاحة لرمز يحمل admin:read أو admin:write ويحمل مالكه كذلك دور admin أو super-admin. ولا تكفي الصلاحية وحدها أبدًا: فالرمز يعيش أطول من الدور الذي كان يحمله صاحبه عند إصداره، ولذلك يُفحص الدور مع كل طلب.

ولا يستند الفصل بين القراءة والكتابة إلى شيء سوى جدول المسارات. إذ تُعيد AdminPolicyTrait::before() القيمة true لكل من يحمل دور admin، وتستخدمها كل سياسات التطبيق تقريبًا — فلا تستطيع أي سياسة أن تميّز قراءة المدير من كتابته؛ والتنفيذ كله هو abilities:admin:read مقابل abilities:admin:write مع فعل HTTP، ويسير اختبار على جدول المسارات ليُبقي الأمر كذلك.

وتقتصر عمليات الكتابة على دورة حياة الجهاز — التشغيل والإيقاف وإعادة التشغيل وإرفاق ISO وفصله — لأن المدير يملك أصلًا صلاحية كتابة كاملة على سحابة كل عميل عبر منطقة الإدارة، فمنعها عن رمز admin:write لم يكن ليضيف أمانًا؛ بل كان يعني فقط أن القناة الوحيدة القابلة للبرمجة هي القناة التي لا يستطيع أحد تدقيقها أو تحديد معدّلها. وهناك أمران غائبان عن عمد: حذف الجهاز، لأن subscriptions.instance_id يجب تحريره قبل حذف أي جهاز، والحذف المجرّد كان سيترك سطر فوترة حيًّا بلا مالك؛ وإرفاق وحدات التخزين وفصلها، لأن ذلك يحتاج إلى فحص ملكية متقاطع ثانٍ لا سابقة له على هذه الواجهة. وكلاهما مرشّح لجولة لاحقة، لا سهو.

وكل قراءة محصورة بعميل على هذه الواجهة تكتب سطر <domain>.pii_read في سجل التدقيق، تمامًا كما تفعل صفحة الإدارة المقابلة، ولهذا السبب تُحتسب على ميزانية معدّل أضيق من القراءة العادية. أما كل عملية كتابة فتكتب سطر cloud.instance_* الخاص بها صراحةً — إذ لا تسجّل وسيطة سجل الوصول سوى طلبات GET الناجحة — بما في ذلك الحالات التي تخطّى فيها التكافؤ استدعاء CloudStack الأساسي، لأن الفعل القابل للتدقيق هو الطلب الذي قدّمه المدير، لا ما إذا كان CloudStack قد استُدعي فعلًا.

ويقف محتوى التثبيت وقائمة انتظار الموافقات إلى جانب مسارات العملاء هذه، ولا يحتوي أيٌّ من مساراتها على {user}. تُنشأ مسودات الأخبار وتُعدَّل مباشرة؛ أما نشر أحدها فلا يكون إلا طلبًا — إذ يُدرجه الطلب في قائمة الانتظار ويجيب بـ 202 — وتُبلغ GET /admin/staged-actions بما آل إليه. ولا شيء في هذه الواجهة يوافق على طلب مُدرَج أو يرفضه: فذلك نقرة يؤديها مدير مسجَّل الدخول في صفحة الموافقات في منطقة الإدارة، فالرمز يستطيع أن يطلب ولا يستطيع أن يقرّر أبدًا. وتقرأ GET /admin/work-queues وGET /admin/health أعداد لوحة تحكم المشغّل وحالة سلامة التثبيت؛ ولا تذكر أيٌّ منهما اسم شخص. وتقرأ GET /admin/failed-jobs وGET /admin/jobs وGET /admin/horizon قائمة الانتظار — مهامها الفاشلة والمهام التي يتتبّعها Horizon وحالة عمّاله — ولا تعيد محاولة شيء ولا تحذفه ولا تعيد تشغيله.

GET /admin/customers #

سرد العملاء

admin:read api.read

كل حساب يحمل دور user، مرتّبًا حسب الاسم.

يتطلّب رمزًا مميزًا بصلاحية admin:read يحمل صاحبه أيضًا دور admin (أو super-admin). ولا تكفي الصلاحية وحدها: فالرمز يبقى بعد الدور الذي كان صاحبه يحمله عند إصداره، ولذلك يُفحص الدور في كل طلب.

ويختار الاستعلام الأعمدة المنشورة صراحةً بدل قراءة نماذج User كاملة — وهو الإسقاط المقصود نفسه الذي يستعمله جدول العملاء في منطقة الإدارة، بعدما أرسلت نسخة بلا إسقاط منه ذات مرة رقم الهوية الوطنية لكل عميل ضمن حمولة الصفحة.

ويعتمد هذا المسار على قاعدة البيانات، ولا توجد نسخة refresh في أي موضع من هذه الواجهة. فالنسخ التي تُجري المطابقة لهذه القراءات (listSubscriptions() وlistZones() وgetInstances()) تعدّل البيانات؛ وفي النطاق الإداري تعدّل التنصيب كله. ولا يوجد حدّ معدل يجعل وضع ذلك خلف طلب GET مقبولًا.

ولا تكتب هذه القائمة أي سجل تدقيق: فهي لا تنشر عن أي عميل أكثر من اسم وبريد إلكتروني، وكتابة صف لكل طلب عن كل صفحة من القائمة كانت ستُغرق سجل التدقيق دون أن تسجّل وصولًا إلى بيانات أحد بعينه. أما القراءات الخاصة بكل عميل أدناه فهي التي تُسجَّل.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من العملاء.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers #

طلب إنشاء حساب دخول عميل

admin:write api.read api.privileged

يُدرج إنشاء حساب دخول عميل، بحساب جديد خاص به، في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يُنشئ شيئًا: يجب أن يوافق مدير على السجل (approval_url). لا يختار أحد كلمة المرور: وعند الموافقة يُرسل إلى العنوان رابط إعادة التعيين المعتاد ويضع العميل كلمته بنفسه. وهو عميل دائمًا؛ ويُرفض بـ 422 وجود password أو role في الطلب، وكذلك عنوان له حساب دخول أو إنشاء بانتظار الموافقة.

وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
email مطلوب string
language مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "email": "string",
    "language": "tr-TR"
}'
GET /admin/customers/{user} #

جلب عميل واحد

admin:read api.read api.privileged

عميل واحد، مع أعداد مشتقّة من قاعدة البيانات لأجهزته الافتراضية وأقراصه ومناطق DNS الخاصة به واشتراكاته وفواتيره وتذاكره.

وتعيد صفحة الإدارة المقابلة أربعًا وعشرين خاصية في طلب واحد، وتتصل بـ CloudStack وPowerDNS وبوابة الدفع لبنائها. وهذا المسار هو تفكيك تلك الصفحة: فالأعداد هنا مجرّد select count(*)، أما التفاصيل فتقيم في المجموعات الأربع الخاصة بكل نطاق إلى جانب هذا المسار.

وقراءة سجل شخص آخر تكتب صفًا بالحدث account.pii_read في سجل التدقيق، تمامًا كما تفعل صفحة الإدارة المقابلة — فالتزام تسجيل الوصول في KVKK لا يتوقف عند حدود منطقة الإدارة. أما قراءة سجلك أنت فلا تكتب شيئًا: إذ كان الصف سيتكرّر مع كل تحميل للوحة تحكّمك، وأفعالك مسجَّلة أصلًا.

ولأن كل استدعاء يكتب سجل تدقيق، يُحتسب هذا المسار على ميزانية حدّ معدل أضيق من القراءة العادية.

ويمكن مخاطبة أي حساب هنا، لا الحسابات التي تحمل دور user وحدها — فصفحة الإدارة المقابلة تربط أي مستخدم، وقد يحتاج المدير فعلًا إلى الاطلاع على سجل زميل له. أما القائمة المجاورة لهذا المسار فتقتصر على العملاء. والمعرّف غير الموجود يعطي 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 200 العميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/customers/{user}/instances #

سرد الأجهزة الافتراضية لعميل واحد

admin:read api.read api.privileged

أجهزة العميل الافتراضية كما هي مخزّنة حاليًا، بالتمثيل Instance نفسه الذي يعيده المسار /instances الخاص بالعميل — فالحقل المحجوب عن المالك يبقى محجوبًا عن الموظفين.

وتُخدَم هذه العملية بتحليل خدمة السحابة ذات النطاق العميلي للعميل المستهدف والقراءة منها. وللخدمة نسخة ذات نطاق إداري، والاكتفاء بتجاوز خطّافات مصدر البيانات فيها يحوّل كل تابع موروث يُجري المطابقة عند القراءة إلى تعديل يشمل الأسطول كله — فقراءة صفحة واحدة قد تحذف صفوف عميل آخر. ولا شيء في هذه الواجهة يحلّ تلك النسخة، ويحرص اختبار على مستوى الشيفرة على بقاء الأمر كذلك.

ولذلك لا يوجد هنا معامل refresh، خلافًا لمسار /instances الموجَّه إلى العميل. فالمطابقة تعديل؛ والطرف الثالث الذي يقرأ أجهزة غيره هو آخر مستدعٍ ينبغي أن يُطلقها.

يكتب سجل تدقيق cloud.pii_read ويُحتسب على ميزانية القراءة المميّزة الأضيق.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الأجهزة الافتراضية للعميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/instances' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/customers/{user}/dns-zones #

سرد مناطق DNS لعميل واحد

admin:read api.read api.privileged

مناطق العميل كما هي مخزّنة حاليًا، بالتمثيل DNSZone نفسه الذي يعيده المسار /dns-zones الخاص بالعميل.

وتُخدَم هذه العملية بتحليل خدمة DNS ذات النطاق العميلي صراحةً. ولا يوجد وسيط refresh: فالنسخة التي تُجري المطابقة تحذف المناطق المحلية — وتتسلسل إلى سجلاتها — التي لم تعد قائمة PowerDNS الحيّة تتضمّنها، وذلك قبل الرجوع إلى راية التحديث الخاصة بها؛ وفي النطاق الإداري تفعل ذلك بكل منطقة في التنصيب وتنقل غير المتطابقة منها إلى الموظف المنفِّذ.

يكتب سجل تدقيق dns.pii_read ويُحتسب على ميزانية القراءة المميّزة الأضيق.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من مناطق DNS الخاصة بالعميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/dns-zones' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/customers/{user}/subscriptions #

سرد اشتراكات عميل واحد

admin:read api.read api.privileged

اشتراكات العميل كما هي مخزّنة حاليًا، بالتمثيل Subscription نفسه الذي يعيده المسار /subscriptions الخاص بالعميل. والمبالغ دائمًا أعداد صحيحة بالوحدة الفرعية مع عملتها، لا أعدادًا عشرية أبدًا.

وتُخدَم هذه العملية بتحليل خدمة الفوترة ذات النطاق العميلي صراحةً. ولا يوجد وسيط refresh، وهذه أوضح حالة تبرّر ذلك: فالنسخة التي تُجري المطابقة تُنهي الاشتراكات التي انتقل موردها المرتبط، وترفع كل اشتراك معلّق إلى حالة النشر وتمحو سبب إخفاقه، وتحذف اشتراكات القرص الجذري مع مدفوعاتها، وتُطلق أحداث اليتم التي تتصل بالمزوّد وتنشئ اشتراكات إضافية — كل ذلك داخل معاملة واحدة. وفي النطاق الإداري تكون مجموعة مدخلاتها الجدول كله لا عميلًا واحدًا.

يكتب سجل تدقيق billing.pii_read ويُحتسب على ميزانية القراءة المميّزة الأضيق.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من اشتراكات العميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/subscriptions' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/instances/{instance}/actions/start #

تشغيل جهاز افتراضي لعميل

admin:write api.read api.privileged

متكافئة التكرار (idempotent): تشغيل جهاز يعمل أصلًا يعيد 200 فورًا دون الاتصال بـ CloudStack، تمامًا كما يفعل المسار /instances/{instance}/actions/start الخاص بالمالك نفسه.

وتُخدَم هذه العملية بتحليل خدمة السحابة ذات النطاق العميلي للعميل المستهدف، لا النسخة ذات النطاق الإداري أبدًا — راجع ملاحظة «الخدمة ذات النطاق العميلي» على GET /admin/customers/{user}/instances لمعرفة سبب أهمية هذا التمييز هنا أيضًا.

والبرمجية الوسيطة audit.access:cloud على هذا المسار خاملة (فهي لا تسجّل إلا طلب GET ناجحًا)؛ أما سجل تصرُّف المدير على جهاز عميل فيكتبه المتحكّم صراحةً، سواء جرى الاتصال بـ CloudStack فعلًا بسبب فحص التكرار أعلاه أم لم يجرِ.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer

الاستجابات

  • 200 الجهاز الافتراضي للعميل بعد تشغيله (أو وهو يعمل أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/instances/1/actions/start' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/instances/{instance}/actions/stop #

طلب إيقاف جهاز افتراضي لعميل

admin:write api.read api.privileged

يُدرج إيقاف الجهاز في قائمة الانتظار ويجيب بـ 202. وعند الموافقة تُقرأ السحابة أولًا، ولا يُعاد إيقاف جهاز تُبلغ السحابة بأنه متوقف أصلًا؛ ويظل الجهاز يعمل حتى ذلك الحين. ويُرفض بـ 422 لجهاز مسحوب، أو جهاز مقفل (غير مدفوع أو معلّق)، أو جهاز بلا حساب دخول مالك، وما دام إجراء تشغيل آخر على الجهاز نفسه ينتظر. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. ويُدرج /mcp/admin الإجراء نفسه في قائمة الانتظار للرمز نفسه (قرار المالك، 2026-09-27: لا يُنفَّذ أي إجراء مدمِّر عبر MCP ما لم يُؤكَّد).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/instances/1/actions/stop' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/instances/{instance}/actions/restart #

طلب إعادة تشغيل جهاز افتراضي لعميل

admin:write api.read api.privileged

يُدرج إعادة تشغيل الجهاز في قائمة الانتظار ويجيب بـ 202. ولا حالة مستهدفة لإعادة التشغيل، لذا تصل كل موافقة إلى السحابة. ويُرفض بـ 422 لجهاز مسحوب، أو جهاز مقفل (غير مدفوع أو معلّق)، أو جهاز بلا حساب دخول مالك، أو جهاز عليه طلب استرداد مفتوح، وما دام إجراء تشغيل آخر على الجهاز نفسه ينتظر. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. ويُدرج /mcp/admin الإجراء نفسه في قائمة الانتظار للرمز نفسه (قرار المالك، 2026-09-27: لا يُنفَّذ أي إجراء مدمِّر عبر MCP ما لم يُؤكَّد).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/instances/1/actions/restart' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/instances/{instance}/actions/attach-iso #

طلب إرفاق صورة ISO بجهاز افتراضي لعميل

admin:write api.read api.privileged

يُدرج إرفاق صورة ISO (iso_id) بمحرك الأقراص الافتراضي للجهاز في قائمة الانتظار ويجيب بـ 202؛ وقد يقلع الجهاز منها عند إعادة تشغيله التالية. ويجب أن يشير iso_id إلى صورة ISO مرئية للعميل المستهدف — عامة أو مملوكة لحسابه — لا لحساب المدير المنفِّذ أبدًا؛ وأي شيء آخر يعطي 422 قبل إدراج أي شيء. ويُرفض بـ 422 ما دامت صورة ISO أخرى مرفقة، ولجهاز مسحوب أو مقفل. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. ويُدرج /mcp/admin الإجراء نفسه في قائمة الانتظار للرمز نفسه (قرار المالك، 2026-09-27: لا يُنفَّذ أي إجراء مدمِّر عبر MCP ما لم يُؤكَّد).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
iso_id مطلوب integer يجب أن يشير إلى صورة ISO مرئية للعميل (عامة أو مملوكة لحسابه). أما المعرّف الخاص العائد لغيره أو المعرّف غير الموجود فيفشل في التحقق (422) لا بالرمز 404 — فالمورد المُخاطَب هو الجهاز الافتراضي لا صورة ISO.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/instances/1/actions/attach-iso' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "iso_id": 5
}'
POST /admin/customers/{user}/instances/{instance}/actions/detach-iso #

طلب إخراج صورة ISO من جهاز افتراضي لعميل

admin:write api.read api.privileged

يُدرج فصل صورة ISO الموجودة في محرك الأقراص الافتراضي للجهاز في قائمة الانتظار ويجيب بـ 202. ويُرفض بـ 422 حين لا تكون هناك صورة ISO مرفقة، ولجهاز مسحوب أو مقفل. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. ويُدرج /mcp/admin الإجراء نفسه في قائمة الانتظار للرمز نفسه (قرار المالك، 2026-09-27: لا يُنفَّذ أي إجراء مدمِّر عبر MCP ما لم يُؤكَّد).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/instances/1/actions/detach-iso' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/customers/{user}/snapshots #

سرد لقطات أقراص عميل واحد

admin:read api.read api.privileged

لقطات أقراص العميل كما هي مخزّنة، دون إعادة قراءتها من السحابة، ولكلٍّ منها retained — وقيمتها true لنسخة في قائمة الاحتفاظ، تُعالَج في صفحة الاحتفاظ ولا يمكن حذفها أو استعادتها هنا. صفِّ النتائج بـ volume_id. يكتب سجل تدقيق cloud.pii_read.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 200 لقطات العميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/customers/{user}/firewall-rules #

قراءة جدار الحماية لعميل واحد

admin:read api.read api.privileged

إعادات توجيه المنافذ لدى العميل (ingress_rules) وقواعده الصادرة (egress_rules) كما هي مخزّنة، ولكلٍّ منها الشبكة التي يقع عليها. يكتب سجل تدقيق cloud.pii_read.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 200 جدار الحماية لدى العميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/firewall-rules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/customers/{user}/isos #

سرد ملفات ISO التي يمكن لعميل واحد إرفاقها

admin:read api.read api.privileged

ملفات ISO الخاصة بالعميل مع الفهرس العام، ولكلٍّ منها own. يكتب سجل تدقيق cloud.pii_read.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 200 ملفات ISO.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/isos' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/isos/uploads #

بدء رفع ISO على أجزاء لعميل واحد

admin:write api.read api.privileged

يفتح رفعًا حجمه size بايت (4 GiB على الأكثر) تقع صورته في حساب العميل، قابلةً للإرفاق بأجهزته — نظير REST لرفع ISO لكل عميل في منطقة الإدارة. ويُنفَّذ فورًا دون انتظار موافقة. أرسل الأجزاء عبر POST /admin/customers/{user}/isos/uploads/{upload}/chunks ثم …/complete. وتُحسب عمليات الرفع الثلاث المفتوحة المسموح بها على حساب العميل؛ والرابعة تُرجِع 422.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
description مطلوب string
bootable مطلوب boolean
filename مطلوب string
size مطلوب integer

الاستجابات

  • 201 عملية الرفع المفتوحة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/isos/uploads' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "bootable": true,
    "filename": "string",
    "size": 1
}'
GET /admin/customers/{user}/isos/uploads/{upload} #

قراءة عملية رفع مفتوحة لعميل واحد

admin:read api.read api.privileged

عملية الرفع وأرقام الأجزاء المستلمة، فيرسل العميل الذي فقد موضعه ما ينقص فقط. وعملية الرفع التي لا تخص هذا العميل تُرجِع 404. يكتب سجل تدقيق cloud.pii_read.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
upload مطلوب path string

الاستجابات

  • 200 عملية الرفع المفتوحة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/isos/uploads/upload' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/isos/uploads/{upload}/chunks #

إرسال جزء من عملية رفع لعميل واحد

admin:write api.read api.privileged

جزء واحد بصيغة multipart/form-data: index (يبدأ من 0) وfile. ويجب أن يكون كل جزء عدا الأخير chunk_size بايت تمامًا؛ والجزء ذو الحجم الخاطئ، أو الرقم خارج عملية الرفع، يُرجِع 422. وإرسال الجزء مرة أخرى يستبدله. وعملية الرفع التي لا تخص هذا العميل تُرجِع 404.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
upload مطلوب path string

الاستجابات

  • 200 عملية الرفع وقد استُلم هذا الجزء.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/isos/uploads/upload/chunks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/isos/uploads/{upload}/complete #

إكمال عملية رفع لعميل واحد وتسجيل ISO

admin:write api.read api.privileged

يجمع الأجزاء ويسجّل الصورة في حساب العميل. 201 مع ISO؛ و202 حين تستلم السحابة الصورة ولم تُدرجها بعد — فتظهر في GET /admin/customers/{user}/isos حين تفعل. والجزء الناقص يُرجِع 422. وتزول عملية الرفع بعد ذلك في الحالتين. يكتب سجل تدقيق cloud.iso_uploaded.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
upload مطلوب path string

الاستجابات

  • 201 ISO المسجَّلة.
  • 202 سُجِّلت، ولم تُدرجها السحابة بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/isos/uploads/upload/complete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/isos/uploads/{upload}/abort #

إلغاء عملية رفع لعميل واحد

admin:write api.read api.privileged

يتخلى عن عملية الرفع ويحذف أجزاءها فورًا. وهو POST ككل كتابة للموظفين. وعملية الرفع التي لا تخص هذا العميل تُرجِع 404.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
upload مطلوب path string

الاستجابات

  • 204 أُلغيت.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/isos/uploads/upload/abort' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/instances/{instance}/rename #

إعادة تسمية جهاز عميل

admin:write api.read api.privileged

يغيّر اسم العرض للجهاز فورًا عبر خدمة السحابة ذات النطاق العميلي، ويكتب cloud.instance_renamed باسم العميل. للتراجع أعد الاسم القديم. ويُرفض بـ 409 لجهاز مسحوب أو مقفل.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string

الاستجابات

  • 200 الجهاز بعد إعادة تسميته.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/instances/1/rename' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /admin/customers/{user}/volumes/{volume}/snapshots #

أخذ لقطة لقرص عميل

admin:write api.read api.privileged

يأخذ لقطة يدوية فورًا عبر خدمة السحابة ذات النطاق العميلي، ويكتب cloud.snapshot_created باسم العميل. وتُحتسب من حدّ اللقطات لدى العميل، وتُرفض بـ 409 عند بلوغه، وأثناء تغيير حجم القرص أو جهازه، ولقرص مسحوب.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
volume مطلوب path integer min 1 معرّف القرص؛ ويجب أن يعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
name اختياري string

الاستجابات

  • 201 اللقطة قيد الأخذ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/volumes/1/snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /admin/customers/{user}/volumes/{volume}/attach #

طلب إرفاق قرص بجهاز

admin:write api.read api.privileged

يُدرج إرفاق القرص بأحد أجهزة العميل نفسه (instance_id) في قائمة الانتظار ويجيب بـ 202. ويُرفض بـ 422 لقرص مرفق أصلًا، أو قرص أو جهاز مسحوب، أو جهاز مقفل، أو جهاز لحساب آخر. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
volume مطلوب path integer min 1 معرّف القرص؛ ويجب أن يعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
instance_id مطلوب integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/volumes/1/attach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "instance_id": 1
}'
POST /admin/customers/{user}/volumes/{volume}/detach #

طلب فصل قرص

admin:write api.read api.privileged

يُدرج فصل قرص البيانات عن جهازه في قائمة الانتظار ويجيب بـ 202. وعند الموافقة تُقرأ حالة الجهاز من السحابة، ويُرفض الجهاز غير المتوقف. ولا يُفصل قرص الإقلاع أبدًا. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
volume مطلوب path integer min 1 معرّف القرص؛ ويجب أن يعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/volumes/1/detach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/snapshots/{snapshot}/delete #

طلب حذف لقطة

admin:write api.read api.privileged

يُدرج حذف اللقطة في قائمة الانتظار ويجيب بـ 202. وعند الموافقة تُتلف النسخة الاحتياطية نهائيًا. ويُرفض بـ 422 لنسخة في قائمة الاحتفاظ ولنسخة ما زالت قيد الأخذ. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
snapshot مطلوب path integer min 1 معرّف اللقطة؛ ويجب أن تعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/snapshots/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/snapshots/{snapshot}/restore #

طلب استعادة لقطة إلى قرص جديد

admin:write api.read api.privileged

يُدرج استعادة اللقطة إلى قرص جديد باسم name — لا في مكانه أبدًا — في قائمة الانتظار ويجيب بـ 202. ويستهلك إحدى مرات الاستعادة المحدودة للّقطة وخانة من حدّ الأقراص لدى العميل. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
snapshot مطلوب path integer min 1 معرّف اللقطة؛ ويجب أن تعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/snapshots/1/restore' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /admin/customers/{user}/ingress-rules #

طلب فتح منفذ على جهاز

admin:write api.read api.privileged

يُدرج إعادة توجيه منفذ من أحد العناوين العامة للعميل إلى أحد أجهزته في قائمة الانتظار ويجيب بـ 202. وقيمة protocol هي tcp أو udp أو icmp، والمنافذ من 1 إلى 65535. ويصبح كل ما يستمع هناك قابلًا للوصول من الإنترنت. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
instance_id مطلوب integer
public_ip_address مطلوب string
protocol مطلوب string
public_port_start مطلوب integer
public_port_end مطلوب integer
private_port_start مطلوب integer
private_port_end مطلوب integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/ingress-rules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "instance_id": 1,
    "public_ip_address": "string",
    "protocol": "string",
    "public_port_start": 1,
    "public_port_end": 1,
    "private_port_start": 1,
    "private_port_end": 1
}'
POST /admin/customers/{user}/ingress-rules/{ingressRule} #

طلب تغيير إعادة توجيه منفذ

admin:write api.read api.privileged

يُدرج تغيير المنافذ الخاصة لإعادة التوجيه، واختياريًا الجهاز الذي توجّه إليه (instance_id، أحد أجهزة العميل نفسه)، في قائمة الانتظار ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
ingressRule مطلوب path integer min 1 معرّف إعادة توجيه المنفذ؛ ويجب أن يعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
private_port_start مطلوب integer
private_port_end مطلوب integer
instance_id اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/ingress-rules/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "private_port_start": 1,
    "private_port_end": 1
}'
POST /admin/customers/{user}/ingress-rules/{ingressRule}/delete #

طلب إغلاق إعادة توجيه منفذ

admin:write api.read api.privileged

يُدرج إغلاق إعادة توجيه المنفذ في قائمة الانتظار ويجيب بـ 202. وعند الموافقة يتوقف الوصول إلى كل ما يقدّمه العميل عبرها. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
ingressRule مطلوب path integer min 1 معرّف إعادة توجيه المنفذ؛ ويجب أن يعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/ingress-rules/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/egress-rules #

طلب قاعدة صادرة لجدار الحماية

admin:write api.read api.privileged

يُدرج قاعدة صادرة على شبكة العميل (network_id، أو الشبكة الافتراضية) في قائمة الانتظار ويجيب بـ 202. وقيمة protocol هي tcp أو udp أو icmp. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
source_cidr مطلوب string
destination_cidr مطلوب string
protocol مطلوب string
port_start مطلوب integer
port_end مطلوب integer
network_id اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/egress-rules' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_cidr": "string",
    "destination_cidr": "string",
    "protocol": "string",
    "port_start": 1,
    "port_end": 1
}'
POST /admin/customers/{user}/egress-rules/{egressRule}/delete #

طلب إزالة قاعدة صادرة

admin:write api.read api.privileged

يُدرج إزالة القاعدة الصادرة في قائمة الانتظار ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
egressRule مطلوب path integer min 1 معرّف القاعدة الصادرة؛ ويجب أن تعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/egress-rules/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/retention/purge #

طلب محو كل ما هو محتجز للعميل

admin:write api.read api.privileged

يُدرج المحو الدائم لكل مورد محتجز لحساب العميل، بترتيب الاعتماد، في قائمة الانتظار ويجيب بـ 202. ويُرفض بـ 422 ما دام أيٌّ منها موقوفًا، ويُرفض عند الموافقة إن تغيّرت المجموعة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/retention/purge' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/dns-zones/{zone}/records #

طلب إضافة سجل DNS

admin:write api.read api.privileged

يُدرج إضافة قيمة واحدة عند name وtype إلى المنطقة في قائمة الانتظار ويجيب بـ 202. وتُحفظ القيم الأخرى عند الاسم والنوع نفسيهما، وتُرفض قيمة موجودة أصلًا. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
zone مطلوب path integer min 1 معرّف منطقة DNS؛ ويجب أن تعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
type مطلوب string
data مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/dns-zones/1/records' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "type": "string",
    "data": "string"
}'
POST /admin/customers/{user}/dns-records/{record} #

طلب تغيير قيمة سجل DNS

admin:write api.read api.privileged

يُدرج تغيير قيمة واحدة من السجل (type وdata) في قائمة الانتظار ويجيب بـ 202. وتُحفظ كل قيمة أخرى عند الاسم والنوع نفسيهما. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
record مطلوب path integer min 1 معرّف سجل DNS؛ ويجب أن يعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
type مطلوب string
data مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/dns-records/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "string",
    "data": "string"
}'
POST /admin/customers/{user}/dns-records/{record}/delete #

طلب حذف قيمة سجل DNS

admin:write api.read api.privileged

يُدرج حذف قيمة واحدة من السجل في قائمة الانتظار ويجيب بـ 202. وتُحفظ كل قيمة أخرى عند الاسم والنوع نفسيهما. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
record مطلوب path integer min 1 معرّف سجل DNS؛ ويجب أن يعود إلى العميل المعني.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/dns-records/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/public-ip-addresses/{address}/reverse-dns #

طلب ضبط اسم DNS العكسي لعنوان

admin:write api.read api.privileged

يُدرج ضبط اسم DNS العكسي للعنوان (PTR) على reverse_record في قائمة الانتظار ويجيب بـ 202. ويُرفض عند الموافقة ما لم تكن السحابة لا تزال تُدرج العنوان في حساب العميل. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
address مطلوب path integer min 1 معرّف العنوان العام؛ ويجب أن يعود إلى العميل المعني.

جسم الطلب مطلوب

الحقل النوع الوصف
reverse_record مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/public-ip-addresses/1/reverse-dns' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reverse_record": "string"
}'
GET /admin/cloud-scans #

سرد عمليات فحص السحابة

admin:read api.read

عمليات فحص السحابة، الأحدث أولًا، مع أعدادها والمدير الذي بدأ كلًّا منها (limit، 50 على الأكثر). ولا يُذكر أي عميل، لذا لا يُكتب سجل وصول.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 عمليات الفحص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/cloud-scans' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/cloud-scans #

طلب فحص السحابة

admin:write api.read api.privileged

يُدرج فحصًا للسحابة في قائمة الانتظار ويجيب بـ 202. فالفحص يعيد قراءة السحابة كلها ويطابق الفهرس معها — وتُشذَّب مدخلات الفهرس التي لم تعد السحابة تُدرجها — لذا ينتظر مديرًا. ويُرفض ما دام فحص آخر جاريًا. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/cloud-scans' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/screenshots #

سرد لقطات شاشة القوالب

admin:read api.read

لقطات الشاشة في معارض صفحات المنتجات العامة (يُصفّى بـ template_id). محتوى تحريري: لا يُكتب سجل وصول.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 لقطات الشاشة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/screenshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/retention/{retainedResource}/reinstate #

طلب إعادة مورد محتجز

admin:write api.read api.privileged

يُدرج إعادة المورد إلى عميله في قائمة الانتظار ويجيب بـ 202. ويُرفض بـ 422 ما لم يكن السجل لا يزال معلّقًا وكانت المسألة المالية خلفه محسومة. وnote اختيارية. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
retainedResource مطلوب path integer min 1 معرّف سجل قائمة الاحتفاظ.

جسم الطلب مطلوب

الحقل النوع الوصف
note اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/retention/1/reinstate' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "note": "string"
}'
POST /admin/retention/networks/{network}/purge #

طلب إزالة شبكة أُفرغت

admin:write api.read api.privileged

يُدرج إزالة الشبكة وإعادة عناوينها في قائمة الانتظار ويجيب بـ 202. ولا يمكن التراجع بعد الموافقة. ويُرفض بـ 422 ما دامت مدفوعة أو تضمّ جهازًا أو عنوانًا مفوترًا. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
network مطلوب path integer min 1 معرّف الشبكة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/retention/networks/1/purge' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/screenshots/{screenshot}/publish #

طلب نشر لقطة شاشة أو إخفائها

admin:write api.read api.privileged

يُدرج إظهار لقطة الشاشة (published: true) أو إخفاءها في صفحة المنتج العامة في قائمة الانتظار ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
screenshot مطلوب path integer min 1 معرّف لقطة الشاشة.

جسم الطلب مطلوب

الحقل النوع الوصف
published مطلوب boolean

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/screenshots/1/publish' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "published": true
}'
POST /admin/screenshots/{screenshot} #

طلب تعديل لقطة شاشة

admin:write api.read api.privileged

يُدرج تعديل title وdescription وlanguage (tr-TR أو en-US أو ar-SA) وorder للقطة الشاشة في قائمة الانتظار ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
screenshot مطلوب path integer min 1 معرّف لقطة الشاشة.

جسم الطلب مطلوب

الحقل النوع الوصف
title مطلوب string
description مطلوب string
language مطلوب string
order اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/screenshots/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "string",
    "description": "string",
    "language": "string"
}'
POST /admin/screenshots/{screenshot}/delete #

طلب حذف لقطة شاشة

admin:write api.read api.privileged

يُدرج حذف لقطة الشاشة وملف صورتها في قائمة الانتظار ويجيب بـ 202. ولا يمكن التراجع بعد الموافقة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُعاد التحقق عند الموافقة من كل ما يعتمد عليه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
screenshot مطلوب path integer min 1 معرّف لقطة الشاشة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/screenshots/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/profile #

طلب تعديل الملف الشخصي لعميل

admin:write api.read api.privileged

يُدرج تعديل الملف الشخصي لحساب دخول عميل في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. أرسل الحقول التي تتغيّر فقط؛ ويحتفظ الحقل الغائب بقيمته، ويجب أن يظل الملف الشخصي بعد الدمج مستوفيًا لقواعد النموذج في منطقة الإدارة. لا تُعدَّل الوسوم هنا. ويُرفض بـ 422 لحساب دخول موظف أو لملف غير صالح أو لتعديل بانتظار الموافقة بالفعل.

وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
name اختياري string
birthdate اختياري string
identity_number اختياري string
passport_number اختياري string
phone اختياري string
language اختياري string
telegram_user_id اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/profile' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "birthdate": "string",
    "identity_number": "string",
    "passport_number": "string",
    "phone": "string",
    "language": "string",
    "telegram_user_id": "string"
}'
POST /admin/customers/{user}/billing-info #

طلب تعديل بيانات الفوترة لعميل

admin:write api.read api.privileged

يُدرج تعديل بيانات الفوترة لحساب عميل في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url). أرسل الحقول التي تتغيّر فقط؛ ويجب أن يظل السجل بعد الدمج مستوفيًا لقواعد النموذج في منطقة الإدارة، وتبقى فوترة الشريك مؤسسية. ويُرفض عند الموافقة بلد جديد يغيّر عملة الفوترة ما دامت للحساب فواتير مفتوحة.

وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
company_name اختياري string
tax_number اختياري string
tax_office اختياري string
trade_registry_office اختياري string
trade_registry_number اختياري string
address اختياري string
city اختياري string
state اختياري string الولاية أو المقاطعة أو المنطقة — اختيارية. إن غابت بقيت القيمة المحفوظة كما هي، وإن أُرسلت فارغة حُذفت. خارج تركيا يُسجَّل النطاق بالولاية التي تعرفها جهة تسجيل النطاقات لذلك البلد، باسمها أو برمزها.
postal_code اختياري string
country اختياري string
incorporation_country اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/billing-info' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_name": "string",
    "tax_number": "string",
    "tax_office": "string",
    "trade_registry_office": "string",
    "trade_registry_number": "string",
    "address": "string",
    "city": "string",
    "state": "string",
    "postal_code": "string",
    "country": "string",
    "incorporation_country": "string"
}'
POST /admin/customers/{user}/password-reset #

طلب إعادة تعيين كلمة مرور عميل

admin:write api.read api.privileged

يُدرج إعادة تعيين كلمة مرور حساب دخول عميل في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url). وعند الموافقة تُستبدل كلمة المرور بأخرى لا يعرفها أحد، ويُسجَّل خروج العميل من كل مكان ويُرسل إليه رابط إعادة التعيين المعتاد ليختار كلمة جديدة. لا تُقبل أي كلمة مرور ولا تُعاد.

وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/password-reset' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/delete #

طلب حذف حساب دخول عميل

admin:write api.read api.privileged

يُدرج حذف حساب دخول عميل في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يحذف شيئًا: يجب أن يوافق مدير على السجل (approval_url). ويُرفض بـ 422 لحساب دخول موظف، ولمالك حساب تعتمد عليه حسابات دخول أخرى، ولحساب دخول وحيد لا يزال حسابه يحتفظ بأجهزة أو أقراص أو عناوين أو اشتراكات قائمة أو شراكة سارية أو استردادات غير مكتملة؛ وعند الموافقة أيضًا لحساب دخول لا تزال قاعدة البيانات تحتفظ بسجلات له.

وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/notifications #

تشغيل إشعارات عميل أو إيقافها

admin:write api.read api.privileged

يشغّل إشعارات البريد الإلكتروني والهاتف (تيليجرام) لحساب دخول عميل أو يوقفها مباشرةً: إنها تفضيل رسائل، يمكن التراجع عنه بالطلب التالي، ويُسجَّل في سجل التدقيق. أرسل المفتاح الذي تغيّره فقط. لا تتغيّر هنا إعدادات التحقق بخطوتين ولا إلغاء الرموز.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
email اختياري boolean
phone اختياري boolean

الاستجابات

  • 200 حالة المفاتيح الآن.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/notifications' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": true,
    "phone": true
}'
POST /admin/customers/{user}/account/bill-notices #

تعيين ما إذا كان الحساب يُبلَّغ بالفواتير الجديدة

admin:write api.read api.privileged

يعيّن تفضيل إشعار الفواتير للحساب ويجيب بـ 200 مع الحالة الجديدة: inherit يتبع إعداد التثبيت، وon يُبلغ عملاء الحساب بكل فاتورة جديدة، وoff لا يُبلغهم أبدًا. يسري فورًا ويُسجَّل التغيير في سجل التدقيق. ولا يتأثر زر إبلاغ العميل الخاص بالموظفين.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
notify_pending_payments مطلوب string

الاستجابات

  • 200 حالة إشعار الفواتير للحساب بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/bill-notices' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "notify_pending_payments": "inherit"
}'
POST /admin/customers/{user}/account/pay-day #

تعيين اليوم الذي تتجدد فيه اشتراكات الحساب

admin:write api.read api.privileged

يعيّن يوم الشهر (1–28) الذي تتجدد فيه كل اشتراكات الحساب ويجيب بـ 200 معه؛ وnull يعيد كل اشتراك إلى تاريخ ذكراه السنوية. وتُفوتر الفترة حتى اليوم الجديد بالتناسب عند التجديد التالي لكل اشتراك؛ وتحتفظ الاشتراكات السنوية بشهرها. ولا تتغير أي فاتورة مفتوحة. يسري فورًا ويُسجَّل التغيير في سجل التدقيق.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
day مطلوب integer

الاستجابات

  • 200 يوم الدفع للحساب بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/pay-day' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "day": 1
}'
POST /admin/customers/{user}/account/default-interest #

طلب تشغيل فائدة التأخير لحساب أو إيقافها

admin:write api.read api.privileged

يُدرج تفضيل فائدة التأخير للحساب في قائمة انتظار الموافقات ويجيب بـ 202: inherit يتبع مفتاح التثبيت (billing_default_interest_enabled في GET /admin/settings)، وon يحتسب فائدة التأخير على فواتير الحساب المتأخرة أيًا كان ذلك المفتاح، وoff لا يحتسب أي فائدة ولا يعرض فائدة متراكمة. ويُرفض بـ 422 إذا كان الحساب على ذلك الإعداد أصلًا أو ما دام تغيير آخر مماثل عليه ينتظر، أو من دون سبب (reason). هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
default_interest_enabled مطلوب string
reason مطلوب string سبب تغيير الإعداد؛ يُسجَّل مع التغيير. تشغيل الفائدة ليس بأثر رجعي — فهي تتراكم فقط من لحظة تشغيلها.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/default-interest' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "default_interest_enabled": "inherit",
    "reason": "string"
}'
POST /admin/customers/{user}/account/block #

طلب حظر الاسترداد أو الشراء على حساب

admin:write api.read api.privileged

يُدرج تشغيل أحد مفتاحَي الموظفين في الحساب أو إيقافه في قائمة انتظار الموافقات ويجيب بـ 202. switch: refunds يوقف طلبات الاسترداد التي يقدّمها العميل بنفسه (تظل استردادات الموظفين ممكنة؛ ولا تتغير مهلة الأيام السبعة)؛ وswitch: shop يعطّل الشراء بينما يستمر كل ما يملكه العميل في العمل. ويلزم reason للحظر؛ يقرؤه الموظفون ولا يقرؤه العميل أبدًا. ويُرفض بـ 422 إذا كان المفتاح في ذلك الوضع أصلًا، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لحساب يضم تسجيل دخول لمشرف أعلى. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
switch مطلوب string
blocked مطلوب boolean
reason اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/block' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "switch": "refunds",
    "blocked": true
}'
POST /admin/customers/{user}/account/partner-bank-details #

طلب تسجيل البيانات المصرفية لشريك

admin:write api.read api.privileged

يُدرج تسجيل (أو استبدال) الحساب المصرفي الذي تُحوَّل إليه مستحقات الشريك في قائمة انتظار الموافقات ويجيب بـ 202. يكفي للشريك الذي يُفوتَر في تركيا account_holder وIBAN تركي؛ أما الشريك الأجنبي فيحتاج أيضًا إلى swift وbank_name. ولا تعرض المعاينة والنتيجة إلا آخر أربعة أحرف من IBAN. ويُرفض بـ 422 إذا كانت هذه هي البيانات المسجلة بالفعل. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
account_holder مطلوب string
iban مطلوب string
swift اختياري string
bank_name اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/partner-bank-details' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_holder": "string",
    "iban": "string"
}'
POST /admin/customers/{user}/account/partnership-end #

طلب إنهاء شراكة شريك

admin:write api.read api.privileged

يُدرج إنهاء شراكة الحساب في قائمة انتظار الموافقات ويجيب بـ 202. mode: now ينهيها فورًا (ground: breach_immediate أو inactivity أو insolvency أو partner_terminated)؛ وmode: schedule ينهيها في بداية يوم date (ground: convenience — بعد 30 يومًا على الأقل — أو inactivity أو insolvency)؛ وmode: cure يرسل إشعار مخالفة يقرؤه الشريك (breach_description) وينهي الشراكة بعد 30 يومًا ما لم يُعلِّم الموظفون المخالفة بأنها عولجت. ويلزم reason لـ now وschedule؛ يقرؤه الموظفون ولا يقرؤه الشريك أبدًا. ويُرفض بـ 422 لحساب ليس شريكًا، أو لسبب inactivity لشريك لم يُقَس عدم نشاطه، أو لإنهاء عادي ثانٍ، أو لإشعار مخالفة مفتوح ثانٍ. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
mode مطلوب string
ground اختياري string
date اختياري string
reason اختياري string
breach_description اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/partnership-end' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "now"
}'
POST /admin/customers/{user}/account/partnership-end/{notice}/outcome #

طلب البت في إشعار إنهاء شراكة مفتوح

admin:write api.read api.privileged

يُدرج قرارًا بشأن إشعار إنهاء مفتوح للحساب في قائمة انتظار الموافقات ويجيب بـ 202. decision: withdraw يتراجع عن إنهاء جدوله الموظفون (لا إشعار مخالفة أبدًا، ولا الإشعار الذي قدّمه الشريك نفسه)؛ وremedied يعلّم إشعار مخالفة بأنه عولج؛ وescalate ينهي الشراكة فورًا بسبب المخالفة (ويلزم reason)؛ وopen_code وclose_code يغيّران مفتاح إشعار المخالفة الذي يسمح لرمز الشريك بمواصلة ربط عملاء جدد ما دام الإشعار قائمًا. أما إشعار الشريك نفسه فلا يُسحب إلا باتفاق الطرفين: يطلب الشريك ذلك من صفحة الشريك، فيوافق accept_withdrawal على الطلب (فيُسحب الإشعار)، بينما يترك decline_withdrawal الإشعار ينقضي في موعده (وreason اختياري ولا يُعرض على الشريك أبدًا؛ ويمكن للشريك أن يطلب من جديد). ويُرفض كلاهما بـ 422 ما لم يكن طلب الشريك قائمًا، أو بعد حلول تاريخ الإشعار؛ والرد الذي تتم الموافقة عليه بعد تغيّر طلب الشريك (رُفض ثم طُلب مجددًا) يفشل بدلًا من الرد على الطلب الجديد. ويُبلَّغ الشريك بتحريك مفتاح الرمز (بالبريد الإلكتروني وفي صفحة الشريك الخاصة به)، دون ذكر السبب أبدًا. ويُرفض بـ 422 لإشعار غير مفتوح في هذا الحساب. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
notice مطلوب path integer min 1 معرّف إشعار الإنهاء المفتوح في هذا الحساب.

جسم الطلب مطلوب

الحقل النوع الوصف
decision مطلوب string
reason اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/partnership-end/1/outcome' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "decision": "withdraw"
}'
POST /admin/customers/{user}/account/members/invite #

طلب دعوة عنوان إلى الحساب

admin:write api.read api.privileged

يُدرج دعوة email للانضمام إلى حساب {user} بالإعداد preset في قائمة انتظار الموافقات ويجيب بـ 202. وعند الموافقة تُرسل الدعوة بالبريد باسم مالك الحساب؛ ولا يتغير شيء حتى يقبلها الشخص، ولا يُنشأ له أي تسجيل دخول. ويُرفض بـ 422 لحساب بلا مالك، أو إعداد غير معروف، أو عنوان لديه دعوة من قبل، أو عنوان ينتظر الموافقة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
email مطلوب string
preset مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/members/invite' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "string",
    "preset": "owner"
}'
POST /admin/customers/{user}/account/members/{member}/capabilities #

طلب استبدال صلاحيات عضو

admin:write api.read api.privileged

يُدرج استبدال مصفوفة صلاحيات {member} في قائمة انتظار الموافقات ويجيب بـ 202. وcapabilities تربط كل مجال (cloud وbilling وdns وtickets وshop وaccount وmembers وai) بـ none أو view أو manage؛ والمجال المحذوف يصبح none. ويُرفض بـ 422 لمالك الحساب، أو مجال أو مستوى غير معروف، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لتسجيل دخول مشرف أعلى. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
member مطلوب path integer تسجيل دخول في حساب `{user}`؛ وأي معرّف آخر يُجاب بـ `404`.

جسم الطلب مطلوب

الحقل النوع الوصف
capabilities مطلوب object

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/members/1/capabilities' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "capabilities": []
}'
POST /admin/customers/{user}/account/members/{member}/remove #

طلب إزالة تسجيل دخول عضو

admin:write api.read api.privileged

يُدرج إزالة {member} من الحساب في قائمة انتظار الموافقات ويجيب بـ 202. ويُحذف تسجيل الدخول؛ ويحتفظ الحساب بكل ما يملكه. ويُرفض بـ 422 لمالك الحساب، ولتسجيل الدخول الوحيد على الحساب، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لتسجيل دخول مشرف أعلى. ولا يمكن إزالة تسجيل دخول ما زالت التذاكر أو الطلبات أو الفواتير تشير إليه: فتفشل الموافقة حينها. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
member مطلوب path integer تسجيل دخول في حساب `{user}`؛ وأي معرّف آخر يُجاب بـ `404`.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/members/1/remove' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/account/merge #

طلب دمج حساب آخر في هذا الحساب

admin:write api.read api.privileged

يُدرج دمج الحساب source_account_id في حساب {user} في قائمة انتظار الموافقات ويجيب بـ 202: ينتقل كل تسجيل دخول في المصدر إلى هنا بالإعداد preset، وينتقل رصيد المصدر معهم، ويُغلق المصدر. ولا يمكن التراجع عن ذلك. ويُرفض بـ 422 ما لم يكن المصدر قابلًا للدمج كما يقول مربع الدمج في منطقة الإدارة (لا عائق — خوادم أو أقراص أو عناوين أو مناطق أو اشتراكات مفتوحة أو استردادات غير منتهية أو تسجيلات دخول لموظفين أو شراكة سارية — ولا أحد الحسابين مغلق، وليسا الحساب نفسه). وتحل الموافقة محل التأكيد المكتوب يدويًا في منطقة الإدارة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
source_account_id مطلوب integer
preset مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/merge' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_account_id": 1,
    "preset": "owner"
}'
GET /admin/customers/{user}/account #

قراءة حالة ضوابط حساب

admin:read api.read api.privileged

حساب {user}: حصصه الست، وcontrols — حدود بوابة الذكاء الاصطناعي (تُعرض الميزانية ولا تُضبط هنا أبدًا)، وحظر الاسترداد وحظر المتجر، وإعداد إشعارات الفواتير، وشروط الشراكة والوكالة المديرة، وبيانات حساب الشريك المصرفي مع إخفاء IBAN عدا أحرفه الأربعة الأخيرة، وإشعارات إنهاء الشراكة التي لا تزال مفتوحة، وصلاحيات كل عضو، والدعوات المعلّقة. وهو تقرير الحالة المخزّنة نفسه الذي يطبعه get_account في MCP الإدارة؛ ولا يُسأل شيء من البوابة أو السحابة.

يكتب سجل تدقيق account.pii_read ويُحتسب على ميزانية القراءة المميّزة الأضيق. يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 200 ضوابط الحساب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/account/quotas #

طلب حصص جديدة لحساب

admin:write api.read api.privileged

يُدرج حصصًا جديدة للحساب — الأجهزة والأقراص واللقطات اليدوية ومفاتيح بوابة الذكاء الاصطناعي والعناوين العامة والشبكات (وتُحسب الشبكة المجانية التي يملكها كل حساب) — في قائمة انتظار الموافقات ويجيب بـ 202. اذكر الحصص التي تتغير فقط؛ وتحتفظ البقية بقيمها الحالية. والحدود هي حدود صفحة الحساب نفسها. ولا تزيل الحصة الأدنى شيئًا يملكه الحساب؛ بل توقف الطلبات الجديدة. ويُرفض بـ 422 إذا لم يكن ثمة ما يتغير أو كان الإجراء نفسه بانتظار الموافقة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
max_vms اختياري integer
max_vols اختياري integer
max_snapshots اختياري integer
ai_max_keys اختياري integer
max_ips اختياري integer
max_networks اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/quotas' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "max_vms": 1,
    "max_vols": 1,
    "max_snapshots": 1,
    "ai_max_keys": 1,
    "max_ips": 1,
    "max_networks": 1
}'
POST /admin/customers/{user}/account/ai-limits #

طلب حدود جديدة لبوابة الذكاء الاصطناعي لحساب

admin:write api.read api.privileged

يُدرج قائمة النماذج المسموح بها وحدود المعدل لبوابة الذكاء الاصطناعي في الحساب في قائمة انتظار الموافقات ويجيب بـ 202. وتعني allowed_models الفارغة أو null كل نموذج قابل للبيع؛ ويُرفض النموذج الذي لا تستطيع البوابة تسعيره. ولا تتغير الميزانية هنا أبدًا — فهي منحة تُضبط من صفحة الحساب — ويُرفض بـ 422 الحساب الذي لم يستخدم البوابة قط. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
allowed_models اختياري array of string
rpm_limit اختياري integer
tpm_limit اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/ai-limits' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_models": [
        "string"
    ],
    "rpm_limit": 1,
    "tpm_limit": 1
}'
POST /admin/customers/{user}/account/partner #

طلب شروط شراكة جديدة لحساب

admin:write api.read api.privileged

يُدرج حفظ بطاقة الشريك للحساب — مستوى الموزّع وخصمه، وتاريخ البدء، وحصة الوكالة ومستواها، والوكالة المديرة — في قائمة انتظار الموافقات ويجيب بـ 202. والنسب كسور بنسب مئوية صحيحة. وعند الموافقة يُنفَّذ حفظ البطاقة نفسه: يعيد الخصم تسعير الفواتير المفتوحة للحساب ويُبلَّغ الشريك. وتصفير النسبتين في شراكة سارية لا ينهيها ويُرفض بـ 422؛ وإنهاء الشراكة يكون عبر POST /admin/customers/{user}/account/partnership-end. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{user} أي تسجيل دخول لعميل في الحساب؛ وتسجيل دخول موظف يُجاب بـ 403، وتسجيل دخول بلا حساب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
partner_tier اختياري string
partner_discount اختياري number
partner_since اختياري string
rebate_rate اختياري number
rebate_tier اختياري string
partner_account_id اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/account/partner' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "partner_tier": "string",
    "partner_discount": 1,
    "partner_since": "string",
    "rebate_rate": 1,
    "rebate_tier": "string",
    "partner_account_id": 1
}'
GET /admin/ai/prompts #

قراءة موجّهات النظام لكِلا المساعدَين

admin:read api.read

المساعدان اللذان يشغّلهما C2 — المساعد الذي يحادثه عميل مسجَّل الدخول، وفقاعة الدردشة على الموقع التسويقي العام — ولكلٍّ منهما الموجّه المدمج الثابت مضافًا إليه إرشادات المشغّل نفسه.

يتطلّب رمزًا مميزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

core للقراءة فقط، في كل واجهة. فهو موجود في شيفرة التطبيق لا في قاعدة البيانات، ولا توجد نقطة نهاية أو نموذج أو أداة تعدّله. وهو يحمل القواعد التي تجعل تشغيل المساعدَين آمنًا: اقرأ كل معلومة من أداة، ولا تخمّن حالة جهاز افتراضي أو سعرًا أو رصيدًا، وتوقّف لانتظار موافقة العميل الصريحة قبل تشغيل جهاز أو إيقافه، ولا تُجرِ أي عملية حسابية على المال. يستطيع المساعد بعد تسجيل الدخول إنفاق مال العميل، ولذلك فإن تلك القواعد هي سبب السماح له بذلك.

guidance هو الجزء الذي يكتبه المشغّل، ويُضاف أسفل core ولا يحلّ محلّه أبدًا. ويُقدَّم داخل الموجّه بوصفه سياسة مشغّل إضافية للقواعد التي فوقه، لا يمكنها تخفيفها أو مناقضتها أو تجاوزها. وتعني القيمة null أنه لم يُضبط شيء؛ والتنصيب الذي تكون فيه القيمة null في كلتا الواجهتين يرسل الموجّه المرفق مع المنتج حرفيًا، بايتًا ببايت.

وإعادته إلى جانب core أمر مقصود: فالمستدعي الذي يطوّر النص المُضاف إنما يعمل في مواجهة العقد الذي فوقه، ولا ينبغي أن يضطر إلى جلب مستند ثانٍ — أو إلى التخمين — ليرى ما الذي يضيف إليه.

وmax_guidance هو الحد الأقصى لعدد المحارف المسموح به لحقل guidance في كل واجهة، ويُطبَّق بالطريقة نفسها في هذه الواجهة البرمجية وفي نموذج إعدادات الإدارة وفي أداة MCP. ويُرسَل النص إلى النموذج في كل دور من كل محادثة، فهو تكلفة مالية بقدر ما هو سياسة.

الاستجابات

  • 200 موجّهات كِلا المساعدَين.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/ai/prompts' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/ai/prompts #

ضبط إرشادات المشغّل لأحد المساعدَين أو مسحها

admin:write api.read api.privileged

يستبدل إرشادات المشغّل المضافة إلى موجّه نظام أحد المساعدَين، أو يمسحها. ويتطلّب رمزًا مميزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

يحدّد surface أيّ مساعد يُقصد: assistant للمساعد بعد تسجيل الدخول، وpublic لفقاعة الدردشة التسويقية المجهولة. وهما حقلان منفصلان لأن جمهورهما منفصل، ولا يستطيع أحدهما قراءة نص الآخر.

يجب أن يكون الحقل guidance موجودًا. وتؤدّي القيمة null أو السلسلة الفارغة إلى مسحه واستعادة الموجّه المدمج كما هو تمامًا؛ أما النص الذي يتجاوز max_guidance محرفًا فيُرفض بالرمز 422 بدل أن يُقتطع.

ولا يمكن كتابة الموجّه المدمج نفسه هنا ولا في أي مكان آخر — راجع عملية GET على هذا المسار.

ويُسجَّل كل تغيير على صف الإعدادات في سجل التدقيق، سواء جرى هنا أو في نموذج إعدادات الإدارة أو عبر أداة MCP، ويكون صاحب الرمز المميز المنفِّذ هو الفاعل. ويُجاب بالمستند نفسه الذي تعيده عملية GET، فيرى المستدعي الذي يضبط النص نتيجة كتابته دون طلب ثانٍ.

جسم الطلب مطلوب

الحقل النوع الوصف
surface مطلوب string أي مساعد سيجري تحديثه.
guidance مطلوب string إرشادات المشغّل المراد تخزينها، أو null/فارغ لمسحها.

الاستجابات

  • 200 موجّهات كِلا المساعدَين بعد عملية الكتابة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/ai/prompts' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "surface": "assistant",
    "guidance": "string"
}'
GET /admin/audit-logs #

سرد سجلات سجل التدقيق

admin:read api.read

صفحة من سجل التدقيق كاملًا، الأحدث أولًا (occurred_at تنازليًا، وid يفصل التساوي حتى يستطيع العميل التنقّل بين الصفحات دون أن يرى السجل نفسه مرتين).

يتطلّب رمزًا مميزًا بصلاحية admin:read يحمل صاحبه دور admin (أو super-admin) و صلاحية audit.view. ولا تكفي الصلاحية وحدها: فالرمز يبقى بعد الدور الذي كان صاحبه يحمله عند إصداره، ولذلك يُفحص الدور في كل طلب.

وسجل التدقيق يُضاف إليه فقط ولا تجري له أي مطابقة، ولذلك لا يوجد معامل refresh ولا دلالات استطلاع دوري — فالسجل لا يتغيّر أبدًا بعد كتابته.

ولا تُنشر الحقول changes وcontext وhash وprevious_hash؛ راجع مخطط AuditLog لمعرفة السبب. وسلسلة البصمات مختومة ويجري التحقق منها خارج هذه الواجهة البرمجية بالأمر c2:verify-audit-chain.

وأي معامل استعلام غير مذكور أدناه يؤدي إلى 422 بدل أن يُتجاهل: فلولا ذلك لتلقّى العميل الذي يخطئ في كتابة اسم مرشِّح سجلَّ التدقيق كاملًا بلا ترشيح، وهو يظن أنه طرح سؤالًا أضيق.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
actor_id اختياري query integer min 1 السجلات التي كتبها هذا المستخدم فقط.
subject_id اختياري query integer min 1 السجلات التي يكون صاحب البيانات فيها هذا المستخدم فقط.
event اختياري query string max length 96 مطابقة نص جزئي مع اسم الحدث المنقوط.
domain اختياري query string one of cloud, billing, dns, tickets, account, auth, shop, privacy, partner, system يُبقى متطابقًا تمامًا مع `App\Enums\AuditDomain`، وهو ما يشتقّ منه `IndexAuditLogRequest` قاعدة التحقق الخاصة به — راجع حقل `domain` في مخطط `AuditLog`.
from اختياري query string الحد الأدنى لـ `occurred_at`، شاملًا إياه.
to اختياري query string الحد الأعلى لـ `occurred_at`، شاملًا إياه.

الاستجابات

  • 200 صفحة من سجلات التدقيق.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/audit-logs' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/audit-logs/{auditLog} #

جلب سجل واحد من سجل التدقيق

admin:read api.read

سجل واحد من السجل الذي يُضاف إليه فقط.

هذه هي نقطة النهاية الوحيدة في واجهة الموظفين التي تجيب بالرمز 403 بدل 404 عن سجل لا يحق للمستدعي قراءته. ففي المواضع الأخرى لا يمكن تمييز مورد خارج نطاق المستدعي عن مورد غير موجود، لأن النطاق هناك محدَّد لكل عميل؛ أما سجل التدقيق فمجموعة عامة واحدة، ولذلك فإن القول «هذا السجل موجود لكن قراءته ليست من حقك» هو الجواب الصادق.

وخلافًا للمجموعة، لا يحمل هذا المسار شرط audit.view في وسيطته البرمجية — إذ يتولّى التخويل AuditLogPolicy، فيسمح لمدير يحمل audit.view، ولصاحب البيانات نفسه وهو يقرأ سجلّه، ولموظف دعم يحمل مستوى view على الأقل في نطاق السجل تجاه صاحب ذلك السجل. أما السجلات في النطاقات auth وshop وprivacy وsystem فلا مقابل لها في الدعم ولا تظهر لموظف الدعم أبدًا.

ولا تُنشر الحقول changes وcontext وhash وprevious_hash؛ راجع مخطط AuditLog.

المعاملات

الاسم الموضع النوع الوصف
auditLog مطلوب path integer min 1 معرّف سجل التدقيق.

الاستجابات

  • 200 سجل التدقيق.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/audit-logs/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/support-assignments #

سرد مصفوفة تعيينات الدعم

admin:read api.read

كل صف من جدول تعيينات الدعم، الأحدث تحديثًا أولًا: أي موظف يجوز له التصرّف تجاه أي عميل، وبأي مستوى في كل نطاق من النطاقات الخمسة.

ويتطلّب رمزًا مميزًا بصلاحية admin:read يحمل صاحبه دور admin (أو super-admin) وصلاحية support.manage. والمسار المقابل في منطقة الإدارة محميّ بـ role_or_permission:super-admin|support.manage؛ ويُقبل هنا أيضًا super-admin لا يحمل الصلاحية حرفيًا، عبر بوابة الصلاحية المطلقة في التطبيق، وهو ما يجعل الاثنين متكافئين. وهذا التكافؤ مُثبَت باختبار لا مفترَض.

وهذه القائمة للقراءة فقط. فهذا الجدول هو مستوى التحكّم لكل بوابة على واجهة Support: والرمز القادر على الكتابة فيه كان بإمكانه منح أي موظف مستوى manage على أي عميل، ولا سياسة تقف خلف مسار كهذا. وكشف جانب الكتابة يحتاج نموذج تهديد خاصًا به، لا مجرّد إضافة فعل HTTP.

ويُختصر الطرفان إلى {id, name, email}، ويكونان null إذا كان الحساب قد حُذف. ونشر المصفوفة للقراءة فقط يتيح للمشغّل أن يقارن الوصول المقصود بالوصول الفعلي دون المساس بأيّهما.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من صفوف التعيينات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/support-assignments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/staged-actions #

سرد قائمة انتظار الموافقات

admin:read api.read

كل إجراء طلبه رمز ويقرّره شخص — خبر يُراد نشره، وأنواع أخرى تُضاف لاحقًا — الأحدث أولًا، مع ما سيفعله (preview) ومن طلبه وما آل إليه. استطلع هذه القائمة أو السجل المفرد لتعرف ما إذا كان الطلب قد وُوفق عليه أو رُفض أو انتهت مهلته أو فشل.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

للقراءة فقط، وذلك عن قصد. لا توجد في هذه الواجهة نقطة نهاية توافق على سجل أو ترفضه: فذلك نقرة يؤديها مدير مسجَّل الدخول في صفحة الموافقات في منطقة الإدارة (approval_url). الرمز لا يملك إلا أن يطلب. ولا تُنشر الحمولة المجمّدة؛ وpreview هي الجملة التي يقرؤها من يوافق.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string one of pending, approved, rejected, expired, failed السجلات التي في هذه الحالة فقط.
action اختياري query string السجلات من هذا النوع فقط، مثل `publish_news`. ويُرفض النوع غير المعروف بالرمز `422`.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من سجلات قائمة الانتظار.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/staged-actions' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/staged-actions/{stagedAction} #

جلب سجل واحد من قائمة انتظار الموافقات

admin:read api.read

سجل واحد من قائمة انتظار الموافقات، بحسب قيمة staged_action_id التي أعادها الطلب الذي أنشأه. تنتقل status من pending إلى واحدة فقط من approved أو rejected أو expired أو failed، ولا تعود أبدًا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. للقراءة فقط: راجع القائمة لمعرفة السبب.

المعاملات

الاسم الموضع النوع الوصف
stagedAction مطلوب path integer min 1 معرّف سجل قائمة الانتظار.

الاستجابات

  • 200 سجل قائمة الانتظار.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/staged-actions/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/news #

سرد الأخبار

admin:read api.read

أخبار الموقع، الأحدث أولًا — المسودات والمنشورة معًا، وتُصفّى بحسب published عند تمريره.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. هذا محتوى تحريري: لا تُقرأ بيانات أي شخص، ولذلك لا يُكتب سطر في سجل الوصول.

المعاملات

الاسم الموضع النوع الوصف
published اختياري query boolean `true` للأخبار المنشورة فقط، و`false` للمسودات فقط.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الأخبار.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/news' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/news #

إنشاء مسودة خبر

admin:write api.read api.privileged

ينشئ مسودة بالقواعد التي تطبّقها أدوات المسودات: title حتى 255 محرفًا، وbody حتى 2048، وlanguage إحدى القيم tr-TR أو en-US أو ar-SA، وaudience اختياري. ولا يُنشر هنا ولا يُجدول ولا يُرسل أبدًا: يُرفض وجود is_published أو publish_date أو scheduled_for في الجسم بالرمز 422 (فالخبر المجدول يُنشر من تلقاء نفسه عند حلول موعده)، والنشر طلب منفصل يجب أن يوافق عليه مدير (POST /admin/news/{news}/publish).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
title مطلوب string
body مطلوب string
language مطلوب string
audience اختياري string

الاستجابات

  • 201 المسودة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/news' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "string",
    "body": "string",
    "language": "tr-TR"
}'
GET /admin/news/{news} #

جلب خبر واحد

admin:read api.read

خبر واحد بحسب معرّفه. يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
news مطلوب path integer min 1 معرّف الخبر.

الاستجابات

  • 200 الخبر.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/news/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/news/{news} #

تعديل مسودة خبر

admin:write api.read api.privileged

يغيّر الحقول المُرسلة فقط (title وbody وlanguage وaudience)، ويخضع كل منها لقواعد الإنشاء؛ والجسم الفارغ يجيب بـ 422، وكذلك is_published أو publish_date أو scheduled_for. ولا يمكن هنا تعديل خبر منشور، ولا مسودة جدولها أحدهم في منطقة الإدارة، ويجيب ذلك بـ 422. POST لا PATCH: فكل عملية كتابة في واجهة الموظفين هي POST.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
news مطلوب path integer min 1 معرّف المسودة.

جسم الطلب مطلوب

الحقل النوع الوصف
title اختياري string
body اختياري string
language اختياري string
audience اختياري string

الاستجابات

  • 200 المسودة بعد التعديل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/news/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "string",
    "body": "string",
    "language": "tr-TR",
    "audience": "everyone"
}'
POST /admin/news/{news}/publish #

طلب نشر خبر

admin:write api.read api.privileged

يُدرج نشر مسودة في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا ينشر شيئًا ولا يرسل شيئًا: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. ويُرفض الخبر المنشور أصلًا بالرمز 422. وكل طلب يُنشئ سجلًا جديدًا.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
news مطلوب path integer min 1 معرّف المسودة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/news/1/publish' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/news/{news}/schedule #

طلب نشر خبر في لحظة محددة

admin:write api.read api.privileged

يُدرج النشر المجدول لمسودة في قائمة انتظار الموافقات ويجيب بـ 202، مثل POST /admin/news/{news}/publish. هذا الطلب لا يجدول شيئًا ولا ينشر شيئًا ولا يرسل شيئًا: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وبعد الموافقة يُنشر الخبر ويُرسل إلى جمهوره خلال دقيقة من publish_at، ولا يمكن التراجع عن ذلك؛ وحتى ذلك الحين يسحب POST /admin/news/{news}/unschedule الجدولة. وتُرفض الموافقة إن مرّ publish_at أثناء انتظار السجل، أو إن تغيّر الخبر في الأثناء.

publish_at تاريخ ووقت بصيغة ISO-8601 في المستقبل. فإن حمل إزاحة (Z أو +03:00) دلّ على تلك اللحظة بالضبط؛ وإلا قُرئ في timezone (اسم IANA، والافتراضي Europe/Istanbul). ويكتب preview في الإيصال اللحظة بتوقيت Europe/Istanbul وبتوقيت UTC. يُرفض بالرمز 422: لحظة في الماضي، وخبر منشور أصلًا، واللحظة المجدول لها الخبر أصلًا، وخبر له جدولة أو نشر ينتظر الموافقة، ومسودة ينقصها العنوان أو النص أو اللغة. وإعادة الطلب لمسودة مجدولة تنقل موعدها.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
news مطلوب path integer min 1 معرّف المسودة.

جسم الطلب مطلوب

الحقل النوع الوصف
publish_at مطلوب string موعد النشر، بصيغة ISO-8601، في المستقبل.
timezone اختياري string المنطقة الزمنية بحسب IANA لقيمة `publish_at` بلا إزاحة. الافتراضي `Europe/Istanbul`.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/news/1/schedule' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "publish_at": "2026-11-02T09:00:00+03:00"
}'
POST /admin/news/{news}/unschedule #

سحب جدولة خبر

admin:write api.read api.privileged

يعيد مسودة مجدولة إلى مسودة غير مجدولة، فلا تُنشر في موعدها المجدول. يُنفّذ فورًا دون موافقة: لا يُنشر شيء ولا يُرسل شيء، ويبقى الخبر مسودة يمكن تعديلها مجددًا أو جدولتها مجددًا عبر POST /admin/news/{news}/schedule. ويُسجَّل الإجراء في سجل التدقيق. ويُرفض بالرمز 422 خبر منشور أصلًا (أُرسل ولا يمكن التراجع عنه) أو خبر غير مجدول.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
news مطلوب path integer min 1 معرّف المسودة المجدولة.

الاستجابات

  • 200 المسودة، وقد أصبحت غير مجدولة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/news/1/unschedule' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/coupons #

سرد القسائم

admin:read api.read api.privileged

قسائم هذا التثبيت، الأحدث أولًا: الرمز والشروط والنطاق (عام، أو خاص بحساب واحد مع بريد مالكه) وقيد المنتجات وحد الاستعمال وعدده وعدد الاشتراكات التي تحمل كلًّا منها. وتُصفّى بـ query (جزء من الرمز أو الوصف) وstatus وaccount_id — أي القسائم الخاصة بذلك الحساب أو المرفقة بأحد اشتراكاته أو التي استعملها.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ولأن القسيمة الخاصة تسمّي عميلًا، يكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
query اختياري query string max length 255 جزء من الرمز أو الوصف.
status اختياري query string one of live, upcoming, expired `live` أو `upcoming` أو `expired`، بحسب نافذة الاستعمال.
account_id اختياري query integer min 1 القسائم الخاصة بهذا الحساب أو المرفقة بأحد اشتراكاته أو التي استعملها فقط.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من القسائم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/coupons' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/coupons/{coupon} #

جلب قسيمة واحدة وكل اشتراك تحملها

admin:read api.read api.privileged

قسيمة واحدة مع كل اشتراك أُرفقت به: الاشتراك وحالته (is_superseded يعني خطوة سابقة في سلسلة تجديد أو تغيير حجم)، والحساب وبريد مالكه، ووقت إرفاق القسيمة، وdiscount_ends_at — لحظة توقّف الخصم على ذلك الاشتراك، بالقاعدة نفسها التي تُسعَّر بها فواتيره: بداية المدة مضافًا إليها duration_months و25 يومًا، أو valid_before إن كان أبكر. وتبدأ المدة عند الإرفاق، أو عند أول شراء في سلسلة الاشتراك إن كان الإرفاق بلا تاريخ (window_source: chain_origin).

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب سطر وصول billing.pii_read — باسم مالك الحساب للقسيمة الخاصة، وإلا فقراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
coupon مطلوب path integer min 1 معرّف القسيمة.

الاستجابات

  • 200 القسيمة مع كل اشتراك تحملها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/coupons/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/coupons/{coupon} #

طلب تغيير شروط قسيمة

admin:write api.read api.privileged

يُدرج تعديل القسيمة في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. أرسل ما تشاء من description وdiscount_percent (الخصم المعدَّل هنا حدّه الأقصى 50 بالمئة؛ وما فوقه 422) وduration_months (1-120 — أطِلها لتمديد الخصم إلى ما بعد التجديد) وvalid_after وvalid_before؛ والمفتاح الغائب يبقى كما هو. ولا يُغيَّر هنا الرمز ولا نطاق الحساب ولا حد الاستعمال ولا نطاق المنتجات. وتسمّي المعاينة كل اشتراك فعّال يحمل القسيمة مع تاريخ انتهاء خصمه الآن وبعد التعديل؛ ولا يعيد التعديل تسعير الفواتير المفتوحة أصلًا. وتعديل ثانٍ للقسيمة نفسها والأول ما زال منتظرًا يجيب بـ 422. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction}.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
coupon مطلوب path integer min 1 معرّف القسيمة.

جسم الطلب مطلوب

الحقل النوع الوصف
description اختياري string
discount_percent اختياري integer
duration_months اختياري integer
valid_after اختياري string
valid_before اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/coupons/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "string",
    "discount_percent": 1,
    "duration_months": 1,
    "valid_after": "string",
    "valid_before": "string"
}'
POST /admin/coupons/{coupon}/attach #

طلب إرفاق قسيمة باشتراك

admin:write api.read api.privileged

يُدرج إرفاق القسيمة بالاشتراك المسمّى في الجسم في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة تخصم القسيمة من ذلك الاشتراك مدة duration_months من لحظة الموافقة، ويُعاد تسعير فواتيره المفتوحة (غير المدفوعة)؛ أما الفاتورة التي استهلكت رصيدًا من الحساب فتبقى كما هي ويُذكر رقمها. ويحمل الاشتراك قسيمة واحدة: فتحلّ محلّ أي قسيمة عليه. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — حين لا تستطيع القسيمة الخصم من الاشتراك اليوم (لم تسرِ بعد، أو انتهت، أو رمز خاص بعميل آخر، أو منتج لا تشمله، أو بلغت حد الاستعمال، أو انتهت مدتها أصلًا)، ولاشتراك حلّ محلّه تجديد أو تغيير حجم، ولاشتراك يحمل هذه القسيمة أصلًا، وما دام تغيير قسيمة آخر على الاشتراك نفسه منتظرًا. وتعرض المعاينة السعر الآن وبعده. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
coupon مطلوب path integer min 1 معرّف القسيمة.

جسم الطلب مطلوب

الحقل النوع الوصف
subscription_id مطلوب integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/coupons/1/attach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "subscription_id": 1
}'
POST /admin/coupons/{coupon}/detach #

طلب إزالة قسيمة من اشتراك

admin:write api.read api.privileged

يُدرج إزالة القسيمة من الاشتراك المسمّى في الجسم في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يُسعَّر الاشتراك دون الخصم ابتداءً من فاتورته التالية، ويُعاد تسعير فواتيره المفتوحة (غير المدفوعة) بهذا الرقم؛ أما الفاتورة التي استهلكت رصيدًا من الحساب فتبقى كما هي ويُذكر رقمها. والإزالة تنزع كل القسائم عن الاشتراك، وتسمّي المعاينة كلًّا منها. ويُرفض بـ 422 حين لا يحمل الاشتراك القسيمة، وما دام تغيير قسيمة آخر على الاشتراك نفسه منتظرًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
coupon مطلوب path integer min 1 معرّف القسيمة.

جسم الطلب مطلوب

الحقل النوع الوصف
subscription_id مطلوب integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/coupons/1/detach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "subscription_id": 1
}'
GET /admin/payments #

سرد المدفوعات

admin:read api.read api.privileged

المدفوعات في كل حسابات العملاء، الأحدث أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_payments. يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، ومبالغ الدفعة المخزّنة بعملتها، وkind، وهل هي مُستبدلة أو إدارية. وتُصفّى بـ account_id وstatus.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer المدفوعات التابعة لهذا الحساب فقط.
status اختياري query string one of new, payed, failed, canceled, expired, refunded, partially_refunded المدفوعات في هذه الحالة فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من المدفوعات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/payments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/payments/{payment} #

قراءة دفعة واحدة

admin:read api.read api.privileged

دفعة واحدة من أي حساب عميل — الجواب الذي تعطيه أداة MCP الإدارية get_payment: مبالغها المخزّنة، والاشتراكات التي سدّدتها، وكل سطر استرداد عليها (بما فيها المعلّقة والفاشلة، وهي أموال ما زالت مستحقة)، وسطور الاسترداد المكتملة بمبالغها المجمّدة، وما عاد إلى البطاقة وإلى رصيد الحساب، وحالة فائدة التأخير. والمعرّف المجهول يُجاب بـ 404.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read باسم مالك الحساب الدافع. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer معرّف الدفعة.

الاستجابات

  • 200 دفعة واحدة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/payments/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/subscriptions #

سرد الاشتراكات

admin:read api.read api.privileged

الاشتراكات في كل حسابات العملاء، الأحدث أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_subscriptions. يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، وحقول العقد، وهل هو مُستبدل أو إداري، وقسائمه. وتُصفّى بـ account_id وstatus (new, pending, failed, deployed, locked, terminated, scaling, unknown).

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الاشتراكات التابعة لهذا الحساب فقط.
status اختياري query string الاشتراكات في هذه الحالة فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الاشتراكات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/subscriptions' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/subscriptions/{subscription} #

قراءة اشتراك واحد

admin:read api.read api.privileged

اشتراك واحد من أي حساب عميل — الجواب الذي تعطيه أداة MCP الإدارية get_subscription: العقد، وقسائمه، وسعره المتّفق عليه، وسجلّ تغيير حجمه كاملًا (كل خطوة في السلسلة، وما حصّلته، وما عاد وإلى أين) والمدفوعات التي سدّدته. المبالغ في السجلّ {amount, currency} بالوحدة الصغرى. والمعرّف المجهول يُجاب بـ 404.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read باسم مالك الحساب. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer معرّف الاشتراك.

الاستجابات

  • 200 اشتراك واحد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/subscriptions/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/refunds #

سرد المبالغ المستردّة

admin:read api.read api.privileged

المبالغ المستردّة في كل حسابات العملاء — الجواب الذي تعطيه أداة MCP الإدارية list_refunds. غير المكتملة أولًا: المعلّقة، ثم الفاشلة، ثم الجديدة، ثم المكتملة، والأحدث أولًا داخل كلٍّ منها. يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، والدفعة والاشتراك اللذين يشير إليهما، وما أعاده وإلى أين. وتُصفّى بـ account_id وstatus (new, pending, done, failed).

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer المبالغ المستردّة التابعة لهذا الحساب فقط.
status اختياري query string المبالغ المستردّة في هذه الحالة فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من المبالغ المستردّة مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/refunds' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/failed-payments #

سرد المدفوعات الفاشلة

admin:read api.read api.privileged

طابور المدفوعات الفاشلة — الجواب الذي تعطيه أداة MCP الإدارية list_failed_payments: المدفوعات الفاشلة التي ما زال تحصيلها ممكنًا (تُستثنى الفاتورة التي استوعبتها دفعة مستحقات لاحقة)، الأحدث فشلًا أولًا. للصفوف شكل GET /admin/payments. وتُصفّى بـ account_id. ولا تُتاح إعادة المحاولة هنا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer المدفوعات الفاشلة لهذا الحساب فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من المدفوعات الفاشلة مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/failed-payments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/invoice-worklist #

سرد قائمة عمل الفواتير

admin:read api.read api.privileged

قائمة عمل الفواتير لدى المحاسب، تبويبًا تبويبًا — الجواب الذي تعطيه أداة MCP الإدارية list_invoice_queue. tab: ready (الافتراضي: مدفوعة، تجاوزت مهلة الاستحقاق، بلا فاتورة بعد — الأقدم أولًا)، أو upcoming، أو review، أو issued. يحمل كل صف معرّف الدفعة، والحساب وبريد مالكه، ومتى حُصّلت ومتى تستحق، والمبالغ التي يجب أن تذكرها الوثيقة أعدادًا عشرية بعملة الدفعة نفسها. ويعيد أيضًا الأعداد لكل تبويب ومهلة الاستحقاق بالأيام.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read واحدًا، قراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
tab اختياري query string أيّ تبويب: ready (الافتراضي)، أو upcoming، أو review، أو issued.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من قائمة العمل مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/invoice-worklist' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/price-notices #

معاينة إشعارات تغيير السعر

admin:read api.read api.privileged

معاينة إشعارات تغيير السعر التعاقدية — الجواب الذي تعطيه أداة MCP الإدارية list_price_notices: كل حساب له سعر متّفق عليه، ومالكه، وهل يمكن إرسال إشعار، ولكل اشتراك السعر الحالي والجديد أعدادًا عشرية بالدولار الأمريكي (يقول currency في الجواب USD)، وتاريخ سريان السعر الجديد والموعد النهائي للإشعار. لا يُرسل شيء: الإرسال قرار يُتخذ في منطقة الإدارة.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read واحدًا، قراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الحسابات مع المجاميع وبيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/price-notices' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/dunning-preview #

معاينة دورة متابعة المتأخرات

admin:read api.read api.privileged

ما ستفعله دورة التعليق اليومية التالية (متابعة المتأخرات) دون فعل شيء منه — الجواب الذي تعطيه أداة MCP الإدارية preview_dunning: لكل اشتراك متأخر الإجراء (warn أو suspend أو enforce أو none)، والموعد النهائي، ومهلته، والعميل، والفاتورة المفتوحة. العاجل أولًا. وتُصفّى بـ action. لا يُنبَّه أحد ولا يُعلَّق شيء ولا يُرسل.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read واحدًا، قراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
action اختياري query string الصفوف التي ستفعل بها الدورة فقط: warn أو suspend أو enforce أو none.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الصفوف مع المجاميع وبيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/dunning-preview' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/renewal-preview #

معاينة دورة التجديد

admin:read api.read api.privileged

ما ستحصّله دورة التجديد الساعية التالية — وما لن تحصّله ولماذا — دون تحصيل شيء: الجواب الذي تعطيه أداة MCP الإدارية preview_renewals. يحمل كل صف الاشتراك، وتصنيفه (bill أو comp أو stranded أو open_bill أو paid_ahead أو excluded)، والفترات المستحقة، والصافي والإجمالي نصًّا للعرض، وكيف يصل التجديد إلى العميل، والعميل، والقسيمة التي يُسعَّر بها. وتُصفّى بـ disposition. لا يُحصَّل شيء ولا يُرسل.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read واحدًا، قراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
disposition اختياري query string الصفوف بهذا التصنيف فقط: bill أو comp أو stranded أو open_bill أو paid_ahead أو excluded.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الصفوف مع المجاميع وبيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/renewal-preview' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/referral-rewards #

سرد مكافآت الإحالة

admin:read api.read api.privileged

مكافآت الإحالة — الجواب الذي تعطيه أداة MCP الإدارية list_referral_rewards. filter: pending (الافتراضي: مستوفية تنتظر قرار شخص)، أو rewarded، أو rejected، أو all. الأحدث أولًا. يحمل كل صف المُحيل والعميل المُحال (المعرّف والاسم والبريد)، والحساب المُحال، ومتى استوفى الشروط أو كوفئ أو رُفض، والمكافأة عددًا عشريًا بالدولار الأمريكي (reward_usd)، وأي إشارات إحالة ذاتية.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read واحدًا، قراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
filter اختياري query string أيّ المكافآت: pending (الافتراضي)، أو rewarded، أو rejected، أو all.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من مكافآت الإحالة مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/referral-rewards' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/partner-rebates #

سرد مستحقات الوكالات

admin:read api.read api.privileged

مستحقات الوكالات (hakediş) — الجواب الذي تعطيه أداة MCP الإدارية list_partner_rebates. status: held (الافتراضي: محسوبة تنتظر فاتورة الوكالة وصرف شخص لها) أو all. الأقدم فترةً أولًا. يحمل كل صف حساب الشريك وبريد مالكه، والفترة، والحجم المُفوتر، والنسبة، والمستحق أعدادًا عشرية بالدولار الأمريكي، وهل توجد فاتورة سارية في الملف، ورقم تلك الفاتورة وتاريخها وإجماليها، ومتى رُفعت المبالغ آخر مرة.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول billing.pii_read واحدًا، قراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string أيّ المستحقات: held (الافتراضي) أو all.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من المستحقات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/partner-rebates' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/instances #

سرد الأجهزة الافتراضية

admin:read api.read api.privileged

الأجهزة الافتراضية في كل حسابات العملاء، الأقدم أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_instances، من النسخة المخزّنة في الموقع لا من قراءة حيّة للسحابة. وتُدرج الأجهزة المتقاعدة المنتظرة في طابور الاحتفاظ. يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، وحقول الجهاز المخزّنة، وكتلة retired الفارغة للجهاز الحيّ. وتُصفّى بـ account_id وstate.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول cloud.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
state اختياري query string one of running, stopped, starting, stopping, migrating, shutdown, destroyed, expunging, error, unknown الأجهزة في هذه الحالة فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الأجهزة مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/instances' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/instances/{instance} #

قراءة جهاز افتراضي واحد

admin:read api.read api.privileged

جهاز افتراضي واحد بمعرّفه، من أيّ حساب عميل، ولو كان متقاعدًا — الجواب الذي تعطيه أداة MCP الإدارية get_instance، من النسخة المخزّنة في الموقع. يعيد الجهاز مع حسابه ومالكه، وأقراصه، وعناوين IP العامة على شبكته، والشبكة نفسها، والاشتراك الذي يدفع عنه، وكتلة retired الفارغة للجهاز الحيّ.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب سطر وصول cloud.pii_read باسم مالك الجهاز. المعرّف غير الموجود يُجاب بـ 404 ولا يُسجَّل شيء. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
instance مطلوب path integer معرّف الجهاز كما تعيده القائمة.

الاستجابات

  • 200 الجهاز وما يتّصل به.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/instances/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/volumes #

سرد الأقراص

admin:read api.read api.privileged

الأقراص في كل حسابات العملاء، الأقدم أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_volumes، من النسخة المخزّنة في الموقع لا من قراءة حيّة للسحابة. وتُدرج الأقراص المتقاعدة. يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، وحقول القرص المخزّنة، والجهاز الموصول به، وكتلة retired الفارغة ما لم يكن للقرص نفسه سطر في سجلّ الاحتفاظ. وتُصفّى بـ account_id.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول cloud.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الأقراص مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/volumes' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/networks #

سرد الشبكات

admin:read api.read api.privileged

الشبكات في كل حسابات العملاء، الأقدم أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_networks، من النسخة المخزّنة في الموقع. يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، واسم الشبكة لدى المزوّد وتسميتها، وحالتها، وهل هي الشبكة المجانية الافتراضية للحساب أم شبكة مشتراة، وعدد الأجهزة وعناوين IP العامة القائمة عليها. الشبكات تُزال ولا تُحال إلى التقاعد، فلا كتلة احتفاظ هنا. وتُصفّى بـ account_id.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول cloud.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الشبكات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/networks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/public-ip-addresses #

سرد عناوين IP العامة

admin:read api.read api.privileged

عناوين IPv4 العامة في كل حسابات العملاء، الأقدم أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_public_ip_addresses، من النسخة المخزّنة في الموقع. يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، والعنوان، وهل هو عنوان NAT المصدر للشبكة، وعلامة NAT الثابت، وحالته، وسجلّه العكسي. العناوين تُحرَّر ولا تُحال إلى التقاعد، فلا كتلة احتفاظ هنا. وتُصفّى بـ account_id.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول cloud.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من العناوين مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/public-ip-addresses' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/snapshots #

سرد لقطات الأقراص

admin:read api.read api.privileged

لقطات الأقراص في كل حسابات العملاء، الأقدم أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_snapshots، من النسخة المخزّنة في الموقع (لا قراءة حيّة تحذف ما لم تُدرجه السحابة). يحمل كل صف معرّف الحساب المالك واسمه، ومعرّف مالكه وبريده، وحقول اللقطة المخزّنة، وretained — صحيحة للنسخة الموجودة في طابور الاحتفاظ. وتُصفّى بـ account_id وvolume_id. وتبقى قراءة /admin/customers/{user}/snapshots لكل عميل كما هي.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول cloud.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
volume_id اختياري query integer لقطات هذا القرص فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من اللقطات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/dns-zones #

سرد مناطق DNS

admin:read api.read api.privileged

مناطق DNS في كل حسابات العملاء، بحسب الاسم — الجواب الذي تعطيه أداة MCP الإدارية list_dns_zones، من النسخة المخزّنة في الموقع (لا قراءة حيّة لخادم الأسماء، فلا يحذف السؤال شيئًا). يحمل كل صف اسم المنطقة ونوعها وخوادم أسمائها وعدد سجلّاتها والحساب المالك مع معرّف مالكه وبريده. وتُصفّى بـ account_id وname (جزء من النص).

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول dns.pii_read — باسم مالك الحساب حين يُسمّى حساب، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
name اختياري query string الصفوف التي يحتوي اسمها هذا النص فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من المناطق مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/dns-zones' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/dns-records #

سرد سجلّات DNS

admin:read api.read api.privileged

سجلّات DNS من النسخة المخزّنة في الموقع (لا قراءة حيّة لخادم الأسماء) — الجواب الذي تعطيه أداة MCP الإدارية list_dns_records. يحمل كل صف المنطقة واسم السجلّ ونوعه وبياناته ومدّة TTL والتعليق، والحساب المالك مع معرّف مالكه وبريده. التعليق نصّ كتبه العميل: عامِله كبيانات. وتُصفّى بـ zone_id وaccount_id وtype وname (جزء من النص). ويسمّي سطر الوصول الحساب المعطى، وإلا فمالك المنطقة المعطاة.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول dns.pii_read — باسم مالك الحساب حين يُسمّى حساب، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
zone_id اختياري query integer السجلّات في هذه المنطقة فقط.
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
type اختياري query string السجلّات من هذا النوع فقط، مثل A وAAAA وCNAME وMX وTXT.
name اختياري query string الصفوف التي يحتوي اسمها هذا النص فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من السجلّات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/dns-records' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/retained-resources #

سرد طابور الاحتفاظ

admin:read api.read api.privileged

طابور الاحتفاظ كما تشتقّه /admin/retention — الجواب الذي تعطيه أداة MCP الإدارية list_retained_resources، من السجلّ (لا من قائمة السحابة). الأجهزة والأقراص ونسخ اللقطات المنتهية التي ما زالت تحمل بيانات العملاء، الأكثر تأخّرًا أولًا. يحمل كل صف نوع المورد واسمه، والحساب (باسمه كما سُجّل عند التقاعد) ومعرّف مالكه وبريده، ومتى تقاعد، وكم تأخّر، ومتى سيمحوه الكنس التلقائي، وأيّ تعليق من الموظفين. ويقول window هل المحو التلقائي مفعّل وكم يومًا من الإشعار يحصل الموظفون. وتُصفّى بـ account_id وstate (pending — الافتراضي — وheld وoverdue وpurged وreinstated).

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول account.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer الصفوف التابعة لهذا الحساب فقط. القيمة 0 أو أقل تقرأ الأسطول كله.
state اختياري query string one of pending, held, overdue, purged, reinstated أيّ الصفوف: pending (الافتراضي) أو held أو overdue أو purged أو reinstated.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الطابور مع حقائق النافذة وبيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/retained-resources' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/usage #

قراءة استهلاك الأسطول

admin:read api.read api.privileged

ما استهلكته السحابة كلها خلال نافذة زمنية، ومن استهلكه — الجواب الذي تعطيه أداة MCP الإدارية get_fleet_usage، والأرقام التي تعرضها /admin/usage: المجاميع (ساعات الأجهزة العاملة والمخصّصة، ومتوسّطات التخزين واللقطات والقوالب، وساعات العناوين، وحركة الشبكة) وصفّ لكل حساب (الحساب، ومعرّف مالكه وبريده، وساعات الأجهزة العاملة، وجيجابايتات التخزين والشبكة)، الأثقل أولًا. يأخذ days القيم 7 أو 30 (الافتراضي) أو 90؛ ويغلب from وto (YYYY-MM-DD بتوقيت غرينتش، تنتهي أمس على الأكثر) حين يصحّان معًا. النافذة المعيبة تأخذ الافتراضي. ويضيف include_series=true السلاسل اليومية. كميات فقط، بلا أسعار.

القراءة الوحيدة للموظفين التي تسأل خادم استخدام السحابة: قد يستغرق أول استدعاء لنافذة عشرات الثواني، ثم يُخزَّن ساعة (مشتركًا مع /admin/usage). لا يُطابَق شيء ولا يُحذف. وحين يتعذّر الوصول إلى خادم الاستخدام يقول الجواب available: false. وتُصفّح بيانات التصفّح صفوف الحسابات.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول cloud.pii_read بوصفه قراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
days اختياري query integer 7 أو 30 (الافتراضي) أو 90. يُتجاهل حين يُعطى from وto معًا.
from اختياري query string اليوم الأول، YYYY-MM-DD (بتوقيت غرينتش).
to اختياري query string اليوم الأخير، YYYY-MM-DD (بتوقيت غرينتش)؛ أمس على الأكثر.
include_series اختياري query string one of true, false, 1, 0, yes, no, on, off القيمة true تضيف السلاسل اليومية.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 استهلاك الأسطول خلال النافذة، وصفحة من صفوف الحسابات، وبيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/usage' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/catalogue #

سرد الكتالوج بكل تفاصيله

admin:read api.read api.privileged

منتجات الكتالوج من نوع واحد (vm أو volume أو ip أو network أو service) بكل تفاصيلها: كل ما تعيده GET /product-prices (الأسعار كأرقام عشرية عادية بالدولار) إضافةً إلى النص بالإنجليزية والتركية والعربية، وfront_page وsnapshot_mode وsnapshot_variant_of_id للأجهزة، وnetwork_offering_id للشبكات، وtemplate_ids وfree وper_unit وpartner_training للخدمات. نفس مرشّحات /product-prices، إضافةً إلى ids (قائمة معرّفات المنتجات) — التوأم عبر REST لأداة MCP الإدارية list_catalogue.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. بلا تسجيل: الكتالوج قائمة أسعار الكيان نفسه، لا بيانات عميل أبدًا، فلا يُكتب أي سطر وصول على أي من واجهتَي الإدارة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
type اختياري query string one of vm, volume, ip, network, service vm أو volume أو ip أو network أو service. الافتراضي vm.
published_only اختياري query boolean المنتجات المعروضة للبيع فقط. الافتراضي true.
template اختياري query string لـvm فقط — معرّف قالب، أو جزء من اسمه.
min_price اختياري query number أدنى سعر شهري بالدولار (للخدمة: دفعة واحدة).
max_price اختياري query number أعلى سعر شهري بالدولار (للخدمة: دفعة واحدة).
ids اختياري query array of integer معرّفات هذه المنتجات فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من منتجات الكتالوج بتفاصيلها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/catalogue' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/product-prices #

سرد أسعار الكتالوج لنوع منتج واحد

admin:read api.read api.privileged

أسعار الكتالوج لنوع منتج واحد (vm أو volume أو ip أو network أو service)، بحيث يمكن طرح تغيير للموافقة عبر set_product_price أو set_product_published. كل صف: النوع، المعرّف، الاسم، قالب الجهاز، المواصفات (vm: vcpu وram_gb وdisk_gb؛ volume: size_gb)، وmonthly_price_usd وannual_price_usd (للخدمة: one_time_price_usd) كأرقام عشرية عادية بالدولار (12.5 تعني USD 12.50؛ null = لا تُباع في تلك الفترة)، وispublished، وnever_priced (بلا خطة، أو عند القيمة الاحتياطية 99 من المسح)، وwithheld (لـvm: مخفي عن العملاء ما دامت فئة لقطة الجهاز الحي غير قابلة للبيع)، وlive_subscriptions (منشور أو مقفل، غير مُستبدل، غير مجّاني) وعدد ما يحمل منها سعرًا متفقًا عليه. التوأم عبر REST لأداة MCP الإدارية list_product_prices.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. بلا تسجيل: لا يُقرأ أي صف عميل، بل أسعار الكيان وأدواته وعدد الاشتراكات الحية فقط، فلا يُكتب أي سطر وصول على أي من واجهتَي الإدارة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
type اختياري query string one of vm, volume, ip, network, service vm أو volume أو ip أو network أو service. الافتراضي vm.
published_only اختياري query boolean المنتجات المعروضة للبيع فقط. الافتراضي true.
template اختياري query string لـvm فقط — معرّف قالب، أو جزء من اسمه.
min_price اختياري query number أدنى سعر شهري بالدولار (للخدمة: دفعة واحدة).
max_price اختياري query number أعلى سعر شهري بالدولار (للخدمة: دفعة واحدة).
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من أسعار الكتالوج.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/product-prices' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/catalogue/building-blocks #

سرد ما تُبنى منه تهيئات الأجهزة

admin:read api.read api.privileged

ما تُبنى منه تهيئات الأجهزة، بحيث يمكن تسمية تهيئة: النوع "templates" (المعرّف، الاسم، الوصف، نظام التشغيل، retired وretired_at، النص التسويقي — excerpt وhero وlong_description بالإنجليزية والتركية والعربية، manual_url، youtube_url — وعدد التهيئات الموجودة عليه، وعدد المنشور منها، وعدد المعروض منها للبيع فعلًا — لا شيء بعد تقاعد القالب)، أو "compute_offerings" (المعرّف، الاسم، الوصف، vcpu، cpu_speed_mhz، ram_gb)، أو "disk_offerings" (المعرّف، الاسم، الوصف، disk_gb). منتج vm هو قالب واحد × عرض حوسبة × عرض قرص؛ يُعثر على معرّفه بـ/catalogue أو /product-prices (مرشّح القالب). يُصفّي name بجزء من الاسم. يقرأ النسخة المخزّنة فقط، لا يسأل السحابة أبدًا. التوأم عبر REST لأداة MCP الإدارية list_catalogue_building_blocks.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. بلا تسجيل: القوالب والعروض هي أجزاء كتالوج الكيان نفسه، لا يُذكر أحد، فلا يُكتب أي سطر وصول على أي من واجهتَي الإدارة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
kind اختياري query string one of templates, compute_offerings, disk_offerings templates أو compute_offerings أو disk_offerings. الافتراضي templates.
name اختياري query string جزء من الاسم.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من القوالب أو عروض الحوسبة أو عروض الأقراص.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/catalogue/building-blocks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/faqs #

سرد أسئلة الصفحة العامة الشائعة

admin:read api.read api.privileged

أسئلة الصفحة العامة الشائعة بترتيب العرض (position ثم id): السؤال والجواب بالإنجليزية والتركية والعربية، والموضع، وهل هو منشور. مرشّح اختياري published (true/false). غير مُصفّح. التوأم عبر REST لأداة MCP الإدارية list_faqs.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. بلا تسجيل: هذا نص الأسئلة الشائعة العام للكيان نفسه، لا يحمل بيانات عميل، فلا يُكتب أي سطر وصول على أي من واجهتَي الإدارة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
published اختياري query boolean المنشور فقط (true) أو المسودّات فقط (false).

الاستجابات

  • 200 كل سؤال شائع، بترتيب العرض.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/faqs' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/faqs/{faq} #

قراءة سؤال شائع واحد

admin:read api.read api.privileged

سؤال شائع واحد بمعرّفه. التوأم عبر REST لأداة MCP الإدارية get_faq.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. بلا تسجيل: هذا سؤال من الأسئلة الشائعة العامة للكيان نفسه، لا يحمل بيانات عميل، فلا يُكتب أي سطر وصول على أي من واجهتَي الإدارة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
faq مطلوب path integer min 1 معرّف السؤال الشائع، كما تعيده GET /faqs.

الاستجابات

  • 200 السؤال الشائع.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/faqs/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/accounts #

سرد حسابات العملاء

admin:read api.read api.privileged

حسابات العملاء في التثبيت كله، الأقدم أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_accounts. يحمل كل صف معرّف الحساب واسمه، ومعرّف المالك وبريده، وعلامتي القفل والإغلاق، والرصيد القائم، وأعداد الدخولات والأجهزة والأقراص والاشتراكات. يطابق query اسم الحساب أو اسم المالك أو بريده أو معرّف حساب رقميًا مطابقًا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول account.pii_read بوصفه قراءةً عامة؛ ولا يُسجَّل نص البحث إلا علامةً. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
query اختياري query string جزء من اسم الحساب أو اسم المالك أو بريده، أو معرّف حساب مطابق.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الحسابات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/accounts' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/accounts/{accountId} #

قراءة حساب عميل واحد

admin:read api.read api.privileged

حساب عميل واحد بمعرّفه — الجواب الذي تعطيه أداة MCP الإدارية get_account: دخولاته (كلٌّ بمعرّفه وبريده ودوره)، وحصص الموارد الست كلها بجانب المستخدم منها، والرصيد القابل للإنفاق، والفواتير المفتوحة، ومنح الرصيد السارية، وأعداد الاشتراكات والمدفوعات، وcontrols: حال كل ضابط في الحساب (حدود بوابة الذكاء الاصطناعي، وحظر الاسترداد والمتجر، وإعداد إشعارات الفواتير، وشروط الشراكة وبيانات البنك مع إخفاء IBAN، وإشعارات إنهاء الشراكة المفتوحة، وصلاحيات كل عضو، والدعوات المعلّقة). الحالة المخزّنة فقط.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب سطر وصول account.pii_read باسم مالك الحساب. المعرّف غير الموجود يُجاب بـ 404 ولا يُسجَّل شيء. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer معرّف الحساب كما تعيده قائمة الحسابات.

الاستجابات

  • 200 الحساب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/accounts/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/accounts/{accountId}/bill-notices #

تعيين ما إذا كان الحساب يُبلَّغ بالفواتير الجديدة

admin:write api.read api.privileged

يعيّن تفضيل إشعار الفواتير للحساب ويجيب بـ 200 مع الحالة الجديدة: inherit يتبع إعداد التثبيت، وon يُبلغ عملاء الحساب بكل فاتورة جديدة، وoff لا يُبلغهم أبدًا. يسري فورًا ويُسجَّل التغيير في سجل التدقيق. ولا يتأثر زر إبلاغ العميل الخاص بالموظفين.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
notify_pending_payments مطلوب string

الاستجابات

  • 200 حالة إشعار الفواتير للحساب بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/bill-notices' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "notify_pending_payments": "inherit"
}'
POST /admin/accounts/{accountId}/pay-day #

تعيين اليوم الذي تتجدد فيه اشتراكات الحساب

admin:write api.read api.privileged

يعيّن يوم الشهر (1–28) الذي تتجدد فيه كل اشتراكات الحساب ويجيب بـ 200 معه؛ وnull يعيد كل اشتراك إلى تاريخ ذكراه السنوية. وتُفوتر الفترة حتى اليوم الجديد بالتناسب عند التجديد التالي لكل اشتراك؛ وتحتفظ الاشتراكات السنوية بشهرها. ولا تتغير أي فاتورة مفتوحة. يسري فورًا ويُسجَّل التغيير في سجل التدقيق.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
day مطلوب integer

الاستجابات

  • 200 يوم الدفع للحساب بعد التغيير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/pay-day' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "day": 1
}'
POST /admin/accounts/{accountId}/default-interest #

طلب تشغيل فائدة التأخير لحساب أو إيقافها

admin:write api.read api.privileged

يُدرج تفضيل فائدة التأخير للحساب في قائمة انتظار الموافقات ويجيب بـ 202: inherit يتبع مفتاح التثبيت (billing_default_interest_enabled في GET /admin/settings)، وon يحتسب فائدة التأخير على فواتير الحساب المتأخرة أيًا كان ذلك المفتاح، وoff لا يحتسب أي فائدة ولا يعرض فائدة متراكمة. ويُرفض بـ 422 إذا كان الحساب على ذلك الإعداد أصلًا أو ما دام تغيير آخر مماثل عليه ينتظر، أو من دون سبب (reason). هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
default_interest_enabled مطلوب string
reason مطلوب string سبب تغيير الإعداد؛ يُسجَّل مع التغيير. تشغيل الفائدة ليس بأثر رجعي — فهي تتراكم فقط من لحظة تشغيلها.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/default-interest' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "default_interest_enabled": "inherit",
    "reason": "string"
}'
POST /admin/accounts/{accountId}/block #

طلب حظر الاسترداد أو الشراء على حساب

admin:write api.read api.privileged

يُدرج تشغيل أحد مفتاحَي الموظفين في الحساب أو إيقافه في قائمة انتظار الموافقات ويجيب بـ 202. switch: refunds يوقف طلبات الاسترداد التي يقدّمها العميل بنفسه (تظل استردادات الموظفين ممكنة؛ ولا تتغير مهلة الأيام السبعة)؛ وswitch: shop يعطّل الشراء بينما يستمر كل ما يملكه العميل في العمل. ويلزم reason للحظر؛ يقرؤه الموظفون ولا يقرؤه العميل أبدًا. ويُرفض بـ 422 إذا كان المفتاح في ذلك الوضع أصلًا، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لحساب يضم تسجيل دخول لمشرف أعلى. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
switch مطلوب string
blocked مطلوب boolean
reason اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/block' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "switch": "refunds",
    "blocked": true
}'
POST /admin/accounts/{accountId}/combine-bills #

طلب دمج الفواتير المفتوحة لعميل في دفعة واحدة

admin:write api.read api.privileged

يُدرج دمج جميع الفواتير المفتوحة في الحساب في دفعة واحدة — وهو نظير الموظفين لزر "ادفع الكل" لدى العميل — في قائمة انتظار الموافقات ويجيب بـ 202. وعند الموافقة يصبح لدى العميل فاتورة واحدة تُسدَّد بعملية خصم واحدة من البطاقة وتحقق واحد عبر 3-D Secure؛ لا تُحصِّل الموافقة شيئًا، ولا يتغير أي مبلغ (يبقى كل فترة بسعرها)، وتبقى بطاقة العميل نفسها، ولا يُرسل شيء إلى العميل. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — إذا كان في الحساب أقل من فاتورتين مفتوحتين أو فواتير بأكثر من عملة، وتُرفض الموافقة إذا تغيرت الفواتير المفتوحة بعد الإدراج. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} هو معرّف الحساب كما يعيده GET /admin/accounts؛ ويجيب المعرّف المجهول بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/combine-bills' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/accounts/{accountId}/partner-bank-details #

طلب تسجيل البيانات المصرفية لشريك

admin:write api.read api.privileged

يُدرج تسجيل (أو استبدال) الحساب المصرفي الذي تُحوَّل إليه مستحقات الشريك في قائمة انتظار الموافقات ويجيب بـ 202. يكفي للشريك الذي يُفوتَر في تركيا account_holder وIBAN تركي؛ أما الشريك الأجنبي فيحتاج أيضًا إلى swift وbank_name. ولا تعرض المعاينة والنتيجة إلا آخر أربعة أحرف من IBAN. ويُرفض بـ 422 إذا كانت هذه هي البيانات المسجلة بالفعل. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
account_holder مطلوب string
iban مطلوب string
swift اختياري string
bank_name اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/partner-bank-details' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_holder": "string",
    "iban": "string"
}'
POST /admin/accounts/{accountId}/partnership-end #

طلب إنهاء شراكة شريك

admin:write api.read api.privileged

يُدرج إنهاء شراكة الحساب في قائمة انتظار الموافقات ويجيب بـ 202. mode: now ينهيها فورًا (ground: breach_immediate أو inactivity أو insolvency أو partner_terminated)؛ وmode: schedule ينهيها في بداية يوم date (ground: convenience — بعد 30 يومًا على الأقل — أو inactivity أو insolvency)؛ وmode: cure يرسل إشعار مخالفة يقرؤه الشريك (breach_description) وينهي الشراكة بعد 30 يومًا ما لم يُعلِّم الموظفون المخالفة بأنها عولجت. ويلزم reason لـ now وschedule؛ يقرؤه الموظفون ولا يقرؤه الشريك أبدًا. ويُرفض بـ 422 لحساب ليس شريكًا، أو لسبب inactivity لشريك لم يُقَس عدم نشاطه، أو لإنهاء عادي ثانٍ، أو لإشعار مخالفة مفتوح ثانٍ. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
mode مطلوب string
ground اختياري string
date اختياري string
reason اختياري string
breach_description اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/partnership-end' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "now"
}'
POST /admin/accounts/{accountId}/partnership-end/{notice}/outcome #

طلب البت في إشعار إنهاء شراكة مفتوح

admin:write api.read api.privileged

يُدرج قرارًا بشأن إشعار إنهاء مفتوح للحساب في قائمة انتظار الموافقات ويجيب بـ 202. decision: withdraw يتراجع عن إنهاء جدوله الموظفون (لا إشعار مخالفة أبدًا، ولا الإشعار الذي قدّمه الشريك نفسه)؛ وremedied يعلّم إشعار مخالفة بأنه عولج؛ وescalate ينهي الشراكة فورًا بسبب المخالفة (ويلزم reason)؛ وopen_code وclose_code يغيّران مفتاح إشعار المخالفة الذي يسمح لرمز الشريك بمواصلة ربط عملاء جدد ما دام الإشعار قائمًا. أما إشعار الشريك نفسه فلا يُسحب إلا باتفاق الطرفين: يطلب الشريك ذلك من صفحة الشريك، فيوافق accept_withdrawal على الطلب (فيُسحب الإشعار)، بينما يترك decline_withdrawal الإشعار ينقضي في موعده (وreason اختياري ولا يُعرض على الشريك أبدًا؛ ويمكن للشريك أن يطلب من جديد). ويُرفض كلاهما بـ 422 ما لم يكن طلب الشريك قائمًا، أو بعد حلول تاريخ الإشعار؛ والرد الذي تتم الموافقة عليه بعد تغيّر طلب الشريك (رُفض ثم طُلب مجددًا) يفشل بدلًا من الرد على الطلب الجديد. ويُبلَّغ الشريك بتحريك مفتاح الرمز (بالبريد الإلكتروني وفي صفحة الشريك الخاصة به)، دون ذكر السبب أبدًا. ويُرفض بـ 422 لإشعار غير مفتوح في هذا الحساب. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.
notice مطلوب path integer min 1 معرّف إشعار الإنهاء المفتوح في هذا الحساب.

جسم الطلب مطلوب

الحقل النوع الوصف
decision مطلوب string
reason اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/partnership-end/1/outcome' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "decision": "withdraw"
}'
POST /admin/accounts/{accountId}/members/invite #

طلب دعوة عنوان إلى الحساب

admin:write api.read api.privileged

يُدرج دعوة email للانضمام إلى الحساب {accountId} بالإعداد preset في قائمة انتظار الموافقات ويجيب بـ 202. وعند الموافقة تُرسل الدعوة بالبريد باسم مالك الحساب؛ ولا يتغير شيء حتى يقبلها الشخص، ولا يُنشأ له أي تسجيل دخول. ويُرفض بـ 422 لحساب بلا مالك، أو إعداد غير معروف، أو عنوان لديه دعوة من قبل، أو عنوان ينتظر الموافقة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
email مطلوب string
preset مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/members/invite' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "string",
    "preset": "owner"
}'
POST /admin/accounts/{accountId}/members/{member}/capabilities #

طلب استبدال صلاحيات عضو

admin:write api.read api.privileged

يُدرج استبدال مصفوفة صلاحيات {member} في قائمة انتظار الموافقات ويجيب بـ 202. وcapabilities تربط كل مجال (cloud وbilling وdns وtickets وshop وaccount وmembers وai) بـ none أو view أو manage؛ والمجال المحذوف يصبح none. ويُرفض بـ 422 لمالك الحساب، أو مجال أو مستوى غير معروف، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لتسجيل دخول مشرف أعلى. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.
member مطلوب path integer تسجيل دخول في الحساب `{accountId}`؛ وأي معرّف آخر يُجاب بـ `404`.

جسم الطلب مطلوب

الحقل النوع الوصف
capabilities مطلوب object

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/members/1/capabilities' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "capabilities": []
}'
POST /admin/accounts/{accountId}/members/{member}/remove #

طلب إزالة تسجيل دخول عضو

admin:write api.read api.privileged

يُدرج إزالة {member} من الحساب في قائمة انتظار الموافقات ويجيب بـ 202. ويُحذف تسجيل الدخول؛ ويحتفظ الحساب بكل ما يملكه. ويُرفض بـ 422 لمالك الحساب، ولتسجيل الدخول الوحيد على الحساب، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لتسجيل دخول مشرف أعلى. ولا يمكن إزالة تسجيل دخول ما زالت التذاكر أو الطلبات أو الفواتير تشير إليه: فتفشل الموافقة حينها. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.
member مطلوب path integer تسجيل دخول في الحساب `{accountId}`؛ وأي معرّف آخر يُجاب بـ `404`.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/members/1/remove' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/accounts/{accountId}/merge #

طلب دمج حساب آخر في هذا الحساب

admin:write api.read api.privileged

يُدرج دمج الحساب source_account_id في الحساب {accountId} في قائمة انتظار الموافقات ويجيب بـ 202: ينتقل كل تسجيل دخول في المصدر إلى هنا بالإعداد preset، وينتقل رصيد المصدر معهم، ويُغلق المصدر. ولا يمكن التراجع عن ذلك. ويُرفض بـ 422 ما لم يكن المصدر قابلًا للدمج كما يقول مربع الدمج في منطقة الإدارة (لا عائق — خوادم أو أقراص أو عناوين أو مناطق أو اشتراكات مفتوحة أو استردادات غير منتهية أو تسجيلات دخول لموظفين أو شراكة سارية — ولا أحد الحسابين مغلق، وليسا الحساب نفسه). وتحل الموافقة محل التأكيد المكتوب يدويًا في منطقة الإدارة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
source_account_id مطلوب integer
preset مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/merge' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_account_id": 1,
    "preset": "owner"
}'
POST /admin/accounts/{accountId}/quotas #

طلب حصص جديدة لحساب

admin:write api.read api.privileged

يُدرج حصصًا جديدة للحساب — الأجهزة والأقراص واللقطات اليدوية ومفاتيح بوابة الذكاء الاصطناعي والعناوين العامة والشبكات (وتُحسب الشبكة المجانية التي يملكها كل حساب) — في قائمة انتظار الموافقات ويجيب بـ 202. اذكر الحصص التي تتغير فقط؛ وتحتفظ البقية بقيمها الحالية. والحدود هي حدود صفحة الحساب نفسها. ولا تزيل الحصة الأدنى شيئًا يملكه الحساب؛ بل توقف الطلبات الجديدة. ويُرفض بـ 422 إذا لم يكن ثمة ما يتغير أو كان الإجراء نفسه بانتظار الموافقة. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
max_vms اختياري integer
max_vols اختياري integer
max_snapshots اختياري integer
ai_max_keys اختياري integer
max_ips اختياري integer
max_networks اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/quotas' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "max_vms": 1,
    "max_vols": 1,
    "max_snapshots": 1,
    "ai_max_keys": 1,
    "max_ips": 1,
    "max_networks": 1
}'
POST /admin/accounts/{accountId}/ai-limits #

طلب حدود جديدة لبوابة الذكاء الاصطناعي لحساب

admin:write api.read api.privileged

يُدرج قائمة النماذج المسموح بها وحدود المعدل لبوابة الذكاء الاصطناعي في الحساب في قائمة انتظار الموافقات ويجيب بـ 202. وتعني allowed_models الفارغة أو null كل نموذج قابل للبيع؛ ويُرفض النموذج الذي لا تستطيع البوابة تسعيره. ولا تتغير الميزانية هنا أبدًا — فهي منحة تُضبط من صفحة الحساب — ويُرفض بـ 422 الحساب الذي لم يستخدم البوابة قط. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
allowed_models اختياري array of string
rpm_limit اختياري integer
tpm_limit اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/ai-limits' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "allowed_models": [
        "string"
    ],
    "rpm_limit": 1,
    "tpm_limit": 1
}'
POST /admin/accounts/{accountId}/partner #

طلب شروط شراكة جديدة لحساب

admin:write api.read api.privileged

يُدرج حفظ بطاقة الشريك للحساب — مستوى الموزّع وخصمه، وتاريخ البدء، وحصة الوكالة ومستواها، والوكالة المديرة — في قائمة انتظار الموافقات ويجيب بـ 202. والنسب كسور بنسب مئوية صحيحة. وعند الموافقة يُنفَّذ حفظ البطاقة نفسه: يعيد الخصم تسعير الفواتير المفتوحة للحساب ويُبلَّغ الشريك. وتصفير النسبتين في شراكة سارية لا ينهيها ويُرفض بـ 422؛ وإنهاء الشراكة يكون عبر POST /admin/accounts/{accountId}/partnership-end. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin. و{accountId} معرّف الحساب كما تعيده GET /admin/accounts — بما في ذلك حساب لم يبقَ عليه أي تسجيل دخول (المصدر المغلق لعملية دمج)؛ والمعرّف غير المعروف يُجاب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
accountId مطلوب path integer min 1 معرّف الحساب كما تعيده `GET /admin/accounts`. وهو يسمّي الحساب لا تسجيل دخول، لذا يمكن الوصول إلى حساب لم يبقَ عليه أي تسجيل دخول — المصدر المغلق لعملية دمج. واسمه `accountId` لا `account`: لا يقيّد مسار الموظفين بشخص إلا `user`.

جسم الطلب مطلوب

الحقل النوع الوصف
partner_tier اختياري string
partner_discount اختياري number
partner_since اختياري string
rebate_rate اختياري number
rebate_tier اختياري string
partner_account_id اختياري integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/accounts/1/partner' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "partner_tier": "string",
    "partner_discount": 1,
    "partner_since": "string",
    "rebate_rate": 1,
    "rebate_tier": "string",
    "partner_account_id": 1
}'
GET /admin/privacy-requests #

سرد طلبات أصحاب البيانات

admin:read api.read api.privileged

طلبات تصدير البيانات الشخصية ومحوها، الأقرب موعدًا قانونيًا أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_privacy_requests. القيمة الافتراضية لـ status هي pending (ما ينتظر شخصًا، وهو شرط شارة التنقّل نفسه)؛ وall توسّع إلى السجلّ كله. يحمل كل صف النوع والحالة، ومتى قُدّم الطلب ومتى يستحق، وهل تأخّر، وسبب مقدّمه بكلماته ونصّ القرار، ومعرّف مقدّمه واسمه وبريده. لا يُنشر موضع أرشيف التصدير أبدًا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول account.pii_read بوصفه قراءةً عامة. للقراءة فقط: لا يُتاح هنا البتّ في الطلب.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string pending (الافتراضي) أو processing أو ready أو completed أو rejected أو all.
type اختياري query string export أو erasure.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الطلبات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/privacy-requests' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/partner-applications #

سرد طلبات الشراكة

admin:read api.read api.privileged

طلبات الشراكة، الأحدث أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_partner_applications. القيمة الافتراضية لـ status هي pending (ما ينتظر قرارًا)؛ وall توسّع إلى السجلّ كله؛ وkind هو reseller أو agency. يحمل كل صف الحساب المتقدّم مع معرّف مالكه وبريده، والنوع والحالة والولاية القضائية، وبيان المتقدّم بكلماته (بيانات)، وعدد المستندات التي رفعها، والقرار إن وُجد، والمتقدّم بمعرّفه واسمه وبريده، وهل ما زالت الاتفاقية السارية تحتاج إلى قبول. ويذكر الجواب أيضًا نسخة الاتفاقية الحالية وهل البرنامج مفتوح.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول account.pii_read بوصفه قراءةً عامة. للقراءة فقط: لا يُتاح هنا البتّ.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string pending (الافتراضي) أو admitted أو rejected أو withdrawn أو ended أو all.
kind اختياري query string reseller أو agency.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الطلبات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/partner-applications' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/join-requests #

سرد طلبات الانضمام إلى مؤسسة

admin:read api.read api.privileged

طلبات عميل للانضمام إلى مؤسسة عميل آخر، الأحدث أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_join_requests. القيمة الافتراضية لـ status هي open (ما يمكن الردّ عليه الآن، وهو شرط شارة التنقّل نفسه)؛ وall توسّع إلى السجلّ كله. يحمل كل صف الحالة، وهل ما زال يمكن الردّ عليه، ومعرّف الطالب واسمه وبريده، والمؤسستين بمعرّفيهما واسميهما، ورسالة الطالب بكلماته (بيانات)، ومتى قُدّم ومتى ينتهي، ومن بتّ فيه. لا يُنشر العنوان الذي كتبه الطالب أبدًا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول account.pii_read بوصفه قراءةً عامة. للقراءة فقط: لا يُتاح هنا البتّ.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string open (الافتراضي) أو new أو approved أو denied أو cancelled أو expired أو all.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من طلبات الانضمام مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/join-requests' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/invitations #

سرد دعوات العملاء

admin:read api.read api.privileged

دعوات العملاء، الأحدث أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_invitations: المعرّف والعنوان واللغة والحالة (new أو sent أو registered أو declined) والنوع (new_customer أو member أو link)، وهل ما زالت معلّقة أو انتهت، والدخول الذي تشير إليه (الداعي حتى قبولها، ثم العميل الجديد) بمعرّفه وبريده، وaccept_url الموجود فقط ما دامت قابلة للقبول. لا تُسرد دعوات الموظفين هنا أبدًا: فهي GET /admin/staff-invitations.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول account.pii_read بوصفه قراءةً عامة؛ ولا يُسجَّل نص البحث إلا علامةً. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string new أو sent أو registered أو declined.
query اختياري query string جزء من العنوان المدعو.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من الدعوات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/invitations' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/tickets #

سرد تذاكر الدعم

admin:read api.read api.privileged

تذاكر الدعم في كل الحسابات، الأحدث أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_tickets. يحمل كل صف الحساب ومالكه (المعرّف والبريد)، ومقدّم الطلب (المعرّف والبريد)، والفئة والحالة والأولوية، ومن يتولّى الموضوع، وهل هو أمر عمل خدمة. تُدرج مواضيع الشراكة وتُعلَّم بـ admin_only. العناوين نصوص كتبها العملاء، مختصرة. القيمة الافتراضية لـ status هي active (new أو open أو pending)؛ ويُرفض المرشّح المرسَل فارغًا كأي كلمة مجهولة.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول tickets.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string active (الافتراضي) أو all أو إحدى: new أو open أو pending أو solved أو closed أو merged أو spam.
category اختياري query string general أو cloud أو billing أو dns أو account أو partnership.
assignee اختياري query string معرّف مستخدم من الموظفين، أو none للمواضيع التي لا يتولّاها أحد.
account_id اختياري query integer مواضيع هذا الحساب فقط.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من التذاكر مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/tickets' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/tickets/{ticket} #

قراءة تذكرة دعم واحدة

admin:read api.read api.privileged

تذكرة دعم كاملة — الجواب الذي تعطيه أداة MCP الإدارية get_ticket: حساب الموضوع ومالكه (المعرّف والبريد)، ومن كتبه، وفئته وحالته، ومن يتولّاه، وفي أمر عمل الخدمة أين وصل العمل؛ ثم الرسالة الافتتاحية وكل تعليق بالترتيب، كلٌّ بكاتبه (المعرّف والبريد) وهل كتبه موظف. تُسرد المرفقات بالاسم والحجم والنوع، ولا تُضمَّن أبدًا.

فرقٌ واحد عن الأداة: يُنشر النص وكل تعليق كما هو مخزّن. تسيّج الأداة ذلك بوصفه بيانات غير موثوقة لأن جوابها يدخل سياق نموذج؛ أما هذا الجواب فهو JSON لبرنامج. عامِل النص مع ذلك بوصفه بيانات.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب سطر وصول tickets.pii_read باسم مالك الموضوع. المعرّف غير الموجود يُجاب بـ 404 ولا يُسجَّل شيء. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer معرّف التذكرة كما تعيده قائمة التذاكر.

الاستجابات

  • 200 الموضوع ومرفقاته وكل تعليق.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/tickets/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/audit-logs/search #

البحث في سجلّ التدقيق

admin:read api.read api.privileged

سجلّ التدقيق، الأحدث أولًا، بمرشّحات صفحة /admin/audit — الجواب الذي تعطيه أداة MCP الإدارية search_audit_log. يطابق event كل اسم حدث يحتوي النص. يحمل كل قيد الوقت والحدث ومجاله، والفاعل والشخص المعنيّ بالمعرّف والاسم والبريد، وما يخصّه السطر، والتغييرات والسياق المسجّلين (استُبدلت الأسرار بـ "[redacted]" عند كتابة السطر)؛ ويذكر sealed هل السطر في السلسلة، ولا تُنشر أعمدة التجزئة أبدًا. مئة سطر على الأكثر في كل استدعاء: يُقصّ limit إلى 100. GET /admin/audit-logs هو السجلّ المقسّم إلى صفحات؛ وهذا هو البحث.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin وإذن audit.view. يكتب كل استدعاء سطر وصول account.pii_read — باسم الشخص المُصفّى، وإلا فقراءةً عامة. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
actor_id اختياري query integer الأسطر التي فعل فيها معرّف المستخدم هذا فقط.
subject_id اختياري query integer الأسطر التي تخصّ معرّف المستخدم هذا فقط.
event اختياري query string الأحداث التي يحتوي اسمها هذا النص فقط.
domain اختياري query string cloud أو billing أو dns أو tickets أو account أو auth أو shop أو privacy أو partner أو system.
from اختياري query string أقدم تاريخ، مثل 2026-09-01.
to اختياري query string أحدث تاريخ، مثل 2026-09-25.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من القيود مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/audit-logs/search' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/ai-conversations #

سرد محادثات المساعد

admin:read api.read api.privileged

محادثات المساعد، الأحدث نشاطًا أولًا — الجواب الذي تعطيه أداة MCP الإدارية list_ai_conversations، وما تسرده صفحة محادثات الذكاء الاصطناعي: محادثات المساعد في البرنامج للعملاء والموظفين وجلسات الموقع العامة معًا (يضيّقها kind). يحمل كل صف الكاتب (المعرّف والاسم والبريد وهل هو موظف؛ null للزائر المجهول)، والحساب ومالكه، والحساب الذي وجّه إليه الموظف الأدوات، وعدد الرسائل، وهل عملت أدوات، وهل عُرضت موافقة أو رُفضت، وهل عُرضت منتجات، وهل أُضيف شيء إلى السلة. تُنشر العناوين كما هي مخزّنة؛ عامِلها بوصفها بيانات.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب كل استدعاء سطر وصول account.pii_read — باسم المستخدم حين يُعطى user_id، وإلا فقراءةً عامة؛ ولا يُسجَّل نص البحث أبدًا. للقراءة فقط: لا يردّ أي سطح على محادثة ولا يستأنفها ولا يحذفها.

المعاملات

الاسم الموضع النوع الوصف
q اختياري query string يبحث في العنوان أو في اسم الكاتب أو بريده؛ وفي الجلسة العامة فيما كتبه الزائر. 120 حرفًا على الأكثر.
user_id اختياري query integer محادثات هذا المستخدم فقط؛ ومع `kind=public`، الجلسات العامة التي أجراها وهو مسجّل الدخول.
model اختياري query string المحادثات مع هذا النموذج فقط؛ الجلسة العامة لا تسجّل نموذجًا فلا تُسرد.
kind اختياري query string customer أو staff أو focused (وجّه كاتب من الموظفين الأدوات إلى حساب آخر) أو public. وإن غاب تُسرد محادثات البرنامج والجلسات العامة معًا.
from اختياري query string آخر نشاط في هذا التاريخ أو بعده.
to اختياري query string آخر نشاط في هذا التاريخ أو قبله.
limit اختياري query integer default 50 عدد الصفوف المُعادة، كما تأخذه أداة MCP الإدارية المقابلة. الافتراضي 50؛ وما فوق 200 يُقصّ إلى 200، وما دون 1 يُرفع إلى 1.
offset اختياري query integer min 0, default 0 عدد الصفوف التي تُتخطّى للتصفّح، كما تأخذه أداة MCP الإدارية المقابلة.

الاستجابات

  • 200 صفحة من المحادثات مع بيانات التصفّح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/ai-conversations' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/ai-conversations/{conversationId} #

قراءة محادثة مساعد واحدة

admin:read api.read api.privileged

محادثة مساعد واحدة في البرنامج كاملةً — الجواب الذي تعطيه أداة MCP الإدارية get_ai_conversation لرقم، وما تعرضه صفحة محادثات الذكاء الاصطناعي: الرأس، والكاتب (المعرّف والاسم والبريد وهل هو موظف)، والحساب ومالكه، والحساب الذي وجّه إليه الموظف الأدوات، ثم كل رسالة بالترتيب بدورها ووقتها ونصها وسجلها المخزّن (meta: الأدوات التي عملت أو انتظرت الموافقة، والمنتجات المعروضة، وما أُضيف إلى السلة) والمنتجات التي عرضتها بأسعار الكتالوج اليوم.

فرقٌ واحد عن الأداة: يُنشر العنوان وكل رسالة كما هي مخزّنة. تسيّجها الأداة بوصفها بيانات غير موثوقة لأن جوابها يدخل سياق نموذج؛ أما هذا الجواب فهو JSON لبرنامج. عامِل النص مع ذلك بوصفه بيانات.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب سطر وصول account.pii_read باسم الكاتب. المعرّف غير الموجود يُجاب بـ 404 ولا يُسجَّل شيء. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
conversationId مطلوب path integer رقم المحادثة كما تعيده قائمة المحادثات.

الاستجابات

  • 200 المحادثة وكل رسائلها بالترتيب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/ai-conversations/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/ai-conversations/public/{sessionId} #

قراءة جلسة واحدة من الموقع العام

admin:read api.read api.privileged

جلسة مساعد واحدة من الموقع العام كاملةً — الجواب الذي تعطيه أداة MCP الإدارية get_ai_conversation لـ uuid، بالشكل نفسه لمحادثة البرنامج (kind هي public، بلا حساب ولا نموذج). والجلسة التي نُسخ محتواها كله لاحقًا إلى محادثة عميل تُجاب بـ 200 بتلك المحادثة وredirected_from_session، حيث تعيد صفحة محادثات الذكاء الاصطناعي التوجيه.

فرقٌ واحد عن الأداة: يُنشر العنوان وكل رسالة كما هي مخزّنة. عامِل النص مع ذلك بوصفه بيانات.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. يكتب سطر وصول account.pii_read باسم الزائر المسجّل دخوله؛ أما جلسة الزائر المجهول فلا تُسجّل شيئًا، كما في الصفحة. الـ uuid غير الموجود يُجاب بـ 404 ولا يُسجَّل شيء. للقراءة فقط.

المعاملات

الاسم الموضع النوع الوصف
sessionId مطلوب path string uuid الجلسة كما تعيده قائمة المحادثات.

الاستجابات

  • 200 المحادثة وكل رسائلها بالترتيب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/ai-conversations/public/sessionId' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/chargebacks #

سرد ردود المبالغ المسجَّلة

admin:read api.read api.privileged

كل مبلغ استرده مصرف من دفعة مسدَّدة، الأحدث أولًا: المبلغ وتاريخ المصرف والسبب ومن سجّله. لا يتحرّك أي مال هنا: يُسجَّل رد المبالغ يدويًا بعد أن ينفّذه المصرف فعلًا، وتسجيله لا يفعل إلا تحديد سقف لردود البيع اللاحقة وردود التصغير، وتخفيض أو مقاصة مستحق شريك كُسب من البيع. ويُصفّى بـ account_id.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer min 1 ردود المبالغ على دفعات هذا الحساب فقط.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من ردود المبالغ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/chargebacks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/invoice-cancellations #

سرد طلبات ردّ الأموال بسبب إلغاء فاتورة

admin:read api.read api.privileged

عميل طلب استردادًا على عملية شراء صدرت لها فاتورة فعلًا، لذا يجب إلغاء الفاتورة على GİB قبل إعادة المال — صفًا واحدًا لكل طلب، مع الدفعة والبند اللذين يخصّهما، وموضعه الحالي، وهل هو عاجل. وتُصفّى القائمة بـ status: open (الافتراضي — requested أو confirmed أو refund_owed)، أو requested، أو confirmed، أو refund_owed، أو refunded، أو declined، أو all. ويضيّق account_id القائمة إلى دفعات حساب واحد.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string max length 32 `open` (الافتراضي) أو `requested` أو `confirmed` أو `refund_owed` أو `refunded` أو `declined` أو `all`.
account_id اختياري query integer min 1 الطلبات الخاصة بدفعات هذا الحساب فقط.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من طلبات إلغاء الفاتورة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/invoice-cancellations' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/payments/{payment}/reminder #

إرسال تذكير الفاتورة المفتوحة إلى العميل الآن

admin:write api.read api.privileged

مباشر، لا يُدرج في قائمة انتظار الموافقات: يرسل إلى العميل الآن رسالة "لديك فاتورة للسداد" العادية عن هذه الفاتورة المفتوحة وحدها، حتى لو عطّل الحساب تنبيهات الفواتير الروتينية — فشخص ما اختار إرسال هذا التذكير بعينه. لا يُحرَّك أي مال ولا يُمنح أي حق؛ ويُسجَّل الإجراء في سجل التدقيق. ويُرفض بـ 422 لفاتورة لا يستطيع العميل سدادها اليوم (مدفوعة أصلًا، أو ملغاة، أو مندمجة في دفعة مجمَّعة، أو فاتورة يرفضها بابه الخاص لأن متجره محظور)، أو لحساب لا يوجد له من يُكتب إليه.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer min 1 معرّف الدفعة.

الاستجابات

  • 200 أُرسل التذكير.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/payments/1/reminder' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/payments/{payment}/chargebacks #

طلب تسجيل رد مبالغ مدفوعة

admin:write api.read api.privileged

يُدرج تسجيل رد مبالغ مدفوعة استردّه المصرف فعلًا في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. لا تُحرِّك الموافقة أي مال — فالمصرف استردّه فعلًا — لكنها سجل مالي قائم: يحدّ من ردود البيع اللاحقة وردود التصغير، ويخفّض أو يقاصّ مستحق شريك كُسب من البيع؛ ويُبلَّغ المديرون. وamount بعملة الدفعة نفسها، من 0.01 حتى ما تبقى على التحصيل (المحصَّل بعد ردود واسترجاعات سابقة)؛ ويسمّي subscription_id بندًا واحدًا من الدفعة، أو كل الدفعة إن أُسقط. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لدفعة غير مسدَّدة وما دام ردّ آخر على الدفعة نفسها منتظرًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer min 1 معرّف الدفعة.

جسم الطلب مطلوب

الحقل النوع الوصف
amount مطلوب number رقم عشري عادي، بعملة الدفعة نفسها، من 0.01 حتى ما تبقى على التحصيل.
bank_date مطلوب string التاريخ المذكور في إشعار المصرف؛ اليوم أو قبله.
reason مطلوب string سبب ردّ المصرف المبلغ.
subscription_id اختياري integer بند واحد من الدفعة. وإن أُسقط فيشمل رد المبالغ الدفعة كلها.
bank_reference اختياري string مرجع المصرف نفسه، إن وُجد.
note اختياري string أي شيء آخر يستحق تسجيله معه.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/payments/1/chargebacks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 1,
    "bank_date": "string",
    "reason": "string"
}'
POST /admin/payments/{payment}/invoice #

طلب إيداع مستند فاتورة عملية بيع

admin:write api.read api.privileged

يُدرج إيداع مستند فاتورة عملية بيع مسدَّدة في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يُسجَّل المستند بأرقام البيع المجمَّدة نفسها ويُرسَل إلى العميل؛ ودفعة لها مستند أصلًا تحصل على نسخة جديدة — ويُحفظ الملف القديم، ولا يُحذف. متعدد الأجزاء (multipart): invoice ملف PDF حتى 4096 كيلوبايت؛ وnumber هو الرقم المسلسل للفاتورة، ويجب أن يكون فريدًا إن أُعطي. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لدفعة ليست عملية بيع مسدَّدة بسيطة، وما دام طلب إلغاء فاتورة عليها لم يُنهَ بعد، وما دام مستند آخر لنفس الدفعة منتظرًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer min 1 معرّف الدفعة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/payments/1/invoice' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/payments/{payment}/default-interest/waive #

طلب التنازل عن فائدة التأخير على فاتورة

admin:write api.read api.privileged

يُدرج التنازل عن فائدة التأخير (التأخر في السداد) على فاتورة واحدة في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويظل على الفاتورة نفسها أن تُسدَّد — فالتنازل عن الفائدة فقط. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لفاتورة لا تحمل فائدة تأخير أصلًا، أو فوترت فائدتها فعلًا، أو تم التنازل عن فائدتها فعلًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer min 1 معرّف الدفعة.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string سبب التنازل عن الفائدة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/payments/1/default-interest/waive' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /admin/payments/{payment}/default-interest/restore #

طلب إرجاع فائدة تأخير تم التنازل عنها

admin:write api.read api.privileged

يُدرج إلغاء التنازل عن فائدة تأخير في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة تعود الفائدة إلى الجريان من تاريخ الاستحقاق نفسه الذي كانته دائمًا — وهذا عكس التنازل، لا ساعة جديدة. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لفاتورة لم يُتنازَل عن فائدتها. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
payment مطلوب path integer min 1 معرّف الدفعة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/payments/1/default-interest/restore' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/subscriptions/{subscription}/agreed-price #

طلب تثبيت اشتراك على سعر متفق عليه

admin:write api.read api.privileged

يُدرج تثبيت الاشتراك على السعر المتفق عليه، بدلًا من سعر الكتالوج وأي قسيمة وأي معدّل شريك، إلى أن يُزال، في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يُعاد تسعير فواتير الاشتراك المفتوحة (غير المدفوعة) إلى السعر المتفق عليه؛ أما الفاتورة التي استهلكت رصيدًا من الحساب فتبقى كما هي ويُذكر رقمها. وagreed_price هو السعر الصافي بالدولار لكل دورة فوترة، قبل ضريبة القيمة المضافة وقبل تحويل العملة. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لاشتراك حلّ محلّه تجديد أو تغيير حجم، وما دام إجراء سعر آخر على الاشتراك نفسه منتظرًا، ولسطر اسم نطاق: فأسماء النطاقات تُجدَّد دائمًا بسعر القائمة لدى السجل ولا تحمل سعرًا متفقًا عليه (والاتفاق الذي يحمله أحدها مسبقًا يُنهى بإزالته). وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer min 1 معرّف الاشتراك.

جسم الطلب مطلوب

الحقل النوع الوصف
agreed_price مطلوب number رقم عشري عادي — السعر الصافي بالدولار لكل دورة فوترة، قبل الضريبة وقبل تحويل العملة.
agreed_price_note اختياري string إشارة إلى الاتفاق — رقم تذكرة، أو مرجع عقد.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/subscriptions/1/agreed-price' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "agreed_price": 1
}'
POST /admin/subscriptions/{subscription}/agreed-price/release #

طلب إزالة سعر متفق عليه

admin:write api.read api.privileged

يُدرج إزالة السعر المتفق عليه لاشتراك في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويبقى السعر المتفق عليه ساريًا حتى أول تجديد يقع بعد مهلة إشعار تعاقدية كاملة (البند 15.2 من اتفاقية الاستخدام)، وعند الموافقة يُرسَل إلى مالك الحساب إشعار تغيير السعر الخطي. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — إن لم يكن على الاشتراك سعر متفق عليه أو كان قد أُزيل فعلًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
subscription مطلوب path integer min 1 معرّف الاشتراك.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/subscriptions/1/agreed-price/release' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/invoice-cancellations/{invoiceCancellation}/confirm #

طلب تسجيل تأكيد شركة

admin:write api.read api.privileged

يُدرج تسجيل تأكيد أُعطي في مكان آخر في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وتسجّل الموافقة أن شركة أكّدت إلغاء فاتورتها الخاصة — ويذكر reason من أكّد وأين (بالهاتف أو بالبريد الإلكتروني) — وتفتح خطوة البتّ التي تُلغي المستند المالي على GİB وتدفع الاسترداد. ولا يُلغى أو يُدفع شيء بهذا الطلب وحده. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — إلا إذا كان الطلب لشركة وكان في انتظار التأكيد. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
invoiceCancellation مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string من أكّد، وأين (بالهاتف، بالبريد الإلكتروني).

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/invoice-cancellations/1/confirm' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /admin/invoice-cancellations/{invoiceCancellation}/resolve #

طلب البتّ في طلب إلغاء فاتورة

admin:write api.read api.privileged

يُدرج تسجيل أن الفاتورة أُلغيت فعلًا على GİB وإرسال الاسترداد الذي يستحقه طلب العميل نفسه في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وهذا ليس استردادًا جديدًا — فالعميل طلبه من بابه الخاص للاسترداد، وكان الاسترداد معلّقًا فقط بسبب الفاتورة. وعند الموافقة يُسأل أولًا عن كل ما قد يرفض الاسترداد، مقيَّمًا بتاريخ طلب العميل؛ فإن رُفض هناك لا يُلغى شيء. وبعد تجاوز ذلك تُعلَّم الفاتورة ملغاة ويُرسَل الاسترداد؛ واسترداد لا يكتمل لا يُفشل الموافقة بل يترك الطلب refund_owed، لأن الفاتورة أُلغيت في الحالتين. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — إلا إذا كان الطلب في حالة confirmed. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
invoiceCancellation مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string ملاحظة عن البتّ.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/invoice-cancellations/1/resolve' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /admin/invoice-cancellations/{invoiceCancellation}/decline #

طلب رفض طلب إلغاء فاتورة

admin:write api.read api.privileged

يُدرج رفض طلب إلغاء فاتورة في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة تبقى الفاتورة سارية ولا يُردّ شيء؛ ويُنشَر reason على تذكرة العميل نفسها كردٍّ، ويُخبَر العميل بذلك. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — بعد أن تكون الفاتورة قد أُلغيت فعلًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
invoiceCancellation مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string سبب رفض الطلب. يقرؤه العميل.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/invoice-cancellations/1/decline' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /admin/invoice-cancellations/{invoiceCancellation}/retry #

طلب إعادة محاولة الاسترداد المستحق لطلب إلغاء فاتورة

admin:write api.read api.privileged

يُدرج إعادة محاولة الاسترداد الذي لا يزال يستحقه طلب في حالة refund_owed في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. والفاتورة مُلغاة فعلًا على GİB، لذا يُكمل هذا مالًا مستحقًا أصلًا — ولا يبدأ استردادًا جديدًا. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — إلا إذا كان الطلب في حالة refund_owed. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
invoiceCancellation مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/invoice-cancellations/1/retry' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/refunds/{refund}/retry #

طلب إعادة محاولة استرداد مستحق

admin:write api.read api.privileged

يُدرج إعادة محاولة سجل استرداد قائم في حالة معلّق أو فاشل في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُكمل هذا مالًا مستحقًا أصلًا — ولا يبدأ استردادًا جديدًا. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لسجل مكتمل فعلًا، أو سجل أُلغي تغيير حجمه، أو سجل بطاقة أُعيد فعلًا كرصيد حساب، أو سجل بطاقة أُرسل إلى بوابة الدفع دون تسجيل نتيجة (وهذا الأخير يُنهى بفحص شاشة بوابة الدفع واستدعاء إجراء البتّ بدلًا منه). وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
refund مطلوب path integer min 1 معرّف سجل الاسترداد.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/refunds/1/retry' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/refunds/{refund}/settle #

طلب البتّ في استرداد أُرسل دون معرفة نتيجته

admin:write api.read api.privileged

يُدرج تسجيل ما فعلته بوابة الدفع باسترداد بطاقة أُرسل دون تسجيل نتيجة في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وهذا حكم إنساني — ما تعرضه شاشة بوابة الدفع نفسها — وليس استردادًا جديدًا أبدًا: فـ landed: true تعني أن بوابة الدفع تُظهر أن الاسترداد وصل، فيُعلَّم السجل مكتملًا دون إرسال شيء؛ وlanded: false تعني أنها لم تستلمه أبدًا، فيُعاد المبلغ إلى العميل كرصيد حساب بدلًا من ذلك. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — إلا إذا كان السجل استرداد بطاقة معلّقًا أُرسل إلى بوابة الدفع فعلًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
refund مطلوب path integer min 1 معرّف سجل الاسترداد.

جسم الطلب مطلوب

الحقل النوع الوصف
landed مطلوب boolean `true` إذا كانت شاشة بوابة الدفع تُظهر أن الاسترداد وصل؛ و`false` إذا لم تستلمه أبدًا.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/refunds/1/settle' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "landed": true
}'
POST /admin/credit-grants/{creditGrant}/reduce #

طلب تخفيض رصيد ممنوح

admin:write api.read api.privileged

يُدرج تخفيض ما تبقى من رصيد ممنوح في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ما يُخصم يذهب نهائيًا: لا يُدفع نقدًا ولا يُعاد إلى بطاقة. ويُجمَّد المتبقي عند الإدراج، فإنفاق رصيد بين الإدراج والموافقة يرفض الإجراء. ولا يُخفَّض إلا حتى ما تبقى — فالزيادة منحة جديدة تُمنح من واجهة الإدارة. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لمتبقٍّ أكبر مما تبقى الآن، ولمنحة انتهت أو استُهلكت أو أُزيلت فعلًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
creditGrant مطلوب path integer min 1 معرّف منح الرصيد.

جسم الطلب مطلوب

الحقل النوع الوصف
remaining_usd مطلوب number رقم عشري عادي — المتبقي الجديد بالدولار، بحد أقصى ما تبقى الآن.
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث تعرضه صفحة الحساب.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/credit-grants/1/reduce' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "remaining_usd": 1,
    "reason": "string"
}'
POST /admin/credit-grants/{creditGrant}/remove #

طلب إزالة رصيد ممنوح

admin:write api.read api.privileged

يُدرج إزالة رصيد ممنوح كاملًا في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وما تبقى يذهب نهائيًا: لا يُدفع نقدًا ولا يُعاد إلى بطاقة. ويُجمَّد المتبقي عند الإدراج، فإنفاق رصيد بين الإدراج والموافقة يرفض الإجراء. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — لمنحة انتهت أو استُهلكت أو أُزيلت فعلًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
creditGrant مطلوب path integer min 1 معرّف منح الرصيد.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث تعرضه صفحة الحساب.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/credit-grants/1/remove' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
GET /admin/carts #

سرد سلال العملاء

admin:read api.read api.privileged

كل سلة في هذا التثبيت، الأحدث أولًا: سلة حساب عادية، أو سلة ضيف بلا تسجيل دخول بعد، أو سلة تتبع طلبًا قُدِّم عبر واجهة البرمجة. وتُصفّى بـ account_id وkind (account أو guest أو api) وnon_empty (السلال التي تحمل سطرًا واحدًا على الأقل فقط).

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب كل استدعاء سطر وصول billing.pii_read — باسم مالك الحساب حين يُعطى account_id، وإلا فقراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer min 1 سلال هذا الحساب فقط.
kind اختياري query string one of account, guest, api `account` أو `guest` أو `api`.
non_empty اختياري query boolean السلال التي تحمل سطرًا واحدًا على الأقل فقط.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من السلال.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/carts' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/carts/{cart} #

جلب سلة واحدة بالكامل

admin:read api.read api.privileged

سلة واحدة مع كل سطر تحمله (المنتج والخطة والسعر الفعلي للوحدة والجهاز الذي يخصّه سطر الخدمة) وقسيمتها وشريكها (أو الرمز الذي تحتفظ به سلة ضيف حتى يتبنّاها تسجيل دخول) وفاتورة الدفع المُدرجة عليها إن وُجدت.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب سطر وصول billing.pii_read — باسم مالك الحساب لسلة حساب، وإلا فقراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.

الاستجابات

  • 200 السلة بالكامل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/carts/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/carts/{cart}/lines #

إضافة منتج إلى سلة

admin:write api.read api.privileged

يضيف سطرًا واحدًا إلى السلة ويجيب بـ 201 مع معرّف السطر الجديد والسلة بالكامل. مباشر: لا شيء يُدرج في قائمة انتظار، فالطلب ينجح أو يُرفض فورًا. سمِّ product_type (virtualMachine أو volume أو ipAddress أو service أو network) وproduct_id وpayment_plan_id؛ ويأخذ سطر الخدمة أيضًا for_cart_item_id أو for_subscription_id لتسمية الجهاز الذي يخصّه، وquantity (لا تقبل أكثر من واحدة إلا خدمة مُحتسَبة بالوحدة؛ وكل منتج آخر يُضاف وحدة واحدة في كل مرة — رفعها بعد ذلك عبر POST /admin/carts/{cart}/lines/{cartItem}).

يُرفض بـ 422: إن لم يكن المنتج موجودًا أو غير منشور (أو سطر جهاز افتراضي مُمتَنع ما دامت قدرة طبقة اللقطة غير معروفة)، أو كانت الخطة ليست خطة هذا المنتج، أو خدمة بلا جهاز مُسمًّى، أو خدمة مُشتراة مرة لذلك الجهاز أصلًا، أو خدمة بفترة فوترة مختلفة عن جهازها، أو خدمة تدريب الشراكة دون طلب مقبول، أو حساب محظور من المتجر، أو سلة ضيف أو واجهة برمجة (لا شيء هنا يُعدِّل أيًّا منهما)، أو أن هذه ليست سلة العميل الحالية، أو أن السلة بدأت الدفع فعلًا (فاتورة مُدرجة عليها).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.

جسم الطلب مطلوب

الحقل النوع الوصف
product_type مطلوب string
product_id مطلوب integer
payment_plan_id مطلوب integer
for_cart_item_id اختياري integer
for_subscription_id اختياري integer
quantity اختياري integer للخدمات المُحتسَبة بالوحدة فقط؛ وكل منتج آخر وحدة واحدة في كل مرة.

الاستجابات

  • 201 أُضيف السطر.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/carts/1/lines' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "product_type": "virtualMachine",
    "product_id": 1,
    "payment_plan_id": 1
}'
POST /admin/carts/{cart}/lines/{cartItem} #

تحديد عدد وحدات سطر في سلة

admin:write api.read api.privileged

يضبط عدد وحدات السطر على القيمة المُعطاة، من 1 إلى 100، ويجيب بـ 200 مع القيمة السابقة والجديدة. مباشر. الصفر ليس عددًا هنا — أزل السطر بدلًا من ذلك. لا يحمل أي سطر أكثر من 100 وحدة، وهو حدّ عدّاد الكمية في سلة منطقة الإدارة نفسها. يُرفض بـ 422: عدد أقل من واحد أو أكثر من 100، أو سطر اسم نطاق (لا عدد له)، أو زيادة العدد في حساب محظور من المتجر، أو سلة ضيف أو سلة طلب عبر واجهة البرمجة أو ليست سلة العميل الحالية أو بدأت الدفع فعلًا.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.
cartItem مطلوب path integer min 1 معرّف السطر. سطر سلة أخرى يُجيب هنا بـ `404`، كما في صفحة السلة بشاشات الإدارة.

جسم الطلب مطلوب

الحقل النوع الوصف
quantity مطلوب integer

الاستجابات

  • 200 تم ضبط العدد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/carts/1/lines/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 1
}'
POST /admin/carts/{cart}/lines/{cartItem}/move #

نقل سطر خدمة إلى جهاز آخر

admin:write api.read api.privileged

يوجّه سطر الخدمة إلى جهاز آخر من نفس الحساب ويجيب بـ 200 مع هدفه الجديد. مباشر. سمِّ for_cart_item_id (سطر آخر من هذه السلة) أو for_subscription_id (اشتراك منشور بالفعل)؛ وقد يكون كلاهما null لترك الخدمة دون جهاز. يُرفض بـ 422 على سطر ليس خدمة مُشتراة لجهاز، وعلى سلة ضيف أو سلة طلب عبر واجهة البرمجة أو ليست سلة العميل الحالية أو بدأت الدفع فعلًا.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.
cartItem مطلوب path integer min 1 معرّف السطر. سطر سلة أخرى يُجيب هنا بـ `404`، كما في صفحة السلة بشاشات الإدارة.

جسم الطلب مطلوب

الحقل النوع الوصف
for_cart_item_id اختياري integer
for_subscription_id اختياري integer

الاستجابات

  • 200 نُقل سطر الخدمة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/carts/1/lines/1/move' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "for_cart_item_id": 1,
    "for_subscription_id": 1
}'
POST /admin/carts/{cart}/lines/{cartItem}/remove #

إزالة سطر من سلة

admin:write api.read api.privileged

يُزيل السطر من السلة ويجيب بـ 200 مع المعرّف المُزال، وإن كان السطر جهازًا، أسماء كل خدمة اشتُريت له وذهبت معه. مباشر، بلا جسم. يُرفض بـ 422 على سلة ضيف أو سلة طلب عبر واجهة البرمجة أو ليست سلة العميل الحالية أو بدأت الدفع فعلًا.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.
cartItem مطلوب path integer min 1 معرّف السطر. سطر سلة أخرى يُجيب هنا بـ `404`، كما في صفحة السلة بشاشات الإدارة.

الاستجابات

  • 200 أُزيل السطر.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/carts/1/lines/1/remove' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/carts/{cart}/coupon #

طلب ضبط قسيمة سلة أو إزالتها

admin:write api.read api.privileged

يُدرج وضع قسيمة موجودة على السلة، أو إزالة قسيمة السلة، في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. أرسل coupon_id: معرّف لوضع تلك القسيمة على السلة (فتحلّ محلّ أي قسيمة موجودة عليها)، أو null لإزالة قسيمة السلة. وتُشغّل الموافقة باب منطقة الإدارة نفسه، لعميل السلة: قواعد استعمال القسيمة (الصلاحية، وقاعدة القسيمة الخاصة مقارَنةً بهذا العميل، وحدود الاستعمال، وقسيمة لا تنطبق على شيء في السلة)، تُفحص مجدَّدًا تمامًا كما عند الإدراج. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — على سلة ضيف أو سلة طلب عبر واجهة البرمجة، أو ليست سلة العميل الحالية، أو سلة بدأت الدفع فعلًا (فالتعديل سيسحب الفاتورة المُدرجة)، أو إن كانت القسيمة على السلة أصلًا، أو في طلب الإزالة إن لم تحمل السلة قسيمة أصلًا، وما دام تغيير قسيمة آخر على السلة نفسها منتظرًا. ولا يُحصَّل أي شيء عند الموافقة؛ يدفع العميل عند الدفع كما هو. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction}.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.

جسم الطلب مطلوب

الحقل النوع الوصف
coupon_id مطلوب integer معرّف قسيمة، أو `null` لإزالة قسيمة السلة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/carts/1/coupon' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "coupon_id": 1
}'
POST /admin/carts/{cart}/partner-code #

طلب ضبط رمز شريك لسلة أو مسحه

admin:write api.read api.privileged

يُدرج ضبط رمز شريك على السلة، أو مسحه، في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. أرسل code: رمز شريك، أو null لمسحه. وهذا يغيّر الوضع لا السعر: على سلة لها عميل بالفعل، تَربط الموافقة ذلك الحساب بالشريك المُسمّى كرابط من الموظفين (فتحلّ محلّ أي شريك حالي)، ومن ثمّ يتقاضى الشريك حصة من إنفاق الحساب — لا يُعاد تسعير شيء في السلة، ويدفع العميل سعر القائمة كما هو؛ والمسح بدلًا من ذلك يَفصل رابط الحساب. وكلا الفعلين على سلة كهذه يمسح كذلك رمز شريك تحتفظ به السلة بانتظار تسجيل الدخول (رمزًا أُرجئ إليها عند تسجيل دخول في الطريق إلى دعوة مؤسسة)؛ وعلى حساب لا يديره أي شريك يكون مسح ذلك الرمز هو الفعل كله. وعلى سلة ضيف بلا عميل بعد، يُحتفَظ بالرمز (أو بغيابه) فقط، ولا يسري إلا عند تبنّي تسجيل دخول للسلة. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — على سلة طلب عبر واجهة البرمجة، أو رمز غير معروف، أو شريك لا يتقاضى حصة، أو حين يكون الحساب مرتبطًا بالشريك المُسمّى أصلًا، أو حين يكون حساب شريكًا لنفسه، أو حين لا يُدار الحساب بأي شريك ولا تحتفظ سلته برمز بانتظار تسجيل الدخول والطلب يحاول المسح مع ذلك، أو حين لا تحتفظ سلة ضيف بأي رمز والطلب يحاول المسح مع ذلك، وما دام تغيير رمز شريك آخر على السلة نفسها منتظرًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction}.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.

جسم الطلب مطلوب

الحقل النوع الوصف
code مطلوب string رمز شريك، أو `null` لإزالة الشريك.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/carts/1/partner-code' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "string"
}'
POST /admin/carts/{cart}/clear #

طلب حذف سلة

admin:write api.read api.privileged

يُدرج حذف السلة وكل سطر فيها في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. بلا جسم. يُزال اختيار العميل نهائيًا؛ ولا يُحصَّل أو يُسترد أو يُلغى بذلك أي شيء. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — ما دامت فاتورة لا تزال قابلة للدفع تُسوَّى عبر هذه السلة، وعلى سلة طلب عبر واجهة البرمجة (فهي ملك الطلب الذي قدّمها، لا ملك الموظفين)، وما دام حذف آخر لنفس السلة منتظرًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction}.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cart مطلوب path integer min 1 معرّف السلة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/carts/1/clear' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/staff-invitations #

سرد دعوات الموظفين

admin:read api.read api.privileged

دعوات الموظفين في هذا التثبيت، الأحدث أولًا — القائمة نفسها في /admin/settings/staff: العنوان واللغة والدور وصلاحيات التخصص والحالة والموعد النهائي ومن أرسلها. وaccept_url هو الرابط الذي يحمله بريد الدعوة، ولا يُرسل إلا ما دامت الدعوة قابلة للقبول (وفي دعوة تمنح super-admin لا يُرسل إلا إلى مشرف أعلى)، ليُنسخ ويُرسل إلى الشخص مباشرة. وهو بيانات اعتماد: يستطيع أي شخص يملكه قبول الدعوة. وتُصفّى بـ pending وquery (جزء من العنوان). ولا تُسرد دعوات العملاء هنا أبدًا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب كل استدعاء سطر وصول account.pii_read بوصفه قراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
pending اختياري query boolean عند true لا تُسرد إلا الدعوات التي ما زالت بانتظار القبول.
query اختياري query string max length 255 جزء من العنوان المدعو.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من دعوات الموظفين.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/staff-invitations' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/staff-invitations #

طلب دعوة زميل

admin:write api.read api.privileged

يُدرج دعوة موظف في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يرسل شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة تُكتب الدعوة وتُرسل بالبريد عبر إجراء الدعوة في صفحة الموظفين نفسه، باسم المدير الموافق، ويحمل الحقل result.invitation_link في النتيجة الرابط الذي يُنسخ ما دامت الدعوة قابلة للقبول. وrole هو support أو admin (وليس super-admin أبدًا)؛ وpermissions (اختياري، ومع support وحده) صلاحيات تخصص مثل legal.manage (المحامي) أو finance.manage (المحاسب). ويُرفض بـ 422 حين يكون للعنوان حساب دخول أو دعوة، أو حين تكون دعوة له بانتظار الموافقة بالفعل؛ وتُعاد كل الفحوص عند الموافقة. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
email مطلوب string
role مطلوب string
language مطلوب string
permissions اختياري array of string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/staff-invitations' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "string",
    "role": "support",
    "language": "tr-TR"
}'
POST /admin/staff-invitations/{invitation}/resend #

طلب إعادة إرسال دعوة موظف

admin:write api.read api.privileged

يُدرج إعادة إرسال دعوة موظف في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يرسل شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يُرسل البريد مجددًا عبر إجراء إعادة الإرسال في صفحة الموظفين نفسه، ويبقى الرابط صالحًا سبعة أيام أخرى؛ ويُستبدل الرابط المنتهي برابط جديد يحمله الحقل result.invitation_link في النتيجة. ويُرفض بـ 422 لدعوة ما زال رابطها صالحًا، أو قُبلت أو رُفضت، أو لدعوة عميل (تُعامل كأنها غير موجودة)، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لدعوة تمنح super-admin. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
invitation مطلوب path integer min 1 معرّف دعوة الموظف.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/staff-invitations/1/resend' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/staff-invitations/{invitation}/revoke #

طلب سحب دعوة موظف

admin:write api.read api.privileged

يُدرج سحب دعوة موظف في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يحذف إجراء السحب في صفحة الموظفين نفسه الدعوة، فيتوقف رابطها فورًا، ويمكن دعوة العنوان من جديد. ويُرفض بـ 422 لدعوة قُبلت بالفعل، أو لدعوة عميل (تُعامل كأنها غير موجودة)، و— ما لم يكن صاحب الرمز مشرفًا أعلى — لدعوة تمنح super-admin. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
invitation مطلوب path integer min 1 معرّف دعوة الموظف.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/staff-invitations/1/revoke' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/settings #

قراءة إعدادات التثبيت

admin:read api.read api.privileged

كل مفتاح تعدّله صفحات الإعدادات مع قيمته المخزّنة (null تعني غالبًا القيمة الافتراضية المدمجة)، ونسب ضريبة القيمة المضافة، وما إذا كانت كل بيانات اعتماد لبوابة الذكاء الاصطناعي مضبوطة (لا تُعاد البيانات نفسها أبدًا)، وchanged_with: المفاتيح التي يغيّرها باب آخر (وضع الصيانة، هوية البائع، إرشادات المساعدَين) وتلك التي لا تغيّرها إلا صفحة الإعدادات. وهي القراءة نفسها التي تقدّمها get_global_settings على خادم MCP الإداري. لا تسمّي أحدًا، فلا يُكتب سجل وصول.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 الإعدادات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/settings' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/settings #

طلب تغيير في إعدادات التثبيت

admin:write api.read api.privileged

يُدرج تغيير المفاتيح المسمّاة في settings في قائمة انتظار الموافقات (لا يتغيّر إلا ما أُرسل) ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُتحقَّق من الجسم بقواعد نموذج الإعدادات نفسه عند الإدراج ومرة أخرى عند الموافقة؛ وتعرض المعاينة القيمة الحالية والجديدة لكل مفتاح وما يفعله التغيير — وضع اختبار المتجر يضغط كل ساعات المتجر، ومفتاح المحو يفعّل المحو الليلي غير المراقَب، وأي شرط من شروط برنامج الشركاء يُرسل رسالة إلى كل شريك حالي. ويُرفض بـ 422 لمفتاح يغيّره باب آخر (وضع الصيانة، هوية البائع، إرشادات المساعدَين)، ولبيانات اعتماد البوابة وعنوانها (صفحة الإعدادات فقط)، ولتغيير لا يغيّر شيئًا، وما دام تغيير إعدادات آخر منتظرًا. ويُرفض عند الموافقة إن تغيّر في الأثناء أي مفتاح يسمّيه. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
settings مطلوب object

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/settings' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "settings": []
}'
GET /admin/seller-identity #

قراءة هوية البائع

admin:read api.read api.privileged

الشركة المسجّلة والمفوَّض بالتوقيع والعنوان ومكتب الضرائب والرقم الضريبي المطبوعة على كل اتفاقية ترخيص وفاتورة أولية وكشف شريك: stored هو المحفوظ (null تعني أن القيمة الافتراضية المدمجة هي المطبوعة)، وdefaults تلك القيم المدمجة، وprinted ما تحمله المستندات اليوم. وهي القراءة نفسها التي تقدّمها get_seller_details على خادم MCP الإداري. إنها ترويسة التثبيت نفسه، فلا يُكتب سجل وصول.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 هوية البائع.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/seller-identity' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/seller-identity #

طلب تغيير في هوية البائع

admin:write api.read api.privileged

يُدرج تغيير الحقول المرسلة في قائمة انتظار الموافقات (الحقل غير المرسل لا يتغيّر، والنص الفارغ يعيد القيمة الافتراضية المدمجة) ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُتحقَّق منه بقواعد صفحة هوية البائع نفسها. ويُرفض بـ 422 لتغيير لا يغيّر شيئًا وما دام تغيير آخر لهوية البائع منتظرًا؛ ويُرفض عند الموافقة إن تغيّرت الهوية في الأثناء. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
seller_company اختياري string
seller_signatory اختياري string
seller_address اختياري string
seller_tax_office اختياري string
seller_tax_number اختياري string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/seller-identity' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "seller_company": "string",
    "seller_signatory": "string",
    "seller_address": "string",
    "seller_tax_office": "string",
    "seller_tax_number": "string"
}'
GET /admin/ai-gateway/models #

سرد نماذج بوابة الذكاء الاصطناعي وقائمة السماح المخزّنة

admin:read api.read api.privileged

النماذج التي تقدّمها بوابة الذكاء الاصطناعي — sellable (مسعَّرة، فيمكن بيعها للعملاء)، وunsellable (بلا سعر)، وكل اسم في names؛ وتقول priced هل أمكن قراءة الأسعار — وبجانبها قائمة السماح المخزّنة (allowed_models: النماذج التي يمكن للعملاء شراؤها؛ null تعني كل نموذج قابل للبيع) ونموذج المساعد. تُجاب من ذاكرة صفحات الإعدادات المؤقتة لمدة دقيقة؛ وعند غيابها تُسأل البوابة ببيانات الاعتماد المخزّنة. وحين يتعذّر سؤال البوابة تكون available خاطئة وتقول reason السبب (no_credential، refused، unreachable). وتُغيَّر قائمة السماح عبر POST /admin/settings. وهي القراءة نفسها التي تقدّمها list_ai_gateway_models على خادم MCP الإداري.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 الكتالوج وقائمة السماح.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/ai-gateway/models' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/roles #

سرد الأدوار

admin:read api.read api.privileged

أدوار هذا التثبيت — القائمة نفسها في /admin/settings/roles: معرّف كل دور واسمه وهل هو محمي (لا يُحذف) وصلاحياته وعدد حسابات الدخول التي تحمله، إضافة إلى مجموعات الصلاحيات التي يمكن منحها لدور. ومع query (جزء من اسم أو عنوان بريد) تُسرد أيضًا حتى 50 حساب دخول مطابقًا بالمعرّف والاسم والبريد والأدوار.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور super-admin أو صلاحية roles.manage، كما في صفحة الأدوار. ويكتب كل استدعاء سطر وصول account.pii_read بوصفه قراءةً عامة.

المعاملات

الاسم الموضع النوع الوصف
query اختياري query string max length 255 جزء من اسم حساب الدخول أو عنوان بريده.

الاستجابات

  • 200 الأدوار ومجموعات الصلاحيات وحسابات الدخول المطابقة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/roles' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/roles #

طلب إنشاء دور

admin:write api.read api.privileged

يُدرج إنشاء دور جديد فارغ باسم name (أحرف صغيرة وأرقام وشرطات، 64 حرفًا على الأكثر، غير مستعمل) في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. والدور الجديد بلا صلاحية ولا عضو؛ ومنحه أيًّا منهما موافقة مستقلة. ويُرفض بـ 422 اسم ترفضه صفحة الأدوار، وعند الموافقة إن أُخذ الاسم في الأثناء. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور super-admin أو صلاحية roles.manage، كما في صفحة الأدوار؛ ويُطلب الشيء نفسه ممن يوافق.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/roles' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /admin/roles/assignments #

طلب استبدال أدوار حساب دخول

admin:write api.read api.privileged

يُدرج استبدال أدوار حساب الدخول المسمّى في الجسم بـ roles — المجموعة الجديدة كلها — في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يكسب الحساب ما تمنحه تلك الأدوار أو يفقده فورًا. ومنح super-admin أو تغيير أدوار حساب يحمله يتطلّب مشرفًا أعلى للإدراج وللموافقة. ويُرفض بـ 422 إن كان الحساب يملك هذه المجموعة تمامًا، أو كان تغيير آخر له منتظرًا، وعند الموافقة إن تغيّرت أدواره في الأثناء. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور super-admin أو صلاحية roles.manage، كما في صفحة الأدوار؛ ويُطلب الشيء نفسه ممن يوافق.

جسم الطلب مطلوب

الحقل النوع الوصف
user_id مطلوب integer
roles مطلوب array of string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/roles/assignments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_id": 1,
    "roles": [
        "string"
    ]
}'
POST /admin/roles/{role} #

طلب استبدال صلاحيات دور

admin:write api.read api.privileged

يُدرج استبدال صلاحيات الدور بـ permissions — المجموعة الجديدة كلها، بأسماء السجل فقط — في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يكسب كل حامل للدور تلك الصلاحيات أو يفقدها فورًا. وتغيير دور super-admin أو منح أي دور roles.manage يتطلّب مشرفًا أعلى للإدراج وللموافقة. ويُرفض بـ 422 إن كان الدور يملك هذه المجموعة تمامًا، أو كان تغيير آخر عليه منتظرًا، وعند الموافقة إن عُدّل في الأثناء. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور super-admin أو صلاحية roles.manage، كما في صفحة الأدوار؛ ويُطلب الشيء نفسه ممن يوافق.

المعاملات

الاسم الموضع النوع الوصف
role مطلوب path integer min 1 معرّف الدور كما تعيده قائمة الأدوار.

جسم الطلب مطلوب

الحقل النوع الوصف
permissions مطلوب array of string

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/roles/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "permissions": [
        "string"
    ]
}'
POST /admin/roles/{role}/delete #

طلب حذف دور

admin:write api.read api.privileged

يُدرج حذف الدور في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يفقد كل حامل للدور ما يمنحه فورًا، ولا يمكن التراجع عن ذلك. ويُرفض بـ 422 الدور المحمي (user وsupport وadmin وsuper-admin)، وكذلك حذف ثانٍ للدور نفسه ما دام أول منتظرًا؛ وعند الموافقة يُرفض إن اكتسب الدور صلاحيات أو أعضاء في الأثناء. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور super-admin أو صلاحية roles.manage، كما في صفحة الأدوار؛ ويُطلب الشيء نفسه ممن يوافق.

المعاملات

الاسم الموضع النوع الوصف
role مطلوب path integer min 1 معرّف الدور كما تعيده قائمة الأدوار.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/roles/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/token-revocation/break-glass #

طلب كسر الزجاج على مفتاح إبطال الرموز لحساب دخول

admin:write api.read api.privileged

يُدرج كسر الزجاج: إيقاف إعداد "إبطال رموز API عند تغيير كلمة المرور" لحساب دخول آخر، دون موافقته ودون رمز — لشخص فقد القناتين اللتين يذهب إليهما رمزه — ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مشرف أعلى على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. وعند الموافقة يُسجَّل في التدقيق بوصفه كسرًا للزجاج. ويُرفض بـ 422 إن كان الإعداد متوقفًا أصلًا، ولحساب دخولك أنت، وما دام كسر آخر للحساب نفسه منتظرًا. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور super-admin (لا صلاحية أبدًا)؛ ويجب أن يكون الموافق مشرفًا أعلى أيضًا، ولا يجوز أن يكون أيّ منهما حساب الدخول المسمّى.

جسم الطلب مطلوب

الحقل النوع الوصف
user_id مطلوب integer

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/token-revocation/break-glass' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_id": 1
}'
GET /admin/domain-prices #

قراءة قائمة أسعار النطاقات

admin:read api.read api.privileged

لكل امتداد: سعر التجزئة العام لدى السجل الذي يبيع به المتجر (التسجيل والتجديد والنقل — بالليرة التركية ودون ضريبة القيمة المضافة التي تُضاف لكل سطر)، وأي تعديل يدوي من الموظفين (وله الأولوية)، وأي تغيير يتجاوز النصف ينتظر موافقة شخص، وأسعار البيع السارية، وتكلفتنا من واجهة السجل (cost.verified بقيمة false يعني أن الواجهة لم تُجب)، وهامش الربح، وهل يُباع الامتداد في المتجر، وهل هو معروض الآن، وهل يُباع لعملاء تركيا فقط. وselling.renewal هو ما يُفوتَر به التجديد: سعر التجديد بالتجزئة، أي سعر القائمة لدى السجل دائمًا، ولا يُعدَّل أبدًا نحو تكلفتنا (قيمة renewal_below_cost بـ true تعني أن سعر التجزئة أقل من تكلفة التجديد لدينا: يُفوتَر التجديد مع ذلك بسعر القائمة ويخسر كل تجديد الفرق، ويُبلَّغ المشرفون مرة واحدة لكل امتداد). وكذلك يُباع التسجيل المدرج بسعر أقل من تكلفتنا بسعر القائمة.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 قائمة أسعار النطاقات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/domain-prices' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/domain-prices #

طلب تعديل يدوي لسعر نطاق

admin:write api.read api.privileged

يُدرج تعديلًا يدويًا لسعر البيع لامتداد واحد إلى خمسين امتدادًا في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. يذكر كل عنصر امتدادًا من القائمة وقيمه registration وrenewal وtransfer بالليرة دون ضريبة القيمة المضافة؛ والقيمة null تُلغي ذلك التعديل. ويُرفض بـ 422 ما دام طلب مماثل آخر منتظرًا؛ ويُرفض عند الموافقة إن تغيّر صف مذكور في الأثناء. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction}.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
items مطلوب array of object

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/domain-prices' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [
        {
            "ending": "string"
        }
    ]
}'
GET /admin/tags #

عرض وسوم المنتجات

admin:read api.read api.privileged

كل وسم منتج مع عدد الحسابات والقوالب التي تحمله. وتشير shop_bypass إلى alpha1، الوسم الذي يستطيع حاملوه الشراء والمتجر مغلق.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 الوسوم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/tags' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/tags #

إنشاء وسم منتج

admin:write api.read api.privileged

يُنشئ الوسم فورًا كما تفعل صفحة الإعدادات ويسجّله في سجل التدقيق. ويُحفظ الاسم بأحرف صغيرة. ويُرفض بـ 422 اسم مستخدم من قبل، وalpha1، وسم تجاوز إغلاق المتجر الذي يُنشأ من منطقة الإدارة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string
description مطلوب string
front_page مطلوب boolean
priority اختياري integer

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tags' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "front_page": true
}'
POST /admin/tags/{tag} #

تعديل وسم منتج

admin:write api.read api.privileged

يعدّل الوسم فورًا ويسجّله في سجل التدقيق. أرسل ما يتغيّر فقط؛ ويبقى الباقي. ويُرفض بـ 422 اسم يحمله وسم آخر، وإعادة التسمية إلى alpha1 أو منه، وهو وسم تجاوز إغلاق المتجر (فإعادة تسميته تغيّر من يستطيع الشراء والمتجر مغلق، فتُجرى من منطقة الإدارة).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
tag مطلوب path integer min 1 معرّف الوسم.

جسم الطلب مطلوب

الحقل النوع الوصف
name اختياري string
description اختياري string
front_page اختياري boolean
priority اختياري integer

الاستجابات

  • 200 الوسم كما حُفظ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tags/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "front_page": true,
    "priority": 1
}'
POST /admin/tags/{tag}/delete #

طلب حذف وسم منتج

admin:write api.read api.privileged

يُدرج حذف الوسم في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغيّر شيئًا: يجب أن يوافق مدير على السجل (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد. ويُرفض بـ 422 — عند الإدراج ثم عند الموافقة — وسم لا يزال يحمله حساب أو قالب، وما دام طلب حذف آخر للوسم نفسه منتظرًا؛ ويُرفض عند الموافقة إن تغيّر الوسم في الأثناء. وتذكر المعاينة صراحةً إن كان الوسم alpha1. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
tag مطلوب path integer min 1 معرّف الوسم.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tags/1/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/exchange-rates #

قراءة جدول أسعار الصرف

admin:read api.read api.privileged

صفوف USD في جدول أسعار البنك المركزي التركي، الأحدث أولًا، مع عدد المدفوعات التي حُوّلت بكل منها، والحالة: العمود الوحيد الذي يُسعَّر به البيع (banknote_selling)، والسعر الساري، ووقت جلبه، ومتى سيجلب التحديث من جديد، وهل لا يزال صف USD إلى USD الذي تحتاجه كل دفعة بالدولار موجودًا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
limit اختياري query integer min 1, max 100 عدد الصفوف، الأحدث أولًا؛ الافتراضي 30 والحد الأقصى 100.

الاستجابات

  • 200 الأسعار والحالة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/exchange-rates' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/exchange-rates/refresh #

جلب أسعار الصرف لليوم

admin:write api.read api.privileged

يجلب أسعار اليوم من البنك المركزي التركي كما يفعل التحديث في صفحة الإعدادات ويضيفها؛ ولا تُعدَّل الصفوف أبدًا ولا يمكن تحديد سعر يدويًا. ولا يُجلب شيء ما دام أحدث سعر عمره أقل من يوم، ولا يُكتب شيء إن تعذّرت قراءة البنك: فتكون refreshed حينها false وتذكر refreshes_after متى سيجلب التحديث من جديد. ويُسجَّل الجلب الذي كتب صفوفًا في سجل التدقيق.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 ما فعله الجلب.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/exchange-rates/refresh' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/blog/posts #

تصفّح منشورات المدوّنة المنشورة

admin:read api.read api.privileged

صفحة من منشورات نظام إدارة المحتوى المنشورة، مع بحث اختياري، ويحمل كل منشور موجود في الصفحة الرئيسية featured: true، ويحمل كل صف الحقول التي يأخذها طلب الإبراز. يسأل نظام إدارة المحتوى: يأتي خطؤه في error، وتكون configured false إن لم يُضبط.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1 رقم الصفحة، يبدأ من 1.
per_page اختياري query integer min 1, max 100 عدد المنشورات في الصفحة، من 1 إلى 100؛ الافتراضي 10.
search اختياري query string نص بحث اختياري.

الاستجابات

  • 200 صفحة من المنشورات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/blog/posts' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/blog/front-page #

عرض المنشورات المبرزة في الصفحة الرئيسية

admin:read api.read api.privileged

منشورات المدوّنة الموجودة في الصفحة الرئيسية، بترتيبها فيها.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 المنشورات المبرزة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/blog/front-page' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/blog/front-page #

وضع منشور مدوّنة في الصفحة الرئيسية

admin:write api.read api.privileged

يضع منشورًا منشورًا في نظام إدارة المحتوى في الصفحة الرئيسية، أو يحدّث لقطة منشور موجود فيها، ويسجّل ذلك في سجل التدقيق. أرسل cms_post_id وحده (من قائمة المنشورات): يُقرأ العنوان والمقتطف والرابط والصورة واللغة والتاريخ من نظام إدارة المحتوى في تلك اللحظة، ويُتجاهل أي حقل آخر في الطلب. ويُرفض الطلب برمز 422 على cms_post_id إذا تعذّر الوصول إلى نظام إدارة المحتوى أو لم يكن المنشور فيه أو لم يُنشر بعد. ويذهب المنشور الجديد إلى آخر الترتيب.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
cms_post_id مطلوب integer

الاستجابات

  • 200 أُبرز؛ وترتيب الصفحة الرئيسية الآن.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/blog/front-page' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "cms_post_id": 1
}'
POST /admin/blog/front-page/arrange #

تحديد ترتيب منشورات الصفحة الرئيسية

admin:write api.read api.privileged

يحدّد ترتيب المنشورات المبرزة من الأول إلى الأخير، كما يفعل السحب في صفحة المدوّنة، ويسجّله في سجل التدقيق. وتحافظ المنشورات غير المسمّاة على ترتيبها النسبي بعد المسمّاة، ويُتجاهل المعرّف غير المبرز.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
cms_post_ids مطلوب array of integer

الاستجابات

  • 200 رُتّب؛ وترتيب الصفحة الرئيسية الآن.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/blog/front-page/arrange' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "cms_post_ids": [
        1
    ]
}'
POST /admin/blog/front-page/{cmsPostId}/unfeature #

إزالة منشور مدوّنة من الصفحة الرئيسية

admin:write api.read api.privileged

يزيل المنشور من الصفحة الرئيسية ويسجّل ذلك في سجل التدقيق؛ ويبقى المنشور في المدوّنة. ويُجاب بـ 404 لمنشور ليس في الصفحة الرئيسية.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
cmsPostId مطلوب path integer min 1 معرّف منشور مبرز في نظام إدارة المحتوى.

الاستجابات

  • 200 أُزيل؛ وترتيب الصفحة الرئيسية الآن.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/blog/front-page/1/unfeature' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/catalogue/translate #

إعداد مسودة ترجمة لنصوص الكتالوج

admin:write api.read api.privileged shop-translate

يُعدّ مسودة ترجمة تركية (tr) أو عربية (ar) لحقل نصي واحد من الكتالوج ويعيدها. لا يُحفظ شيء: المسودة اقتراح يلصقه شخص في نموذج المنتج. وكل مسودة تستهلك رموزًا من بوابة الذكاء الاصطناعي وتُسجَّل في سجل التدقيق على السجل المسمّى. ويُجاب بـ 422 حين يتعذّر إعداد المسودة (البوابة غير مضبوطة أو أخفقت)؛ وبحد أقصى 20 مسودة في الدقيقة لكل مدير.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

جسم الطلب مطلوب

الحقل النوع الوصف
text مطلوب string
target مطلوب string
field مطلوب string
subject_type اختياري string
subject_id اختياري integer

الاستجابات

  • 200 المسودة؛ لم يُحفظ شيء.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/catalogue/translate' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "string",
    "target": "tr",
    "field": "string"
}'
POST /admin/audit-logs/verify #

التحقق من سلسلة التجزئة في سجل التدقيق

admin:write api.read api.privileged

يفحص سلسلة التجزئة المقاومة للعبث في سجل التدقيق ودفتر إعادات الكتابة المعلنة، كما يفعل زر التحقق في صفحة التدقيق، ويعيد الحكم: intact ورمز خروج الفحص وتقريره (وعند الانقطاع، أول صف يحيد وهل تغطيه إعادة كتابة معلنة). ولا يغيّر شيئًا في السجل؛ ويُسجَّل الفحص نفسه.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin وإذن audit.view.

الاستجابات

  • 200 الحكم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/audit-logs/verify' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/tickets/{ticket}/comments #

الرد على تذكرة دعم بصفة الفريق

admin:write api.read api.privileged

يضيف ردًّا من الفريق باسمك — النظير في REST لأداة reply_to_ticket في MCP الإداري، بالخدمة نفسها، فيُبلَّغ العميل ومالك الحساب تمامًا كما في رد من منطقة الإدارة. نص فقط، بحد أقصى 10000 حرف. والتذكرة المحلولة أو المغلقة لا تقبل ردًّا (422). وتُرفض بـ 409 تذكرة أمر عمل لخدمة ما زال عميلها قادرًا على استردادها: فرد الفريق هناك ينهي مهلة استرداده نهائيًا، فاحجز العمل (عبر الموافقة) أولًا، أو ردّ من منطقة الإدارة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer min 1 معرّف التذكرة.

جسم الطلب مطلوب

الحقل النوع الوصف
comment مطلوب string الرد. يقرؤه العميل.

الاستجابات

  • 201 الرد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 أمر عمل لخدمة ما زال العميل قادرًا على استردادها؛ ورد الفريق كان سينهي تلك المهلة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tickets/1/comments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "comment": "string"
}'
POST /admin/tickets/{ticket}/assignment #

إسناد تذكرة دعم إلى وكيل

admin:write api.read api.privileged

يسند التذكرة إلى وكيل دعم بدلًا ممن كان يحملها — النظير في REST لأداة assign_ticket في MCP الإداري ولزر الإسناد في منطقة الإدارة، بالخدمة نفسها. وقيمة level هي view (قارئ) أو manage (الإسناد العامل، وهو الافتراضي). وتُرفض بـ 422 تذكرة الشراكة وكل من ليس من فريق الدعم. ويُسجَّل التسليم في سجل تدقيق التذكرة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer min 1 معرّف التذكرة.

جسم الطلب مطلوب

الحقل النوع الوصف
agent_id مطلوب integer معرّف المستخدم لوكيل الدعم.
level اختياري string ما يجوز للوكيل فعله في التذكرة؛ `manage` افتراضيًا.

الاستجابات

  • 200 الإسناد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tickets/1/assignment' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "agent_id": 1
}'
POST /admin/tickets/{ticket}/close #

طلب إغلاق تذكرة دعم

admin:write api.read api.privileged

يُدرج إغلاق التذكرة في قائمة انتظار الموافقات ويجيب بـ 202. هذا الطلب لا يغلق شيئًا: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد؛ ويُبلَّغ العميل عند الموافقة. وفي تذكرة أمر عمل لخدمة، ينهي الإغلاق أيضًا مهلة الاسترداد الخاصة بالعميل — وتقول المعاينة ذلك حين ينطبق. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة. وتُرفض بـ 422 التذكرة المغلقة أو المدمجة أو الموسومة رسالة مزعجة أصلًا، وبـ 422 أيضًا طلب إغلاق ثانٍ للتذكرة نفسها ما دام الأول بانتظار قرار (ويذكر الخطأ السجل المنتظر).

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer min 1 معرّف التذكرة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tickets/1/close' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/tickets/{ticket}/priority #

تغيير أولوية تذكرة دعم

admin:write api.read api.privileged

يضبط أولوية التذكرة — النظير في REST لأداة set_ticket_priority في MCP الإداري ولقائمة الأولوية في واجهة الإدارة، بالخدمة نفسها وبقاعدة منطقة الإدارة نفسها: 0 بلا، و1 منخفضة، و2 عادية، و3 عالية، و4 حاجبة. فرز داخلي فقط: لا يُبلَّغ العميل. ويُسجَّل في سجل تدقيق التذكرة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer min 1 معرّف التذكرة.

جسم الطلب مطلوب

الحقل النوع الوصف
priority مطلوب integer 0 بلا، و1 منخفضة، و2 عادية، و3 عالية، و4 حاجبة.

الاستجابات

  • 200 الأولوية الآن.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tickets/1/priority' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "priority": 1
}'
POST /admin/tickets/{ticket}/unassign #

سحب تذكرة دعم من وكيلها

admin:write api.read api.privileged

يزيل إسناد التذكرة ويتركها غير مسندة — النظير في REST لأداة unassign_ticket في MCP الإداري ولزر إلغاء الإسناد في واجهة الإدارة، بالخدمة نفسها. وتُترك التذكرة غير المسندة كما هي (unassigned: false). ويُسجَّل التسليم في سجل تدقيق التذكرة؛ ولا يُبلَّغ العميل.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
ticket مطلوب path integer min 1 معرّف التذكرة.

الاستجابات

  • 200 من كان يحمل التذكرة، إن وُجد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/tickets/1/unassign' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/customers/{user}/tickets #

طلب فتح تذكرة باسم عميل

admin:write api.read api.privileged

يُدرج فتح تذكرة دعم نيابةً عن العميل في قائمة انتظار الموافقات ويجيب بـ 202 — النظير في REST لأداة open_customer_ticket في MCP الإداري ولزر التذكرة الجديدة للعميل في واجهة الإدارة. وعند الموافقة تُفتح التذكرة باسم العميل: هو كاتبها، وتظهر في قائمة تذاكره ويُبلَّغ فورًا. وتنطبق قواعد منطقة الإدارة نفسها (title من 3 إلى 255 حرفًا، وbody حتى 10000، وcategory اختياري وافتراضيه general). نص فقط: لا يحمل السجل المنتظر ملفات، فأضفها لاحقًا ردًّا في منطقة الإدارة. ويُرفض حساب الموظف بـ 403، وتذكرة مطابقة بانتظار الموافقة بـ 422.

لا يحدث شيء بهذا الطلب: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد؛ ويُعاد فحص كل ما يعتمد عليه عند الموافقة. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 حساب دخول العميل الذي تُفتح التذكرة باسمه.

جسم الطلب مطلوب

الحقل النوع الوصف
title مطلوب string عنوان التذكرة، من 3 إلى 255 حرفًا.
body مطلوب string رسالة الافتتاح، حتى 10000 حرف.
category اختياري string الفئة؛ `general` إن لم تُمرَّر.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/customers/1/tickets' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "string",
    "body": "string"
}'
GET /admin/partner-setoffs #

سرد مقاصات الشركاء

admin:read api.read api.privileged

ما دفعه مستحق صُرف زيادةً حين رُدّت عملية بيع وراءه أو استُرجعت، ويدين به الشريك — النظير في REST لأداة list_partner_setoffs في MCP الإداري، الأحدث أولًا، مع المبلغ المستحق المطبوع في بطاقة الشريك. وstatus هي outstanding (الافتراضي: ما زال مستحقًا ولم يُشطب) أو all. ولا يقرّر الموظفون إلا في مقاصة شريك انتهت شراكته (partner_in_force بقيمة false)؛ أما الشريك الساري فيستوعبها مستحقه التالي.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب كل استدعاء سطر وصول billing.pii_read (باسم مالك حساب الشريك عند تمرير account_id، وإلا بوصفه قراءةً عامة).

المعاملات

الاسم الموضع النوع الوصف
status اختياري query string one of outstanding, all outstanding (الافتراضي) أو all.
account_id اختياري query integer min 1 حساب شريك واحد.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من المقاصات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/partner-setoffs' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/partner-setoffs/{setoff}/return-request #

طلب تسجيل مطالبة بردّ مقاصة

admin:write api.read api.privileged

يُدرج تسجيل أن شريكًا انتهت شراكته طُولب بردّ مقاصة في قائمة انتظار الموافقات — النظير في REST لأداة request_setoff_return في MCP الإداري ولزر طلب السداد في واجهة الإدارة. وعند الموافقة يُسجَّل الطلب بتاريخه؛ ولا يُحصَّل أي مبلغ ولا يُخصم ولا يُبلَّغ الشريك من هنا. ويُرفض بـ 422 ما دامت الشراكة سارية (فالمستحق التالي يستوعب المقاصة)، ولمقاصة مشطوبة أو بلا مبلغ مستحق، وما دام قرار آخر بشأنها منتظرًا.

لا يحدث شيء بهذا الطلب: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد؛ ويُعاد فحص كل ما يعتمد عليه عند الموافقة. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
setoff مطلوب path integer min 1 المقاصة بمعرّفها كما يسردها `GET /admin/partner-setoffs`.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/partner-setoffs/1/return-request' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/partner-setoffs/{setoff}/write-off #

طلب شطب مقاصة شريك

admin:write api.read api.privileged

يُدرج شطب مقاصة شريك انتهت شراكته مع reason في قائمة انتظار الموافقات — النظير في REST لأداة write_off_setoff في MCP الإداري ولزر الشطب في واجهة الإدارة. وعند الموافقة يُعفى من المبلغ المستحق نهائيًا: لا يستوعبه أي مستحق لاحق ولا يمكن التراجع عنه. ويُرفض بـ 422 ما دامت الشراكة سارية، ولمقاصة مشطوبة أصلًا أو بلا مبلغ مستحق، وما دام قرار آخر بشأنها منتظرًا.

لا يحدث شيء بهذا الطلب: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد؛ ويُعاد فحص كل ما يعتمد عليه عند الموافقة. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
setoff مطلوب path integer min 1 المقاصة بمعرّفها كما يسردها `GET /admin/partner-setoffs`.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string سبب الشطب.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/partner-setoffs/1/write-off' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
GET /admin/partner-statements #

سرد كشوف الشركاء الشهرية

admin:read api.read api.privileged

كل إصدار صادر من كشوف الشركاء، الشهر الأحدث أولًا والإصدار الأحدث أولًا داخل الشهر — النظير في REST لأداة list_partner_statements في MCP الإداري. ويحمل كل صف إجمالياته ولا يحمل سطور العملاء أبدًا (فهي تسمّي حسابات العملاء وتبقى في ملف PDF للكشف في منطقة الإدارة). ويُضيَّق بـ account_id وperiod (YYYY-MM). والإصدار الجديد هو POST /admin/partners/{partner}/statements المعلّق على الموافقة.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin. ويكتب كل استدعاء سطر وصول billing.pii_read (باسم مالك حساب الشريك عند تمرير account_id، وإلا بوصفه قراءةً عامة).

المعاملات

الاسم الموضع النوع الوصف
account_id اختياري query integer min 1 حساب شريك واحد.
period اختياري query string شهر واحد بصيغة YYYY-MM.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الكشوف.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/partner-statements' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /admin/partners/{partner}/statements #

طلب إصدار جديد من كشف الشريك الشهري

admin:write api.read api.privileged

يُدرج إصدار نسخة جديدة من كشف الشريك عن period (YYYY-MM، شهر انتهى) مع reason في قائمة انتظار الموافقات — النظير في REST لأداة regenerate_partner_statement في MCP الإداري ولزر إعادة الإصدار في واجهة الإدارة. وعند الموافقة تُحسب الأرقام كما هي حينها، ويصدر الإصدار إلى جانب الإصدارات الأقدم (دون تعديلها أبدًا) ويُبلَّغ الشريك. وبهذا أيضًا يحصل الشهر الذي لم يُصدره التشغيل المجدول على إصداره الأول. ويُرفض بـ 422 لشهر غير صالح أو لم ينته، أو ما دام إصدار آخر للحساب منتظرًا؛ ويُرفض عند الموافقة إن صدر إصدار في الأثناء.

لا يحدث شيء بهذا الطلب: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد؛ ويُعاد فحص كل ما يعتمد عليه عند الموافقة. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
partner مطلوب path integer min 1 حساب الشريك، بمعرّفه.

جسم الطلب مطلوب

الحقل النوع الوصف
period مطلوب string الشهر بصيغة YYYY-MM، ويجب أن يكون قد انتهى.
reason مطلوب string سبب إعادة إصدار الكشف.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/partners/1/statements' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "period": "string",
    "reason": "string"
}'
POST /admin/partners/{partner}/reapplication #

طلب حظر حساب من إعادة التقدّم إلى برنامج الشركاء أو السماح له

admin:write api.read api.privileged

يُدرج حظر حساب من إعادة التقدّم إلى برنامج الشركاء (blocked: true) أو رفع الحظر (blocked: false) في قائمة انتظار الموافقات — النظير في REST لأداة set_partner_reapplication في MCP الإداري ولمفتاح إعادة التقدّم في واجهة الإدارة. لا يُبلَّغ أحد. ويُرفض بـ 422 إن كان الحساب في الحالة المطلوبة أصلًا أو كان تغيير آخر له منتظرًا.

لا يحدث شيء بهذا الطلب: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد؛ ويُعاد فحص كل ما يعتمد عليه عند الموافقة. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
partner مطلوب path integer min 1 الحساب، بمعرّفه.

جسم الطلب مطلوب

الحقل النوع الوصف
blocked مطلوب boolean true يحظر إعادة التقدّم، وfalse يسمح بها مجددًا.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/partners/1/reapplication' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "blocked": true
}'
POST /admin/referrals/{referral}/refusal #

طلب رفض مكافأة إحالة

admin:write api.read api.privileged

يُدرج رفض مكافأة إحالة في قائمة انتظار الموافقات — النظير في REST لأداة refuse_referral_reward في MCP الإداري ولزر الرفض في قائمة الإحالات في منطقة الإدارة. وعند الموافقة لا يُدفع للمُحيل عن تلك الإحالة؛ ولا يُبلَّغ أحد، ويمكن دفع المكافأة المرفوضة لاحقًا مع ذلك. وreason اختياري. ويُرفض بـ 422 لمكافأة مدفوعة أو مرفوضة أصلًا، وما دام قرار دفع أو رفض للإحالة نفسها منتظرًا.

لا يحدث شيء بهذا الطلب: يجب أن يوافق مدير على السجل في منطقة الإدارة (approval_url)، وتنقضي مهلته بعد 24 ساعة إن لم يفعل أحد؛ ويُعاد فحص كل ما يعتمد عليه عند الموافقة. وتشير الترويسة Location والقيمة staged_action_id إلى GET /admin/staged-actions/{stagedAction} التي تُبلغ بالنتيجة.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
referral مطلوب path integer min 1 الإحالة، بمعرّفها.

جسم الطلب اختياري

الحقل النوع الوصف
reason اختياري string اختياري. سبب رفض المكافأة.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/referrals/1/refusal' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /admin/partner-rebates/{partnerRebate}/document #

إيداع فاتورة الوكالة عن مستحق معلّق

admin:write api.read api.privileged

يودع فاتورة الوكالة عن مستحق معلّق ليس له مستند بعد — النظير في REST لأداة upload_partner_hakedis_document في MCP الإداري ولرفع الموظفين في واجهة الإدارة، بطريق الكتابة نفسه: لفاتورة أرسلها الشريك بالبريد، أو لحساب شريك مُغلق. متعدد الأجزاء (multipart)، بقواعد منطقة الإدارة نفسها: invoice ملف PDF أو صورة JPEG/PNG/WebP حتى 10 ميغابايت، وinvoice_number، وinvoice_date (لا يكون في المستقبل)، وinvoice_gross (الإجمالي المكتوب في المستند). ويُرفض بـ 409 حين يوجد مستند مُودع أصلًا (فاستبداله يحذف نسخة الشريك، ولذلك يبقى في واجهة الإدارة)، ولمستحق مدفوع أو بلا مبلغ يُدفع؛ وبـ 422 حين لا تكون للشريك بيانات مصرفية. لا يُدفع شيء بهذا الطلب: الدفع هو release_partner_rebate المعلّق على الموافقة. ويُبلَّغ المديرون بإيداع المستند.

يتطلّب رمزًا بصلاحية admin:write يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
partnerRebate مطلوب path integer min 1 المستحق المعلّق، بمعرّفه.

الاستجابات

  • 201 المستند مُودع. لم يُدفع شيء.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/admin/partner-rebates/1/document' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/work-queues #

سرد ما ينتظر تدخّل شخص

admin:read api.read api.privileged

كل قائمة انتظار لدى المشغّل — قائمة المحو، وطلبات الخصوصية، والمدفوعات الفاشلة، ومتابعة التحصيل، والموافقات (ما أدرجه MCP الإداري أو واجهة API الإدارية في قائمة الانتظار ولم يبتّ فيه أي مدير بعد)، ومكافآت الإحالة، وطلبات الشراكة ودوراتها التدريبية، وتذاكر الدعم المفتوحة، وطلبات الانضمام، ومستحقات الشركاء المحتجزة، وقائمة عمل الفواتير، وإشعارات الأسعار — مع عدد العناصر المنتظرة ومنذ متى. وتُدرج الأصفار أيضًا بترتيب ثابت، فلا تُقرأ قائمة غائبة على أنها فارغة. أعداد فقط: لا يُذكر اسم أحد، ولذلك لا يُكتب سطر في سجل الوصول. وهي الأرقام نفسها التي تقرؤها لوحة تحكم الإدارة وخادم MCP الإداري. والرقم المالي الوحيد، أي amount في قائمة referrals، كائن Money بالوحدة الفرعية مثل بقية هذه الواجهة — أما نظيره في MCP فيطبع الرقم نفسه عددًا عشريًا عاديًا.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 كل قوائم الانتظار، بما فيها الأصفار.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/work-queues' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/health #

قراءة حالة سلامة التثبيت

admin:read api.read api.privileged

قراءة واحدة لسلامة التثبيت: إصدار التطبيق؛ ومهام قائمة الانتظار الفاشلة (عددها وأحدثها، باسم المهمة وصنف الاستثناء فقط — ولا تُعطى الحمولة أو الرسالة أبدًا، إذ قد تقتبس سجل عميل)؛ وعمق قائمة الانتظار وهل Horizon يعمل؛ وكل أمر مجدول مع وتيرته وموعد تشغيله التالي وآخر إخفاق له خلال 30 يومًا؛ وهل يُسلَّم البريد الإلكتروني (mail: منذ متى يخفق، والسطر الأول من آخر خطأ، وآخر نجاح، وعدد مهام البريد التي فشلت منذ ذلك الحين)؛ وهل يمكن الوصول إلى مسجّل أسماء النطاقات (registrar: مفعّل فقط ما دام بيع أسماء النطاقات مفعّلًا؛ واسم مضيفه، ومنذ متى يخفق، والسطر الأول من آخر خطأ)؛ وترحيلات قاعدة البيانات المعلّقة؛ ومفاتيح الإعداد التي تغيّرت مؤخرًا (دون قيمها أبدًا). يسجّل C2 إخفاقات الأمر المجدول لا نجاحاته، ولذلك لا توجد معلومة عن آخر تشغيل ناجح. وهو التقرير نفسه الذي تعيده أداة get_system_health في خادم MCP الإداري.

يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 تقرير السلامة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/health' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/failed-jobs #

سرد مهام قائمة الانتظار الفاشلة

admin:read api.read api.privileged

مهام قائمة الانتظار الفاشلة — جدول failed_jobs الذي تُسجَّل فيه كل مهمة استنفدت محاولاتها — الأحدث أولًا. يحمل كل صف اسم المهمة المعروض وقائمة انتظارها واتصالها ووقت إخفاقها وعدد محاولاتها والحد الأقصى لها إن سجّلتها الحمولة، وصنف الاستثناء وسطره الأول فقط (مع حجب الأسرار، وبحد أقصى 300 حرف)، ووسوم Horizon (model class:id). ولا تُنشر الحمولة نفسها أبدًا.

وبجانب الصفحة: كل المهام الفاشلة (total)، وما فشل منذ since (total_since)، وعدد ما يطابق المرشِّحات (matched)، والمهام المطابقة مجمّعة حسب اسم المهمة (by_job) وحسب صنف الاستثناء (by_exception). وهو الجواب نفسه الذي تعيده أداة list_failed_jobs في خادم MCP الإداري.

قد تذكر رسالة الاستثناء شخصًا (مستلمًا مرفوضًا)، ولذلك يُسجَّل كل استدعاء في سجل التدقيق بوصفه وصولًا (account.pii_read، بنطاق fleet). يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
since اختياري query string المهام التي فشلت في هذا التاريخ أو الوقت أو بعده فقط.
job اختياري query string max length 200 جزء من اسم المهمة المعروض.
queue اختياري query string max length 100 اسم قائمة الانتظار.
exception اختياري query string max length 200 بداية صنف الاستثناء — أحرف وأرقام وشرطات مائلة عكسية وشرطات سفلية فقط. لا تُطابَق الرسالة أبدًا، وأي قيمة أخرى تُرفض بالرمز 422.

الاستجابات

  • 200 صفحة من المهام الفاشلة مع المجاميع والمجموعات.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/failed-jobs' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/failed-jobs/{failedJob} #

قراءة مهمة واحدة فاشلة من قائمة الانتظار

admin:read api.read api.privileged

مهمة واحدة فاشلة بمعرّفها uuid أو معرّفها الرقمي: كل ما تعرضه القائمة، إضافةً إلى أول 30 سطرًا من الاستثناء (الرسالة والمكدّس، مع حجب الأسرار) وما حملته المهمة — صنف الأمر وكل نموذج احتفظت به، بصنفه ومعرّفه. ولا تُنشر الحمولة نفسها أبدًا. وهو الجواب نفسه الذي تعيده أداة get_failed_job في خادم MCP الإداري.

يُسجَّل في سجل التدقيق بوصفه وصولًا (account.pii_read، بنطاق fleet). يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
failedJob مطلوب path string max length 64 معرّف uuid للمهمة الفاشلة أو معرّفها الرقمي.

الاستجابات

  • 200 المهمة الفاشلة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/failed-jobs/failedJob' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/jobs #

سرد مهام قائمة الانتظار التي يتتبّعها Horizon

admin:read api.read api.privileged

المهام التي يتتبّعها Horizon، الأحدث أولًا، حسب الحالة: recent (الافتراضية — كل ما دُفع ضمن نافذة التقليم في Horizon)، وpending (المنتظرة أو الجارية)، وcompleted، وfailed، وsilenced. تحمل كل مهمة معرّفها في Horizon واسمها وقائمة انتظارها واتصالها وحالتها وعدد محاولاتها ووقت دفعها وحجزها وإكمالها أو إخفاقها، ووسوم Horizon (model class:id)، وهل أُعيدت محاولتها، وللمهمة الفاشلة السطرَ الأول من الاستثناء (مع حجب الأسرار). ولا تُنشر الحمولة أبدًا. وتُطابَق مرشّحات job وqueue وtag ضمن أحدث 1000 مهمة في القائمة المختارة (scanned). ويحتفظ Horizon بها طوال نافذة التقليم فقط (kept_minutes)؛ أما السجل الدائم للإخفاق فهو GET /admin/failed-jobs.

قوائم Horizon محفوظة في redis: إن تعذّر الوصول إليه كان الجواب available: false مع صنف الاستثناء بدل الخطأ. وهو الجواب نفسه الذي تعيده أداة list_jobs في خادم MCP الإداري. وتسمّي وسوم المهمة سجلات العملاء التي حملتها، ولذلك يُسجَّل كل استدعاء بوصفه وصولًا (account.pii_read، بنطاق fleet). يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.
status اختياري query string one of recent, pending, completed, failed, silenced أي قوائم Horizon تُقرأ. الافتراضية recent.
job اختياري query string max length 200 جزء من اسم المهمة.
queue اختياري query string max length 100 اسم قائمة الانتظار.
tag اختياري query string max length 200 وسم مطابق تمامًا تحمله المهمة، مثل صنف نموذج ومعرّفه. يُطابَق مع وسوم كل مهمة ضمن أحدث 1000 مهمة في الحالة المختارة؛ ويبيّن `scanned` عدد ما قُرئ منها.

الاستجابات

  • 200 المهام، أو `available false` عند تعذّر الوصول إلى redis.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/jobs' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /admin/horizon #

قراءة حالة عمّال قائمة الانتظار

admin:read api.read api.privileged

حالة عمّال قائمة الانتظار كما تعرضها لوحة تحكم Horizon: الحالة العامة (running أو paused أو no_workers أو inactive)، وكل مشرف رئيسي ومشرف مع عمليات العمّال لكل قائمة، وطول كل قائمة وزمن الانتظار المتوقع وعملياتها، والمهام في الدقيقة، والإنتاجية ومتوسط زمن التشغيل لكل قائمة، وأعداد Horizon للمهام الحديثة والمعلّقة والمكتملة والفاشلة. وبجانبها recommendations: اقتراحات مستمدّة من هذه الأرقام ومن جدول المهام الفاشلة — قائمة تتأخر، أو غياب العمّال والمهام تنتظر، أو مهمة تفشل مرارًا — يذكر كلٌّ منها ما يستند إليه، وما يُنظر فيه بعد ذلك، وهل يقتصر التصرّف على مشغّل الخادم (owner_side). وهي اقتراحات فقط: لا يُنفَّذ شيء تلقائيًا.

إن تعذّر الوصول إلى redis كان الجواب horizon.available: false. لا يسمّي أحدًا، ولذلك لا يسجّل أي وصول. وهو الجواب نفسه الذي تعيده أداة get_horizon_status في خادم MCP الإداري. يتطلّب رمزًا بصلاحية admin:read يحمل صاحبه دور admin أو super-admin.

الاستجابات

  • 200 حالة Horizon والاقتراحات المستمدّة منها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/admin/horizon' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

العمليات

Support

قراءات محصورة بالإسناد لبيانات عميل واحد، وهي متاحة لرمز يحمل support:read ويحمل مالكه دور support أو super-admin — ومع support:write كل عملية كتابة تتيحها منطقة الدعم على ذلك العميل، كلٌّ منها بمستوى الإسناد manage في مجالها. أما رصيد الحساب فلا يكون إلا طلبًا — يُدرج في قائمة الانتظار ويوافق عليه مدير في /admin/approvals. وتسمّي عملية الكتابة السطور بمعرّفاتها؛ وسطر عميل آخر يجيب بـ 404.

ولا يرى وكيل الدعم سوى العملاء الذين يملك لهم سطرًا في support_assignments، ولا يرى ضمنهم سوى المجالات التي يغطيها مستوى صلاحيته في كل مجال. أما super-admin فيتجاوز الفحصين معًا، تمامًا كما في منطقة الدعم. وتُدقَّق القراءات هنا بالطريقة نفسها المتبعة في منطقة الدعم.

ويقابل GET مستوى الصلاحية view، وتقابل عمليات التعديل المستوى manage — مع استثناء واحد مقصود في منطقة الدعم يجب ألا يُخفَّف أبدًا إن نُقل إلى هنا: فإنشاء جلسة كونسول لجهاز افتراضي محكوم بمستوى manage لا view، لأن الكونسول يعادل السيطرة الكاملة على الجهاز.

GET /support/customers #

سرد العملاء المُسنَدين إلى الموظف المستدعي

support:read api.read

لا يُرجَع إلا العملاء الذين يملك الموظف المستدعي لهم صفًا في support_assignments، مرتَّبين بالاسم، ومع كل واحد منهم خريطة الصلاحيات التي يحملها الموظف عليه. والموظف الذي لا إسناد له يحصل على صفحة فارغة — لا على قائمة العملاء كاملة أبدًا.

أما super-admin فيرى جميع العملاء، مطابقةً لمنطقة الدعم: إذ يتجاوز كلٌّ من User::supportCan() وUser::isAssignedTo() الفحص لهذا الدور، فلا تكون مصفوفة الإسناد قيدًا عليه.

يتطلب هذا المسار رمزًا مميزًا بصلاحية support:read يحمل صاحبه دور support (أو super-admin). ولا تكفي الصلاحية وحدها: فالرمز المميز يبقى بعد الدور الذي كان يحمله صاحبه عند إصداره، ولذلك يُفحص الدور مع كل طلب.

المسار المقابل في منطقة الدعم لا يحمل أي بوّابة — إذ يعيش المرشِّح داخل المتحكّم — ولذلك فإن نقلًا إلى واجهة البرمجة يكتفي بالاستعلام عن «كل العملاء» كان سيسلّم التنصيب بأكمله لأي رمز مميز بصلاحية support:read. تحديد النطاق هنا هو أهمّ خاصية في نقطة النهاية هذه، وتؤكّده الاختبارات في الاتجاهين.

لا يكتب سجلّ تدقيق: فهو لا ينشر عن أي عميل أكثر من اسم وبريد إلكتروني، والقراءات الخاصة بكل عميل بجانبه هي التي تُسجَّل.

المعاملات

الاسم الموضع النوع الوصف
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من العملاء المُسنَدين إلى الموظف.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /support/customers/{user} #

جلب عميل مُسنَد واحد

support:read api.read api.privileged

لوحة تحكم شاملة لعميل مُسنَد واحد: سجلّ العميل، وخريطة الصلاحيات، وأعداد أجهزته الافتراضية وأقراصه ومناطق DNS واشتراكاته وفواتيره وتذاكره، محسوبة من قاعدة البيانات.

البوّابة هنا هي الإسناد وحده — لا أي صلاحية خاصة بمجال — وهذا مطابق لمنطقة الدعم عن قصد. الغرض من هذا السجلّ أن يدلّ موظف الدعم على أين قد تكون مشكلة العميل قبل أن يعرف المجال الذي يبحث فيه؛ ولذلك فإن اشتراط account,view كان سيُعطّل لوحة التحكم على موظف لا يعمل إلا في مجال السحابة. أما المجموعات الخاصة بكل مجال بجانب هذا المسار فيتطلب كلٌّ منها صلاحيته الخاصة.

ولأن البوّابة بهذا الاتساع، فإن البيانات المنشورة هنا أضيق من نظيرتها في واجهة المدير: لا يُنشَر الحقل phone. فموظف الدعم الذي يقرأ إسناده none في المجالات الخمسة جميعها يستطيع الوصول إلى هذا السجلّ، ومنطقة الدعم تعطيه رقم الهاتف فعلًا؛ ويُسمح بأن تكون واجهة البرمجة أشدّ صرامة من منطقة الدعم، لا العكس.

العميل غير المُسنَد إلى الموظف يُجاب بـ 403 لا 404 — إذ تعمل بوّابة الإسناد قبل أن يبحث أي شيء عن السجلّ، وهذا يطابق جواب منطقة الدعم. والمعرّف غير الموجود أصلًا يُجاب بـ 403 للسبب نفسه، وهذا هو الجواب المقصود: فهو يجعل "لا وجود لهذا الحساب" و«ليس من حقك الاطلاع» غير قابلين للتمييز. لا شيء في واجهة الدعم يُرجع 404.

يكتب سجلّ تدقيق account.pii_read تمامًا كما تفعل صفحة الدعم المقابلة، ولهذا السبب يُحتسب على حدّ معدّل طلبات أضيق.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

الاستجابات

  • 200 العميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /support/customers/{user}/instances #

سرد الأجهزة الافتراضية لعميل مُسنَد

support:read api.read api.privileged

مطابقة للنظيرة الإدارية في الحمولة — التمثيل Instance نفسه الذي يعيده مسار /instances الخاص بالعميل — ومطابقة كذلك في طريقة تقديمها: خدمة السحابة في نطاق العميل، وقارئها الذي لا يطابق، ولا صيغة refresh. ولا يختلف سوى مكدس البوابات.

وتتطلب مستوى view على الأقل في مجال cloud من إسناد يغطي هذا العميل. والموظف المُسنَد إلى العميل لكنه يحمل none على cloud يتلقى 403، وكذلك الموظف الذي لا إسناد له أصلًا.

وتكتب سجل تدقيق cloud.pii_read وتُحتسب على ميزانية القراءة المميزة الأضيق.

والمعرّف غير المعروف، أو المعرّف الذي لا يشمله إسناد الموظف، يجيب بـ 403 — إذ تعمل البوابة قبل أن يبحث أي شيء عن السجل، فيبقى «لا وجود لهذا الحساب» و«ليس من حقك رؤيته» غير قابلين للتمييز. ولا شيء في سطح الدعم يعيد 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من الأجهزة الافتراضية للعميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /support/customers/{user}/dns-zones #

سرد مناطق DNS لعميل مُسنَد

support:read api.read api.privileged

مطابقة للنظيرة الإدارية في الحمولة وفي حلّ الخدمة؛ ولا يختلف سوى مكدس البوابات. وتتطلب مستوى view على الأقل في مجال dns من إسناد يغطي هذا العميل.

ولا يوجد معامل refresh: فالنسخة التي تُجري المطابقة تحذف المناطق المحلية — وتتسلسل إلى سجلاتها — التي لم تعد قائمة PowerDNS الحية تتضمنها، قبل الرجوع إلى راية التحديث الخاصة بها.

وتكتب سجل تدقيق dns.pii_read وتُحتسب على ميزانية القراءة المميزة الأضيق.

والمعرّف غير المعروف، أو المعرّف الذي لا يشمله إسناد الموظف، يجيب بـ 403 — إذ تعمل البوابة قبل أن يبحث أي شيء عن السجل، فيبقى «لا وجود لهذا الحساب» و«ليس من حقك رؤيته» غير قابلين للتمييز. ولا شيء في سطح الدعم يعيد 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من مناطق DNS الخاصة بالعميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers/1/dns-zones' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/dns-zones #

إنشاء منطقة DNS لعميل مُسند

support:write api.read api.privileged

باب منطقة الدعم، بخدمة DNS الخاصة بالعميل.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى dns: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string اسم نطاق المنطقة.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/dns-zones' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
GET /support/customers/{user}/subscriptions #

سرد اشتراكات عميل مُسنَد

support:read api.read api.privileged

مطابقة للنظيرة الإدارية في الحمولة وفي حلّ الخدمة؛ ولا يختلف سوى مكدس البوابات. وتتطلب مستوى view على الأقل في مجال billing من إسناد يغطي هذا العميل. والمبالغ دائمًا عدد صحيح بالوحدة الفرعية للعملة مع عملتها، لا عدد عشري أبدًا.

ولا يوجد معامل refresh، وهذه أوضح حالة تبرر غيابها: فالنسخة التي تُجري المطابقة تُنهي الاشتراكات التي انتقل موردها المرتبط، وترفع كل اشتراك معلّق إلى deployed وتمحو سبب فشله، وتحذف اشتراكات الأقراص الجذرية مع دفعاتها، وتُطلق أحداث الموارد اليتيمة التي تتصل بالمزوّد — كل ذلك داخل معاملة واحدة.

وتكتب سجل تدقيق billing.pii_read وتُحتسب على ميزانية القراءة المميزة الأضيق.

والمعرّف غير المعروف، أو المعرّف الذي لا يشمله إسناد الموظف، يجيب بـ 403 — إذ تعمل البوابة قبل أن يبحث أي شيء عن السجل، فيبقى «لا وجود لهذا الحساب» و«ليس من حقك رؤيته» غير قابلين للتمييز. ولا شيء في سطح الدعم يعيد 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من اشتراكات العميل.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /support/customers/{user}/audit-logs #

سرد سجل التدقيق لعميل مُسنَد

support:read api.read api.privileged

السجلات التي يكون صاحب البيانات فيها هذا العميل، الأحدث أولًا، مُرشَّحة إلى المجالات التي يملك فيها موظف الدعم الطالب مستوى view على الأقل.

بوابتان، وكلتاهما مطلوبة: إسناد يغطي هذا العميل، ومستوى view على account — وهو الزوج نفسه الذي تحمله الصفحة المكافئة في منطقة الدعم. والمرشِّح لكل مجال في الداخل هو ما يمنع موظفًا لا يملك سوى التذاكر من قراءة سجلات فوترة ذلك العميل بعد دخوله. والموظف الذي لا يملك view على أي مجال يرى صفر سجل، لا كل السجلات: فقائمة المجالات الفارغة تعني صراحةً «لا مجالات»، لا قيدًا مفقودًا.

ولا مقابل في إسنادات الدعم للمجالات auth وshop وprivacy وpartner وsystem، ولذلك لا تظهر هنا أبدًا مهما كانت صلاحيات الموظف. فطلب صاحب البيانات شأن بين العميل والمسؤول عن المعالجة، والشروط التجارية للشريك شأن بين الشريك والشركة.

ولا تُنشر الحقول changes وcontext وhash وprevious_hash؛ وانظر مخطط AuditLog لمعرفة السبب.

وخلافًا للصفحة المكافئة في منطقة الدعم، تكتب هذه العملية فعلًا سجل account.pii_read خاصًا بها، وتُحتسب على ميزانية القراءة المميزة الأضيق. فكل قراءة موظف في نطاق {user} على هذه الواجهة تترك أثرًا بلا استثناء — فالقاعدة ذات الاستثناء الواحد قاعدة آيلة إلى التعفن، وقراءة تاريخ التدقيق الكامل لشخص ما ليست الوصول الذي يُترك بلا تسجيل. ويعني ذلك أن العميل الذي يتصفح صفحات هذه المجموعة يضيف إليها.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
page اختياري query integer min 1, default 1 رقم الصفحة، ابتداءً من 1.
per_page اختياري query integer min 1, max 100, default 25 عدد العناصر في الصفحة. القيم الأعلى من 100 تُخفَّض إلى 100.

الاستجابات

  • 200 صفحة من سجلات تدقيق العميل، في المجالات التي يجوز للموظف رؤيتها.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers/1/audit-logs' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/actions/start #

تشغيل جهاز افتراضي لعميل مُسند

support:write api.read api.privileged

باب منطقة الدعم نفسه، برمز يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. متكافئة التكرار: تشغيل جهاز يعمل أصلًا يجيب بـ 200 دون أن يُطلب من السحابة شيء. وجهاز يملكه عميل آخر يجيب بـ 404؛ والجهاز الذي يحتجزه طلب استرداد مفتوح يجيب بـ 409؛ والمهمة التي رفضتها السحابة تجيب بـ 502. ويُسجَّل كل استدعاء في سجل التدقيق باسمك منفّذًا والعميلِ موضوعًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer معرّف الجهاز، كما تعرضه `GET /support/customers/{user}/instances`.

الاستجابات

  • 200 الجهاز بعد تشغيله (أو وهو يعمل أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/actions/start' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/actions/stop #

إيقاف جهاز افتراضي لعميل مُسند

support:write api.read api.privileged

باب منطقة الدعم نفسه، برمز يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. متكافئة التكرار: إيقاف جهاز متوقف أصلًا يجيب بـ 200 دون أن يُطلب من السحابة شيء. وجهاز يملكه عميل آخر يجيب بـ 404؛ والمهمة التي رفضتها السحابة تجيب بـ 502. ويُسجَّل كل استدعاء في سجل التدقيق باسمك منفّذًا والعميلِ موضوعًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer معرّف الجهاز، كما تعرضه `GET /support/customers/{user}/instances`.

الاستجابات

  • 200 الجهاز بعد إيقافه (أو وهو متوقف أصلًا).
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/actions/stop' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/actions/restart #

إعادة تشغيل جهاز افتراضي لعميل مُسند

support:write api.read api.privileged

باب منطقة الدعم نفسه، برمز يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. ليست متكافئة التكرار: إعادة التشغيل تصل إلى السحابة دائمًا. وجهاز يملكه عميل آخر يجيب بـ 404؛ والجهاز الذي يحتجزه طلب استرداد مفتوح يجيب بـ 409؛ والمهمة التي رفضتها السحابة تجيب بـ 502. ويُسجَّل كل استدعاء في سجل التدقيق باسمك منفّذًا والعميلِ موضوعًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer معرّف الجهاز، كما تعرضه `GET /support/customers/{user}/instances`.

الاستجابات

  • 200 الجهاز بعد إعادة تشغيله.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/actions/restart' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/credits #

طلب منح رصيد لحساب عميل

support:write api.read api.privileged

يخفض الرصيد الدفعات التالية وينتهي عند انقضاء مدته؛ ولا يكون نقدًا أبدًا.

يُدرَج في قائمة الانتظار: لا يحدث شيء حتى يوافق مدير عليه في /admin/approvals؛ وتنقضي مهلته بعد 24 ساعة. ويجيب بـ 202 مع Location يشير إلى GET /support/staged-actions/{stagedAction}. يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. ورصيد عميل آخر يجيب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
amount_usd مطلوب number المبلغ، رقمًا عشريًا بالدولار.
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث يعرضه حسابه.
expires_at اختياري string تاريخ انتهائه (YYYY-MM-DD)؛ ثلاثة أشهر افتراضيًا.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/credits' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount_usd": 1,
    "reason": "string"
}'
POST /support/customers/{user}/credits/{creditGrant}/actions/adjust #

طلب تخفيض رصيد عميل

support:write api.read api.privileged

لا يُخفَّض إلا حتى ما تبقى؛ ويجب أن يبقى المتبقي وقت الطلب قائمًا عند الموافقة.

يُدرَج في قائمة الانتظار: لا يحدث شيء حتى يوافق مدير عليه في /admin/approvals؛ وتنقضي مهلته بعد 24 ساعة. ويجيب بـ 202 مع Location يشير إلى GET /support/staged-actions/{stagedAction}. يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. ورصيد عميل آخر يجيب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
creditGrant مطلوب path integer min 1 معرّف الرصيد؛ ويجب أن يكون للعميل.

جسم الطلب مطلوب

الحقل النوع الوصف
remaining_usd مطلوب number ما يجب أن يتبقى، رقمًا عشريًا بالدولار.
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث يعرضه حسابه.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/credits/1/actions/adjust' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "remaining_usd": 1,
    "reason": "string"
}'
POST /support/customers/{user}/credits/{creditGrant}/actions/remove #

طلب إزالة رصيد عميل

support:write api.read api.privileged

يُزال ما تبقى؛ ولا يُدفع نقدًا.

يُدرَج في قائمة الانتظار: لا يحدث شيء حتى يوافق مدير عليه في /admin/approvals؛ وتنقضي مهلته بعد 24 ساعة. ويجيب بـ 202 مع Location يشير إلى GET /support/staged-actions/{stagedAction}. يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. ورصيد عميل آخر يجيب بـ 404.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
creditGrant مطلوب path integer min 1 معرّف الرصيد؛ ويجب أن يكون للعميل.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث يعرضه حسابه.

الاستجابات

  • 202 أُدرج في قائمة الانتظار؛ لم يحدث شيء بعد.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/credits/1/actions/remove' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /support/customers/{user}/password #

تعيين كلمة مرور عميل

support:write api.read api.privileged

إعادة التعيين من مكتب المساعدة في منطقة الدعم: تُعيَّن كلمة المرور وتُنهى كل جلسات الدخول الأخرى للعميل.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى account: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
password مطلوب string كلمة المرور الجديدة.
password_confirmation مطلوب string كلمة المرور نفسها مرة أخرى.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/password' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "password": "string",
    "password_confirmation": "string"
}'
GET /support/customers/{user}/instances/{instance}/console #

فتح كونسول على جهاز عميل

support:write api.read api.privileged

عنوان URL لكونسول لمرة واحدة، يمر عبر هذا الموقع كما تقدمه منطقة الدعم، أو url: null. والكونسول يعادل السيطرة الكاملة على الجهاز، ولذلك يطلب صلاحية الكتابة ومستوى manage كباب منطقة الدعم.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وتُسجَّل القراءة باسم العميل.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/console' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /support/customers/{user}/subscriptions/{subscription}/resize-quote #

تسعير تغيير الحجم لعميل

support:read api.read api.privileged

يُسعَّر ولا يُنفَّذ أبدًا — عرض السعر في منطقة الدعم، بالدالة نفسها quoteScale(). والرفض (داخل مهلة الاسترداد، أو منتج مسحوب، …) يكون 409 مع جملته.

يتطلب رمزًا يحمل support:read ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: view. وتُسجَّل القراءة باسم العميل.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.
product_id مطلوب query integer min 1 المنتج المراد التحويل إليه، من النوع نفسه.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/resize-quote' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
GET /support/staged-actions/{stagedAction} #

جلب أحد طلباتك المُدرجة في قائمة الانتظار

support:read api.read

ما آل إليه شيء طلبته عبر هذه الواجهة — منح رصيد أو تخفيضه أو إزالته — بحسب قيمة staged_action_id التي أعادها الطلب. تنتقل status من pending إلى واحدة فقط من approved أو rejected أو expired أو failed، ولا تعود أبدًا. ولا تظهر إلا طلباتك أنت: وطلب موظف آخر يجيب بـ 404. للقراءة فقط: يقرر فيه مدير في منطقة الإدارة.

يتطلب رمزًا يحمل support:read ويحمل صاحبه دور support أو super-admin.

المعاملات

الاسم الموضع النوع الوصف
stagedAction مطلوب path integer min 1 معرّف سجل قائمة الانتظار.

الاستجابات

  • 200 سجل قائمة الانتظار.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X GET 'https://cloud.core.gen.tr/api/v1/support/staged-actions/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/actions/rename #

إعادة تسمية جهاز لعميل مُسند

support:write api.read api.privileged

إعادة التسمية في منطقة الدعم، بخدمة السحابة الخاصة بالعميل.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string الاسم الجديد.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/actions/rename' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/attach #

يربط الجهاز بإحدى شبكات العميل

support:write api.read api.privileged

باب منطقة الدعم، بالجسم المشترك نفسه الذي يستخدمه العميل والمدير؛ ويُوقف الجهاز حيث تحتاج السحابة ذلك.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.
network مطلوب path integer min 1 معرّف الشبكة؛ ويجب أن تعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/networks/1/actions/attach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/detach #

يفصل الجهاز عن الشبكة

support:write api.read api.privileged

باب منطقة الدعم، بالجسم المشترك نفسه الذي يستخدمه العميل والمدير؛ ويُوقف الجهاز حيث تحتاج السحابة ذلك.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.
network مطلوب path integer min 1 معرّف الشبكة؛ ويجب أن تعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/networks/1/actions/detach' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/make-primary #

يجعل الشبكة الشبكة الأساسية للجهاز

support:write api.read api.privileged

باب منطقة الدعم، بالجسم المشترك نفسه الذي يستخدمه العميل والمدير؛ ويُوقف الجهاز حيث تحتاج السحابة ذلك.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.
network مطلوب path integer min 1 معرّف الشبكة؛ ويجب أن تعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/networks/1/actions/make-primary' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/move #

ينقل الجهاز إلى الشبكة من الشبكة المذكورة في `from`

support:write api.read api.privileged

باب منطقة الدعم، بالجسم المشترك نفسه الذي يستخدمه العميل والمدير؛ ويُوقف الجهاز حيث تحتاج السحابة ذلك.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.
network مطلوب path integer min 1 معرّف الشبكة؛ ويجب أن تعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
from مطلوب integer الشبكة التي يُنقل الجهاز منها.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/networks/1/actions/move' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "from": 1
}'
POST /support/customers/{user}/instances/{instance}/networks/{network}/actions/change-ip #

يغيّر عنوان الجهاز على الشبكة

support:write api.read api.privileged

باب منطقة الدعم، بالجسم المشترك نفسه الذي يستخدمه العميل والمدير؛ ويُوقف الجهاز حيث تحتاج السحابة ذلك.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.
network مطلوب path integer min 1 معرّف الشبكة؛ ويجب أن تعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
ip_address مطلوب string العنوان الجديد على تلك الشبكة.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/networks/1/actions/change-ip' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "ip_address": "string"
}'
POST /support/customers/{user}/public-ip-addresses/{publicIPAddress}/networks/{network}/actions/move #

نقل عنوان عام لعميل إلى شبكة أخرى من شبكاته

support:write api.read api.privileged

يُحرَّر العنوان ويُحصل على آخر في الشبكة الهدف؛ ولا يُحصَّل أي مبلغ.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
publicIPAddress مطلوب path integer min 1 معرّف العنوان العام؛ ويجب أن يعود إلى العميل.
network مطلوب path integer min 1 معرّف الشبكة؛ ويجب أن تعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/public-ip-addresses/1/networks/1/actions/move' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/networks/{network}/actions/release #

تحرير شبكة فارغة للعميل

support:write api.read api.privileged

يعيد الشبكة مع العنوان الذي تحجزه. ويُرفض ما دام شيء يستخدمها.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
network مطلوب path integer min 1 معرّف الشبكة؛ ويجب أن تعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/networks/1/actions/release' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/vpn #

تشغيل بوابة VPN لعميل أو إيقافها

support:write api.read api.privileged

على أحد العناوين العامة الخاصة بالعميل.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
public_ip مطلوب string العنوان العام للبوابة.
enable مطلوب boolean تشغيل أو إيقاف.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/vpn' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "public_ip": "string",
    "enable": true
}'
POST /support/customers/{user}/vpn/users #

إنشاء مستخدم VPN للعميل

support:write api.read api.privileged

باب منطقة الدعم، بقرار المالك في 2026-08-29: خدمة VPN العميل هي صلب العمل.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
username مطلوب string اسم الدخول.
password مطلوب string كلمة المرور.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/vpn/users' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "string",
    "password": "string"
}'
POST /support/customers/{user}/vpn/users/{vpnUser}/actions/delete #

حذف أحد مستخدمي VPN للعميل

support:write api.read api.privileged

ومستخدم VPN لحساب آخر يجيب بـ 404.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
vpnUser مطلوب path integer min 1 معرّف مستخدم VPN؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/vpn/users/1/actions/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/volumes/{volume}/snapshots #

أخذ لقطة لوحدة تخزين عميل

support:write api.read api.privileged

تُحتسب ضمن حد اللقطات الخاص بالعميل، كما في منطقة الدعم.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
volume مطلوب path integer min 1 معرّف وحدة التخزين؛ ويجب أن تعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
name اختياري string اسم اختياري.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/volumes/1/snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /support/customers/{user}/volumes/{volume}/snapshots/{snapshot}/actions/delete #

حذف لقطة وحدة تخزين لعميل

support:write api.read api.privileged

وتُرفض النسخة المحتجزة في الاحتفاظ.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
volume مطلوب path integer min 1 معرّف وحدة التخزين؛ ويجب أن تعود إلى العميل.
snapshot مطلوب path integer min 1 معرّف اللقطة؛ ويجب أن تكون نسخة من وحدة التخزين تلك.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/volumes/1/snapshots/1/actions/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/volumes/{volume}/snapshots/{snapshot}/actions/restore #

إنشاء وحدة تخزين جديدة من لقطة عميل

support:write api.read api.privileged

وتُرفض النسخة المحتجزة في الاحتفاظ.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
volume مطلوب path integer min 1 معرّف وحدة التخزين؛ ويجب أن تعود إلى العميل.
snapshot مطلوب path integer min 1 معرّف اللقطة؛ ويجب أن تكون نسخة من وحدة التخزين تلك.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string اسم وحدة التخزين الجديدة.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/volumes/1/snapshots/1/actions/restore' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /support/customers/{user}/volumes/{volume}/snapshot-policies #

ضبط جدول لقطات على وحدة تخزين عميل

support:write api.read api.privileged

تأخذ السحابة النسخ وتحذف الأقدم بعد تجاوز max_snaps.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
volume مطلوب path integer min 1 معرّف وحدة التخزين؛ ويجب أن تعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
interval_type مطلوب string hourly أو daily أو weekly أو monthly.
max_snaps مطلوب integer عدد النسخ التي يُحتفظ بها.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/volumes/1/snapshot-policies' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "interval_type": "string",
    "max_snaps": 1
}'
POST /support/customers/{user}/instances/{instance}/vm-snapshots #

أخذ لقطة لجهاز عميل

support:write api.read api.privileged

ويُرفض ما دامت اللقطات الحية معطَّلة هنا.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string اسم النسخة.
description اختياري string ملاحظة اختيارية.
with_memory اختياري boolean تضمين ذاكرة الجهاز.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/vm-snapshots' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string"
}'
POST /support/customers/{user}/instances/{instance}/vm-snapshots/{vmSnapshot}/actions/delete #

حذف لقطة جهاز لعميل

support:write api.read api.privileged

وتُرفض النسخة المحتجزة في الاحتفاظ.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.
vmSnapshot مطلوب path integer min 1 معرّف لقطة الجهاز؛ ويجب أن تكون نسخة من ذلك الجهاز.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/vm-snapshots/1/actions/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/instances/{instance}/vm-snapshots/{vmSnapshot}/actions/revert #

إرجاع جهاز عميل إلى لقطة

support:write api.read api.privileged

يُفقد كل ما كُتب بعد النسخة. وتُرفض النسخة المحتجزة في الاحتفاظ.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى cloud: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
instance مطلوب path integer min 1 معرّف الجهاز؛ ويجب أن يعود إلى العميل.
vmSnapshot مطلوب path integer min 1 معرّف لقطة الجهاز؛ ويجب أن تكون نسخة من ذلك الجهاز.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/instances/1/vm-snapshots/1/actions/revert' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/dns-zones/{zone}/actions/delete #

حذف منطقة DNS لعميل

support:write api.read api.privileged

تُزال المنطقة وكل سجل فيها.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى dns: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
zone مطلوب path integer min 1 معرّف منطقة DNS؛ ويجب أن تعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/dns-zones/1/actions/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/dns-zones/{zone}/records #

إضافة سجل إلى منطقة عميل

support:write api.read api.privileged

قيمة واحدة؛ وتُحفظ القيم الأخرى بالاسم والنوع نفسيهما.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى dns: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
zone مطلوب path integer min 1 معرّف منطقة DNS؛ ويجب أن تعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string اسم السجل.
type مطلوب string نوع السجل.
data مطلوب string القيمة.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/dns-zones/1/records' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "type": "string",
    "data": "string"
}'
POST /support/customers/{user}/dns-zones/{zone}/records/{record} #

تعديل سجل في منطقة عميل

support:write api.read api.privileged

ويُرفض بـ 422 إن تغيّرت القيمة منذ قراءتها.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى dns: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
zone مطلوب path integer min 1 معرّف منطقة DNS؛ ويجب أن تعود إلى العميل.
record مطلوب path integer min 1 معرّف السجل؛ ويجب أن يكون في تلك المنطقة.

جسم الطلب مطلوب

الحقل النوع الوصف
type مطلوب string نوع السجل.
data مطلوب string القيمة الجديدة.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/dns-zones/1/records/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "string",
    "data": "string"
}'
POST /support/customers/{user}/dns-zones/{zone}/records/{record}/actions/delete #

حذف سجل من منطقة عميل

support:write api.read api.privileged

ويُرفض بـ 422 إن تغيّرت القيمة منذ قراءتها.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى dns: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
zone مطلوب path integer min 1 معرّف منطقة DNS؛ ويجب أن تعود إلى العميل.
record مطلوب path integer min 1 معرّف السجل؛ ويجب أن يكون في تلك المنطقة.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/dns-zones/1/records/1/actions/delete' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/subscriptions/{subscription}/actions/cancel #

إلغاء اشتراك عميل

support:write api.read api.privileged

ينهي العقد كما يفعل زر الإلغاء في منطقة الدعم؛ ورفض الخدمة يجيب بـ 409.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/actions/cancel' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/subscriptions/{subscription}/actions/unstage-resize #

إلغاء تغيير حجم مُجهَّز لعميل

support:write api.read api.privileged

يحذف الفاتورة غير المدفوعة ويستعيد الاشتراك السابق؛ ولا ينقل أي مال؛ ويُرفض تغيير الحجم المدفوع.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/actions/unstage-resize' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/subscriptions/{subscription}/actions/lock #

قفل اشتراك عميل

support:write api.read api.privileged

القفل في منطقة الدعم.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/actions/lock' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/subscriptions/{subscription}/actions/unlock #

فتح قفل اشتراك عميل

support:write api.read api.privileged

فتح القفل في منطقة الدعم.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/actions/unlock' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/subscriptions/{subscription}/actions/lift-suspension #

رفع تعليق عميل

support:write api.read api.privileged

يعيد الخدمة؛ وتبقى الفاتورة مستحقة ولا ينتقل أي مال.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/actions/lift-suspension' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/subscriptions/{subscription}/actions/force-refund #

فرض استرداد خدمة لمرة واحدة لعميل

support:write api.read api.privileged

للخدمات فقط، داخل مهلة الاسترداد المفروض، ولا يشمل المُسلَّمة أبدًا. ويتجاهل حظر الاسترداد على العميل كما يفعل كل استرداد من الفريق. وحين تكون هناك فاتورة صادرة يُفتح بدلًا من ذلك طلب إلغاء فاتورة مفروض (202).

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث يعرضه حسابه.

الاستجابات

  • 200 تم.
  • 202 قُبل؛ ولم يكتمل بعد — راجع الرسالة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/actions/force-refund' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /support/customers/{user}/subscriptions/{subscription}/actions/request-invoice-cancellation #

فتح طلب إلغاء فاتورة لعميل

support:write api.read api.privileged

لشراء يجب إلغاء فاتورته الصادرة قبل استرداده؛ ويُوقف الجهاز فورًا.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
subscription مطلوب path integer min 1 معرّف الاشتراك؛ ويجب أن يعود إلى العميل.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/subscriptions/1/actions/request-invoice-cancellation' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/confirm #

تسجيل تأكيد شركة

support:write api.read api.privileged

يسجّل الفريق أن الشركة وافقت على إلغاء فاتورتها.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
invoiceRefundRequest مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة؛ ويجب أن تكون دفعته للعميل.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث يعرضه حسابه.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/invoice-refund-requests/1/actions/confirm' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/resolve #

إلغاء الفاتورة وإجراء الاسترداد

support:write api.read api.privileged

يجري الفحص المسبق للاسترداد كاملًا أولًا؛ والاسترداد الذي لا يكتمل يجيب بـ 202 ويبقى مستحقًا.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
invoiceRefundRequest مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة؛ ويجب أن تكون دفعته للعميل.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث يعرضه حسابه.

الاستجابات

  • 200 تم.
  • 202 قُبل؛ ولم يكتمل بعد — راجع الرسالة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/invoice-refund-requests/1/actions/resolve' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/retry #

إعادة محاولة استرداد مستحق

support:write api.read api.privileged

لطلب أُلغيت فاتورته وما زال استرداده مستحقًا.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
invoiceRefundRequest مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة؛ ويجب أن تكون دفعته للعميل.

الاستجابات

  • 200 تم.
  • 202 قُبل؛ ولم يكتمل بعد — راجع الرسالة.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.
  • 502 أخفق مستوى التحكّم في البنية التحتية الذي تقوم عليه السحابة في تنفيذ الطلب. في بيئة الإنتاج يكون حقل التفصيل نصًا ثابتًا وغير محدَّد — إذ إن نصوص أخطاء المزوّد نفسها كثيرًا ما تذكر مضيفات داخلية ووحدات pod ومشرفات أنظمة افتراضية. عامِل هذه الحالة على أنها قابلة لإعادة المحاولة لا على أنها خطأ من العميل.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/invoice-refund-requests/1/actions/retry' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/invoice-refund-requests/{invoiceRefundRequest}/actions/decline #

رفض طلب إلغاء فاتورة

support:write api.read api.privileged

تبقى الفاتورة صالحة ويُبلَّغ العميل بالسبب.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
invoiceRefundRequest مطلوب path integer min 1 معرّف طلب إلغاء الفاتورة؛ ويجب أن تكون دفعته للعميل.

جسم الطلب مطلوب

الحقل النوع الوصف
reason مطلوب string السبب — يُسجَّل مع الإجراء ويُعرض على العميل حيث يعرضه حسابه.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/invoice-refund-requests/1/actions/decline' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "reason": "string"
}'
POST /support/customers/{user}/payments/{payment}/chargebacks #

تسجيل رد مبلغ على دفعة عميل

support:write api.read api.privileged

يسجّل ما استرده البنك.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
payment مطلوب path integer min 1 معرّف الدفعة؛ ويجب أن تكون للعميل.

جسم الطلب مطلوب

الحقل النوع الوصف
amount مطلوب number المبلغ الذي استرده البنك، رقمًا عشريًا بعملة الدفعة نفسها (TL أو USD)، مثل 12.50.
bank_date مطلوب string تاريخ البنك (YYYY-MM-DD)، ولا يكون في المستقبل.
reason مطلوب string سبب البنك.
bank_reference اختياري string مرجع البنك.
note اختياري string ملاحظة من الفريق.
subscription_id اختياري integer سطر الدفعة المعني، إن وُجد.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/payments/1/chargebacks' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 1,
    "bank_date": "string",
    "reason": "string"
}'
POST /support/customers/{user}/billing/bill-notices #

ضبط إرسال إشعارات الفواتير إلى العميل

support:write api.read api.privileged

تتبع default إعداد النظام.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
notify_pending_payments مطلوب string on أو off أو default.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/billing/bill-notices' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "notify_pending_payments": "string"
}'
POST /support/customers/{user}/billing/pay-day #

تعيين اليوم الذي تتجدد فيه اشتراكات العميل

support:write api.read api.privileged

يعيّن يوم الشهر (1–28) الذي تتجدد فيه كل اشتراكات الحساب ويجيب بـ 200 معه؛ وnull يعيد كل اشتراك إلى تاريخ ذكراه السنوية. وتُفوتر الفترة حتى اليوم الجديد بالتناسب عند التجديد التالي لكل اشتراك؛ وتحتفظ الاشتراكات السنوية بشهرها. ولا تتغير أي فاتورة مفتوحة. يسري فورًا ويُسجَّل التغيير في سجل التدقيق.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
day مطلوب integer

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/billing/pay-day' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "day": 1
}'
POST /support/customers/{user}/billing/refunds-block #

حظر استردادات العميل أو السماح بها

support:write api.read api.privileged

يوقف زر الاسترداد الخاص بالعميل، لا استرداد الفريق أبدًا. والسبب مطلوب للحظر ولا يُعرض على العميل أبدًا.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
blocked مطلوب boolean حظر (true) أو سماح (false).
reason اختياري string السبب — مطلوب للحظر.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/billing/refunds-block' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "blocked": true
}'
POST /support/customers/{user}/billing/shop-block #

تعطيل الشراء لعميل أو تفعيله

support:write api.read api.privileged

تستمر الاشتراكات القائمة. والسبب مطلوب للحظر ولا يُعرض على العميل أبدًا.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى billing: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
blocked مطلوب boolean حظر (true) أو سماح (false).
reason اختياري string السبب — مطلوب للحظر.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 409 تباعد المورد المقصود عن حالته لدى المزوّد بصورة لا يستطيع هذا الطلب معالجتها. حدِّث البيانات ثم أعد المحاولة.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/billing/shop-block' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "blocked": true
}'
POST /support/customers/{user}/tickets/{ticket}/comments #

الرد على تذكرة عميل

support:write api.read api.privileged

يُسجَّل باسمك أنت، كما تسجّله منطقة الدعم. والتذكرة المحلولة أو المغلقة لا تقبل ردًّا؛ وتذكرة الشراكة تجيب بـ 404. نص فقط.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى tickets: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
ticket مطلوب path integer min 1 معرّف التذكرة؛ ويجب أن تكون للعميل ومتاحة لك بمستوى manage.

جسم الطلب مطلوب

الحقل النوع الوصف
comment مطلوب string الرد، بحد أقصى 10000 حرف.

الاستجابات

  • 201 أُنشئ.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/tickets/1/comments' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "comment": "string"
}'
POST /support/customers/{user}/tickets/{ticket}/actions/close #

إغلاق تذكرة عميل

support:write api.read api.privileged

يُبلَّغ العميل، كما من منطقة الدعم.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى tickets: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
ticket مطلوب path integer min 1 معرّف التذكرة؛ ويجب أن تكون للعميل ومتاحة لك بمستوى manage.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/tickets/1/actions/close' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'
POST /support/customers/{user}/profile #

تغيير الملف الشخصي لعميل

support:write api.read api.privileged

نموذج الملف الشخصي للفريق؛ ويُحكم على وثيقة الهوية بلغة العميل. ويحتفظ معرّف Telegram والوسوم غير المرسلة بقيمها. ويجب إرسال تاريخ الميلاد ورقم الهوية والهاتف — وغياب أحدها يجيب بـ 422 — والحقل المرسل null يُمحى، كما في نموذج منطقة الدعم.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى account: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
name مطلوب string الاسم الكامل.
birthdate مطلوب string تاريخ الميلاد؛ وقيمة null تمحوه.
identity_number مطلوب string رقم الهوية التركية، أو القيمة البديلة مع جواز السفر؛ وقيمة null تمحوه.
passport_number اختياري string رقم جواز السفر.
phone مطلوب string الهاتف بالصيغة الدولية؛ وقيمة null تمحوه.
language مطلوب string tr-TR أو en-US أو ar-SA.
telegram_user_id اختياري string معرّف Telegram.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/profile' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "birthdate": "string",
    "identity_number": "string",
    "phone": "string",
    "language": "string"
}'
POST /support/customers/{user}/billing-information #

تغيير بيانات الفوترة لعميل

support:write api.read api.privileged

ويُرفض على country تغيير البلد الذي ينقل العملة ما دامت هناك فواتير مفتوحة. ويبقى حساب الشريك مؤسسيًا أيًّا كانت قيمة corporate: فالطلب الذي يتركه بلا اسم شركة ولا رقم ضريبي يُرفض على corporate. وفي غير ذلك يُكتب حقل الشركة غير المرسل فارغًا — وcorporate الغائب أو false فاتورة شخصية.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى account: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.

جسم الطلب مطلوب

الحقل النوع الوصف
corporate اختياري boolean فاتورة مؤسسية. إن غاب أو كان false فهي فاتورة شخصية — إلا في حساب الشريك، الذي يبقى مؤسسيًا أيًّا كانت قيمة هذا الحقل.
company_name اختياري string اسم الشركة.
tax_number اختياري string الرقم الضريبي.
tax_office اختياري string المكتب الضريبي.
trade_registry_office اختياري string مكتب السجل التجاري، أو الجهة التي سجّلت الشركة في الخارج. اختياري، غير أنه لا يمكن حذفه لدى الشريك. وإن غاب بقي كما هو.
trade_registry_number اختياري string رقم السجل التجاري. اختياري، غير أنه لا يمكن حذفه لدى الشريك. وإن غاب بقي كما هو.
address مطلوب string العنوان.
city مطلوب string المدينة.
state اختياري string الولاية أو المقاطعة أو المنطقة — اختيارية. إن غابت بقيت القيمة المحفوظة كما هي، وإن أُرسلت فارغة حُذفت. خارج تركيا يُسجَّل النطاق بالولاية التي تعرفها جهة تسجيل النطاقات لذلك البلد، باسمها أو برمزها.
postal_code مطلوب string الرمز البريدي.
country مطلوب string البلد.
incorporation_country اختياري string بلد التأسيس، بالصيغ نفسها التي يقبلها `country`؛ وإن كان فارغًا فهو بلد الفوترة. وإن غاب بقي كما هو.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/billing-information' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "string",
    "city": "string",
    "postal_code": "string",
    "country": "string"
}'
POST /support/customers/{user}/members/{member} #

تغيير صلاحيات عضو

support:write api.read api.privileged

المصفوفة كاملة، مفهرسة بمجال الحساب. ولا تتجاوز إسنادك أبدًا؛ ولا يُخفَّض المالك أبدًا.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى account: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
member مطلوب path integer min 1 أحد مستخدمي حساب العميل.

جسم الطلب مطلوب

الحقل النوع الوصف
capabilities مطلوب object المجال => none أو view أو manage.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/members/1' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "capabilities": []
}'
POST /support/customers/{user}/members/{member}/actions/remove #

إزالة عضو من حساب عميل

support:write api.read api.privileged

لا يمكن إزالة المالك؛ ويجب إخفاء هوية العضو الذي لديه سجلات بدلًا من ذلك.

يتطلب رمزًا يحمل support:write ويحمل صاحبه دور support أو super-admin وإسنادًا لهذا العميل بمستوى account: manage. وسجل عميل آخر يجيب بـ 404. ويُسجَّل في التدقيق باسمك منفّذًا.

المعاملات

الاسم الموضع النوع الوصف
user مطلوب path integer min 1 معرّف المستخدم للعميل المستهدف. سُمّي المعامل `user` لا `customer` عمدًا: بوابة الصلاحية وبوابة الإسناد ووسيط سجل الوصول تقرأه جميعها بهذا الاسم الحرفي، والأخير منها يفشل *مفتوحًا* — أي يتوقف عن كتابة سطر سجل الوصول — لو أُعيدت تسميته.
member مطلوب path integer min 1 أحد مستخدمي حساب العميل.

الاستجابات

  • 200 تم.
  • 401 لم يُقدَّم أي رمز مميز، أو أن الرمز المميز غير صالح أو منتهي الصلاحية.
  • 403 تم التحقق من الهوية، لكن العملية غير مسموح بها — إمّا أن الرمز المميز يفتقر إلى الصلاحية المطلوبة، أو أن سياسةً رفضت الإجراء، أو أن البريد الإلكتروني غير موثَّق، أو أن صلاحية الدعم غير كافية.
  • 404 لا وجود لهذا المورد، أو أنه يخصّ عميلًا آخر. الحالتان غير قابلتين للتمييز عمدًا.
  • 422 لم يجتز جسم الطلب أو سلسلة الاستعلام التحقق من الصحة.
  • 429 طلبات كثيرة جدًا. أعد المحاولة بعد المدة المذكورة في `Retry-After`.

مثال على الطلب

curl -X POST 'https://cloud.core.gen.tr/api/v1/support/customers/1/members/1/actions/remove' \
  -H 'Authorization: Bearer $C2_TOKEN' \
  -H 'Accept: application/json'

ابدأ الآن

أنشئ حسابك في دقائق، وهيّئ بيئتك السحابية الخاصة، وتولَّ زمام الأمور. مع cloud.core.gen.tr، كل شيء أسرع وأكثر أماناً وأبسط.

احجز اجتماعاً

دعنا نساعدك في تنمية أعمالك. احجز اجتماعاً مدته 15 دقيقة الآن.

احجز الآن