メインコンテンツまでスキップ

UserPostCommand

ユーザーによる投稿作成を提供するサービスです。

エンドポイント​

サービス: bazbii.post.v1.UserPostCommand
パッケージ: bazbii.post.v1
定義ファイル: packages/proto/bazbii/post/v1/user_post_command.proto

gRPCサービス定義​

service UserPostCommand {
  rpc Create(CreateRequest) returns (CreateResponse);
}

Methods​

Create​

位置情報とテキストを含む新しい投稿を作成します。

リクエスト​

message CreateRequest {
  string h3_hex = 1; // H3セルID（16進数文字列）
  string text = 2;   // 投稿内容（1-280文字）
}

レスポンス​

message CreateResponse {
  string id = 1; // 投稿ID（UUID）
}

バリデーション​

  • h3_hex: 有効なH3セルID（16進数文字列）であること
  • text: 1-280文字

認証​

このAPIは認証が必要です。リクエストにはJWTトークンをgRPCメタデータ（Authorization: Bearer <access_token>）として含める必要があります。

処理フロー​

  1. JWT認証（Gateway）
  2. リクエストバリデーション
  3. ドメインサービス呼び出し
  4. DB保存
  5. ドメインイベント発行
  6. レスポンス返却