tokens

Issue a Right Token (the verificationCode is returned exactly once)

Issues a digital QR ticket at one of your locations. The response's verificationCode and walletUrl are shown exactly once — hand the walletUrl (QR) to the end user. Omit endTime to apply the location policy's defaultValidityMinutes; after endTime, verification returns expired. 402 when the plan's monthly token limit is exceeded.

post/api/rightos/tokens/issue

Request

Base URL: https://rightos.i-s3.com
URL: https://rightos.i-s3.com/api/rightos/tokens/issue
Auth: one of:
- HTTP bearer
- API key in header x-rightos-key

Request body

locationIdstring required

titlestring required

descriptionstring

startTimestring date-time

endTimestring date-time

Response

Issued

verificationCodestring

Returned exactly once. The server stores only its SHA-256 hash and cannot re-issue it.

walletUrlstring

Right Wallet URL (QR display) to hand to the end user.

Example response

{
  "token": {
    "id": "tok_2f8a1c9d3e4b5a6f7081",
    "title": "順番待ち / Queue ticket"
  },
  "verificationCode": "K7MP-Q2XT9",
  "walletUrl": "/software/rightos/wallet/tok_2f8a.../?code=K7MP-Q2XT9"
}

Changes

No recorded changes to this operation across all 1 revision of this API.