API Design

PrintCart API

OpenAPI 3.0 準拠 / RESTful / JSON

Picture-i と Print Gate は同じカート基盤・同じAPIで動作。OpenAPI仕様書が Single Source of Truth。

設計方針

API開発のガイドライン

OpenAPI駆動

仕様書ファーストで開発

RESTful設計

リソース指向のエンドポイント

セキュアバイデザイン

認証・認可を標準装備

エッジ実行

Cloudflare Workersで高速応答

API構成

Picture-i × Print Gate 統合基盤

Picture-i

BtoC コンテンツ販売

  • ガチャ・販売
  • コレクション
  • マイページ

Print Gate

BtoB 入稿管理

  • 原本管理
  • プレビュー承認
  • 発注・出荷

PrintCart API（共通基盤）

カート・決済・注文を統一APIで提供

カート管理決済処理注文管理ユーザー認証

主な特長

共通カート基盤

BtoC / BtoB どちらも同じAPIでカート・決済を処理

OpenAPI仕様書

仕様書からTypeScript型・SDK・ドキュメントを自動生成

JWT認証

Firebase Auth連携でセキュアな認証・認可を実現

データ分離

PII（個人情報）とビジネスデータを適切に分離管理

ヘッドレス設計

どのフロントエンドからも利用可能なAPI設計

バージョン管理

後方互換性を維持しながら段階的に進化

技術スタック

ランタイム

  • Cloudflare Workers（エッジ実行）
  • Hono（軽量Webフレームワーク）
  • TypeScript（型安全）

データストア

  • Cloudflare D1（トランザクションデータ）
  • Cloudflare R2（画像・ファイル）
  • Firebase Firestore（PII）

OpenAPI仕様書がすべての源

API仕様書を Single Source of Truth として、 TypeScript型・SDKs・ドキュメント・バリデーションを自動生成。 開発効率と品質を両立します。