Lexicon Garden

com.suibari.nagi.drawCard

全肯定カードを1枚引く。my Nagiの通常枠と他ユーザーへのリアクション枠を1日各1回利用できる（JST 4:00 が日付境界）。同じ枠を既に引いている場合は、そのカードをそのまま返す（冪等）。抽選はサーバ側で行う。source=anniversary は抽選ではなく、その日が記念日の人へ未受領ぶんを一括で配る（同じ記念日は1年に1枚）。

Repository @suibari.com did:plc:uixgxpiqf4i63p6rgpu7ytmx namespace authority
Details · procedure
Kindprocedure
Authoritynagi.suibari.com
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

guestToken

string

未サインイン中に同日引いた通常枠を引き継ぐ端末秘密。source=my_nagi のときだけ利用できる。

reactionUri

string · at-uri

source=reaction のとき必須。本人が当日作成した他ユーザー宛てリアクション。

source

string

省略時は後方互換のためmy_nagi。anniversary は記念日カードの受け取りで、抽選枠を消費しない。

  • knownValues: my_nagi | reaction | anniversary

Output

application/json

alreadyDrawn

requiredboolean

true なら本日は既に引き済みで、返しているのはそのカード。

card

requiredunknown

引いたカード（定義 + 所持情報）。botたんコメントは非同期生成なので初回は空。

cards

array

source=anniversary のみ。同日に複数の記念日が重なることがあるので今回受け取ったぶんを全部返す。card はこの先頭と同じ。

itemsunknown

commentPending

boolean

true の間は botたんコメントを生成中。クライアントは getCards で取り直す。

drawStatus

requiredunknown

isNew

boolean

コレクション初登場なら true。既に持っているカードなら false。

source

requiredstring
  • knownValues: my_nagi | reaction | anniversary

Errors

AuthRequired

No description in schema.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • com.suibari.nagi.drawGuestCard

    procedure

    未サインイン端末が今日の全肯定カードを1枚引く。同じ端末秘密・同じ日付では同じカードを返す。JST 4:00 が日付境界。

  • com.suibari.nagi.cardGet

    record

    全肯定カードを引いたことの控え。**権威ではない。** ドローの結果を決めるのは AppView で、このレコードは「引いた」という申告にすぎず、card_draws / card_instances と突き合わせて一致しないものは索引しない。ユーザーの repo に置くのは、リアクションの subject が実在の PDS レコードを要求するため（本人の repo なら通知の宛先もそのまま本人になる）。rkey は "{drawDate}-{source}"、記念日は "{drawDate}-anniv-{slot}"。

  • com.suibari.nagi.getCards

    query

    指定ユーザーの全肯定カードコレクション。未所持のカードも定義だけ返す（コレクション表示のため）。所持状況は公開情報。自分自身を指定したときだけ drawStatus（本日引けるか）を含む。

  • com.suibari.nagi.takeBoardCard

    procedure

    おすそわけボードから、まだ持っていないカードを1枚、Ƶ を払って受け取る。早い者勝ち。AAR はボードに無ければ botたんの分を受け取る。提供者は枚数で重み付けしたランダムで選ばれ、カードに「〜からもらった」が付く。要認証。

  • com.suibari.nagi.getCardBoard

    query

    おすそわけボード。図鑑のカードごとにボードに「ある／ない」と、自分が置ける枚数・取れるかを返す。在庫の枚数と提供者は返さない。AAR はボードに無くても botたんの分が常にあり、その額で並ぶ。Ƶ の残高も返す。はじめて開いたときに Ƶ を1回だけ配る。要認証。