Adjust Credits

人工增减积分(amount 正数=加、负数=扣)。

副作用(三处,顺序重要):

  1. 改 MySQL 并写一条 CreditLog(credit_service 内部用 SELECT ... FOR UPDATE 行锁,本身就在事务里,并会 commit);
  2. 清该用户的鉴权缓存 + C 端看板缓存,让前台立刻看到新余额;
  3. 若开启 CREDIT_USE_REDIS,再把增量同步到 Redis 余额。

一致性取舍:第 3 步失败(Redis 不可用)只记异常日志、不抛错——此时 MySQL 已是权威数据,Redis 只是加速层,失败会由后续读路径回源修正; 反过来若抛错会让运营以为"操作失败"而重复操作,造成重复加减。

异常:金额/用户不存在等业务错误被 credit_service 抛成 ValueError, 这里转成 400 返回。

post/admin/users/{user_id}/credits

Request

  • Base URL: https://api.twtapi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.twtapi.com/admin/users/{user_id}/credits
  • Auth: none declared

Path parameters

user_idinteger required

Request body

amountnumber required
descriptionstring

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.