Claim Referral Endpoint

Changed on

Attribute the (new) caller to a referral code and grant the referee benefits — a 3-day Plus taste + the one-time first-month-¥9 Plus offer. Called by the SPA right after signup when a ?ref= code is present. Idempotent + best-effort; returns {ok, reason?} (never raises).

post/api/referral/claim

Request

  • Base URL: https://api.omicos.cn (the document declares no server; this is the origin it was published from)
  • URL: https://api.omicos.cn/api/referral/claim
  • Auth: none declared

Headers

authorizationstring nullable
x-omicos-devicestring nullable
x-omicos-device-kindstring nullable
x-omicos-device-namestring nullable

Request body

codestring required

Response

Successful Response

object required

Changes

  • ef3006b6f052Revision changes
    • info

      added the new optional header request parameter x-omicos-device

    • info

      added the new optional header request parameter x-omicos-device-kind

    • info

      added the new optional header request parameter x-omicos-device-name