オープン API v1：個人トークンで呼び出す

MCP でできることは、オープン API でもすべてできます。スクリプト、iOS のショートカット、自動化ツールに向いています。まず設定 → API と AI 連携で個人 API トークンを作成してください。

基本

• ベース URL：https://widgetstore.net/widget/api/v1
• 認証：ヘッダー Authorization: Bearer wsp_…
• リクエストボディ：JSON（Content-Type: application/json）
• 日付：YYYY-MM-DD。「今日」は北京時間（UTC+8）で判定します

例：ステータスを更新する

curl -X PUT https://widgetstore.net/widget/api/v1/me/status \
  -H "Authorization: Bearer wsp_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"京都で休暇中、来週戻ります","emoji":"🏖"}'

成功時のレスポンス：

{
  "code": 0,
  "data": { … },
  "summary": "Status set to \"🏖 京都で休暇中、来週戻ります\" on personal page …",
  "links": { "page": "…" },
  "operationId": "…"
}

summary は人が読める短い説明です。変更を行うエンドポイントは、取り消しに使える operationId を返します。

エンドポイント

メソッドとパス	内容	権限
GET /me	スペースの概要：ウィジェット、マイページ、スタートページ、ToDo、テーブル	読み取り
PUT /me/status	ステータス更新：text（140 文字以内）、emoji。clear: true で消去	ステータス
GET /me/widgets?limit=	ウィジェット一覧（埋め込みリンク付き）	読み取り
POST /me/widgets	ウィジェット作成：widget（ID または slug）、values、title、lang	ウィジェット
PATCH /me/widgets/{id}	ウィジェット編集：values（送った項目だけ変更）、title	ウィジェット
POST /me/countdowns	カウントダウン作成：title、date、mode（countdown / anniversary / countup）、repeat	ウィジェット
GET /widget-types?category=&type=&lang=	ライブラリのウィジェットの種類	—
GET /widget-types/search?q=&lang=	説明からウィジェットを検索（設定項目付き）	—
POST /me/startpages/links	スタートページにサイトを追加：url、name、任意で startPage、page	スタートページ
POST /me/page/cards	マイページにカードを追加：type（link / text / title / widget）、url、title、text、size、position	マイページ
POST /me/focus/todos	ToDo を追加：title、due、estimateMinutes、priority	集中
POST /me/focus/habits/{習慣名}/check-in	習慣のチェックイン：date、count、note	集中
POST /me/focus/sessions	集中時間を記録：minutes、task、date、mode	集中
GET /me/tables	マイデータ：テーブル一覧	読み取り
GET /me/tables/{テーブル名または ID}/records?from=&to=&limit=	レコード検索	読み取り
POST /me/tables/{テーブル名または ID}/records	レコード追加：values、date	マイデータ
POST /me/operations/{operationId}/undo	変更を取り消す	—

検索と種類一覧に追加の権限は不要ですが、トークンは必要で、呼び出し回数にも数えます。削除のエンドポイントはありません。

エラー

エラー時は HTTP ステータスが 200 以外になり、{ "code": ステータス, "msg": "エラーコード", … } を返します。

ステータス	コード	意味
400	invalid_json / invalid_params	ボディが JSON でない、または項目が不正（errors に詳細）
400	blocked_words	公開テキストが内容の安全チェックを通らなかった
401	unauthorized / token_invalid / token_expired / token_revoked	トークンがない・不正・期限切れ・無効化済み
403	insufficient_scope	トークンにこの権限がない（required に必要な権限）
403	pro_required	このウィジェットには Pro が必要
404	not_found / widget_not_found / table_not_found / start_page_not_found など	見つからない
409	undo_not_allowed	取り消せない（reason：already_undone / too_old / newer_change / not_undoable）
429	rate_limited / api_daily_limit	1 分または 1 日の上限に達した（retryAfter 秒後に再試行）
503	api_paused	API が一時停止中（メンテナンスや高負荷）

上限

無料版は 1 日 100 回（うち変更 30 回）、1 分 20 回。Pro は 300 回・100 回・1 分 60 回です。MCP と上限を共有します。詳しくはトークンとアクティビティをご覧ください。

従来のエンドポイント

/api/v1/widgets/instances（ウィジェットインスタンスの作成・編集・取得）も個人トークンを受け付けます。POST にはウィジェット権限、GET には読み取り権限が必要で、同じように記録・カウントされます。新しいコードでは上の /me/widgets を使ってください。