com.suibari.nagi.getChronicle

自分年表。Nagi にやってきた日・botたんと出会った日・記念日カード・「はじめて」の記録・日記から抜いた出来事・そのころのニュースを、1本の時系列で返す。日記と同じく**本人だけが読む**ので、actor が認証した DID と一致しなければ 403(件数も日付も返さない)。

Repository @suibari.com did:plc:uixgxpiqf4i63p6rgpu7ytmx namespace authority
Details · query
Kindquery
Authoritynagi.suibari.com
Indexed

Query

query · GET

Parameters

query string

actor

requiredstring · did

年表の持ち主。認証した DID と一致しなければならない。

cursor

string

次に返す年("2025")。年表は年見出しでまとまるので、ページ境界を見出し境界に一致させている。将来1年の件数が有界でなくなったら、日付とイベントIDの複合カーソルへ移すこと。

lang

string

ニュースの表示言語。en は英訳が揃っているものだけ英語になる。

  • default: "ja"
  • enum: ja | en

limit

integer

互換性のため受理するが適用しない。既読は年単位なので必ずその年の全項目を返す。

  • minimum: 1
  • maximum: 100
  • default: 50

Output

application/json

cursor

string

次の年。これ以上さかのぼれないときは省略する。

hasMore

requiredboolean

items

requiredarray

その年の節目。新しい順。同じ日に複数あるときは kind の固定優先度で決定論的に並ぶ。

itemsunknown

revision

requiredstring

その年の全内容のSHA-256。表示言語や取得順序には依存しない。

  • maxLength: 64

year

requiredinteger
  • minimum: 2020

#readYear

object

Properties

revision

requiredstring
  • maxLength: 64

year

requiredinteger
  • minimum: 2020