API仕様

認証

ユーザIDの確認、APIキーの取得は設定ページから行えます。

エンドポイント

フォルダアイテム取得 (公開フォルダのみ)

GET https://backend.jmnt34deg.workers.dev/v2/users/[user_id]/folders/[folder_id]/items

指定したフォルダ内のワールドアイテムを取得します。

パラメータ

  • user_id: ユーザーID
  • folder_id: フォルダID

レスポンス例

[ 
	{ 
		"id": 935, 
		"world_id":"wrld_111111-2222-3333-4444-55556666677777",
		"world_name": "world_name", 
		"world_description":"world_description", 
		"world_author_name":"world_author_name", 
		"world_thumbnail_image_url":"world_thumbnail_image_url", 
		"comment": "comment",
		"addition_at": "2025-07-01T12:52:12.000Z", 
		"created_at":"2025-07-01T12:52:12.000Z", 
		"updated_at":"2025-07-01T16:57:48.000Z" 
	} 
]

フォルダアイテム追加

POST https://backend.jmnt34deg.workers.dev/v2/users/[user_id]/folders/[folder_id]/items?api_key=[APIキー]

指定したフォルダにワールドアイテムを追加します。

パラメータ

  • user_id: ユーザーID
  • folder_id: フォルダID
  • api_key: APIキー（クエリパラメータ）

リクエストボディ

{ 
	"world_id":"wrld_111111-2222-3333-4444-55556666677777", 
	"comment":"コメント" 
}

注意事項

  • フォルダIDはフォルダの共有ページから確認できます
  • APIキーは設定ページから取得してください
  • レート制限が適用される場合があります