Set the bucket drain order

PUT /api/v1/users/{id}/bucket-order prm_users_buckets

Replaces the subscriber's custom drain order. Every id must be one of their active buckets, except the sentinel 0, which stands for the plan's own main quota and may be placed anywhere in the sequence.

The 0 in that array is meaningful and positional. It is the main plan quota, so stripping non-positive ids as "empty" would silently reorder the drain sequence rather than reject it.

نظرة سريعة

المصادقة: رمز موظّف أو جلسة
تتطلب صلاحية: prm_users_buckets Manage quota buckets
حد المعدل: t_mutate

المعاملات

المعامل	الوصف
`id`مطلوب path · integer	Subscriber id.
`order`مطلوب body · array	Bucket ids in drain order. 0 is the main quota, not a missing value.

الأخطاء

الرمز	متى تُرجَع
`ERR_VALIDATION`400	an id is not one of this subscriber's active buckets, or the array is too long

الطلب

curl -X PUT "$BASE/api/v1/users/{id}/bucket-order" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "order": [331, 0, 402]
}'

‏BASE هو عنوان مؤسستك: نفس العنوان الذي تسجّل الدخول منه.

جرّبه على شبكتك.

50 مشترك لمدة 7 أيام، من غير ما تدفع حاجة.

جرّب ببلاش كلّمنا