Grant quota directly

POST /api/v1/users/{id}/add-traffic prm_users_add_traffic

Adds bytes and/or seconds to the subscriber's remaining period quota without pricing or charging anything, and drops the hot-path quota cache so the grant applies on the next RADIUS request.

request_id is accepted here for your own tracing but is not enforced, because adding traffic is not naturally idempotent. Two calls add twice. Do not build a retry loop on this endpoint the way you would on deposit.

نظرة سريعة

المصادقة: رمز موظّف أو جلسة
تتطلب صلاحية: prm_users_add_traffic Add traffic
حد المعدل: t_mutate

المعاملات

المعامل	الوصف
`id`مطلوب path · integer	Subscriber id.
`bytes` body · integer	Bytes to add. At least one of bytes or seconds must be present and positive.
`seconds` body · integer	Seconds to add.

الأخطاء

الرمز	متى تُرجَع
`ERR_VALIDATION`400	a negative value, or neither bytes nor seconds supplied
`ERR_NOT_FOUND`404	no such subscriber

الطلب

curl -X POST "$BASE/api/v1/users/{id}/add-traffic" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "bytes": 10737418240,
  "request_id": "7c2a0e91-6d44-4f9b-a1b7-0c5d3e8f2a10"
}'

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

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

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

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