📐 チャットスキーマ
スキーマは公開されるチャットリクエストの契約を定義します。各ソースエクスポートには、フィールドレベルの要約と完全なソース定義があります。フィールド表では、Body はエクスポートされたスキーマが宣言する application/json リクエスト本文を意味します。
一覧
| エクスポート | リクエストの場所 | 契約 |
|---|---|---|
channelIdPathParameter | パス | 必須の文字列 channelId。 |
ChatChannelIcon | 該当なし | 保存されるアイコンメタデータ: objectId および MIME type。 |
channelIdQueryParameter | クエリ | 必須の文字列 channelId。 |
chatChannelSchema | 該当なし | 省略可能な name, ownerId, および null 許容の icon。 |
createChatChannelSchema | 本文 | 必須: name および ownerId。省略可能な null 許容アイコン。 |
updateChatChannelSchema | パス、本文 | 必須: channelId。本文では省略可能な name および null 許容の icon。 |
getChatChannelSchema | パス | 必須: channelId。 |
deleteChatChannelSchema | パス | 必須: channelId。 |
findChatChannelsSchema | クエリ | 省略可能: name, ownerId, および 共通ページネーションフィールド。 |
getChannelMessagesSchema | パス、クエリ | 必須: channelId および 省略可能な共通ページネーションフィールド。 |
chatMessageSchema | 該当なし | 省略可能な content, senderId, および title。 |
createChatMessageAttachmentSchema | 本文 | 必須の UUID objectId および 文字列の type。 |
ChatMessageAttachment | 該当なし | 保存される添付ファイルメタデータ: objectId および type。 |
NormalizedChatMessageAttachment | 該当なし | 公開添付ファイル形式: 署名付き url および type。 |
createChatMessageSchema | 本文 | 必須: content, senderId, および channelId。省略可能: title。 |
updateChatMessageSchema | パス、本文 | 必須: messageId。省略可能: content, senderId, および title。 |
getChatMessageSchema | パス | 必須: messageId。 |
deleteChatMessageSchema | パス | 必須: messageId。 |
findChatMessagesSchema | クエリ | 必須: channelId。省略可能: メッセージフィルター および ページネーション。 |
deleteChatMessageAttachmentSchema | パス | 必須: messageId および attachmentId。 |
streamChatMessagesSchema | クエリ | 必須: channelId。 |
chatMessageTemplateSchema | 該当なし | 省略可能な 文字列の content および title。 |
createChatMessageTemplateSchema | 本文 | 必須: content および title。省略可能: organizationId。 |
getChatMessageTemplateSchema | パス | 必須: messageTemplateId。 |
updateChatMessageTemplateSchema | パス、本文 | 必須: テンプレート ID。省略可能: content および title。 |
deleteChatMessageTemplateSchema | パス | 必須: messageTemplateId。 |
findChatMessageTemplatesSchema | クエリ | 共通のページネーションフィールドのみ。 |
findChatMessageTemplatesForOrganizationSchema | パス、クエリ | 必須: organizationId および 共通ページネーションフィールド。 |
chatChannelReadStateSchema | 該当なし | 以下を含む閉じたオブジェクト: identityId および lastReadMessageId フィールド。 |
upsertChatChannelReadStateSchema | パス、本文 | 必須: channelId, identityId, および lastReadMessageId。 |
chatSubscriptionSchema | 該当なし | 以下を含む閉じたサブスクリプションオブジェクト: 承認、チャンネル、権限、時刻、およびアイデンティティフィールド。 |
createChatSubscriptionSchema | 本文 | 必須: channelId および subscribedId。その他のサブスクリプションフィールドは省略可能です。 |
getChatSubscriptionSchema | パス | 必須: subscriptionId。 |
deleteChatSubscriptionSchema | パス | 必須: subscriptionId。 |
findChatSubscriptionsSchema | クエリ | 省略可能: サブスクリプションフィルター および 共通ページネーションフィールド。 |
詳細
channelIdPathParameter
定義
必須の文字列 channelId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | channelId | 文字列。 | はい | — |
ルートでの使用: getChatChannelRoute, updateChatChannelRoute, deleteChatChannelRoute, getChannelMessagesRoute, および upsertChatChannelReadStateRoute。機能での使用: getChannelFeature, updateChannelFeature, deleteChannelFeature, getChannelMessagesFeature, および upsertChatChannelReadStateFeature。完全なソースを表示
ChatChannelIcon
定義
保存されるアイコンメタデータ: objectId および MIME type。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | objectId | 文字列。リクエストスキーマでは UUID 形式が必要です。 | はい | — |
| 該当なし | type | 通常は MIME タイプの文字列。 | はい | — |
ルートでの使用: 対応する JSON Schema は createChatChannelRoute および updateChatChannelRoute。機能での使用: createChannelFeature および updateChannelFeature。完全なソースを表示
channelIdQueryParameter
定義
必須の文字列 channelId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| クエリ | channelId | 文字列。 | はい | — |
ルートでの使用: streamChatMessagesRoute。機能での使用: streamChatMessagesFeature。完全なソースを表示
chatChannelSchema
定義
省略可能な name, ownerId, および null 許容の icon。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | icon | null または閉じた { objectId: UUID string, type: string }。 | いいえ | — |
| 該当なし | name | 文字列。 | いいえ | — |
| 該当なし | ownerId | 文字列。 | いいえ | — |
ルートでの使用: chatChannelSchema は createChatChannelSchema に展開されます。機能での使用: createChannelFeature。更新スキーマでは許可された更新サブセットが複製されます。完全なソースを表示
createChatChannelSchema
定義
必須: name および ownerId。省略可能な null 許容アイコン。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 本文 | name | 文字列。 | はい | — |
| 本文 | ownerId | 文字列。 | はい | — |
| 本文 | icon | null または閉じた { objectId: UUID string, type: string }。 | いいえ | — |
ルートでの使用: createChatChannelRoute (createChannelFeature 経由)。
機能での使用: createChannelFeature完全なソースを表示
updateChatChannelSchema
定義
必須: channelId。本文では省略可能な name および null 許容の icon。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | channelId | 文字列。 | はい | — |
| 本文 | name | 文字列。 | いいえ | — |
| 本文 | icon | null または閉じた { objectId: UUID string, type: string }。 | いいえ | — |
ルートでの使用: updateChatChannelRoute (経由: updateChannelFeature
機能での使用: updateChannelFeature完全なソースを表示
getChatChannelSchema
定義
必須: channelId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | channelId | 文字列。 | はい | — |
ルートでの使用: getChatChannelRoute (経由: getChannelFeature
機能での使用: getChannelFeature完全なソースを表示
deleteChatChannelSchema
定義
必須: channelId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | channelId | 文字列。 | はい | — |
ルートでの使用: deleteChatChannelRoute (経由: deleteChannelFeature
機能での使用: deleteChannelFeature完全なソースを表示
findChatChannelsSchema
定義
省略可能: name, ownerId, および 共通ページネーションフィールド。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| クエリ | name | String filter。 | いいえ | — |
| クエリ | ownerId | String filter。 | いいえ | — |
| クエリ | 共通ページネーションフィールド | 参照: paginationQueryParametersSchema。 | いいえ | — |
ルートでの使用: findChatChannelsRoute (経由: findChannelsFeature
機能での使用: findChannelsFeature完全なソースを表示
getChannelMessagesSchema
定義
必須: channelId および 省略可能な共通ページネーションフィールド。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | channelId | 文字列。 | はい | — |
| クエリ | 共通ページネーションフィールド | 参照: paginationQueryParametersSchema。 | いいえ | — |
ルートでの使用: getChannelMessagesRoute (経由: getChannelMessagesFeature
機能での使用: getChannelMessagesFeature完全なソースを表示
chatMessageSchema
定義
省略可能な content, senderId, および title。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | content | 文字列。 | いいえ | — |
| 該当なし | senderId | 文字列。 | いいえ | — |
| 該当なし | title | 文字列。 | いいえ | — |
ルートでの使用: chatMessageSchema は createChatMessageSchema および updateChatMessageSchema に展開されます。機能での使用: createChatMessageFeature および updateChatMessageFeature。完全なソースを表示
createChatMessageAttachmentSchema
定義
必須の UUID objectId および 文字列の type。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 本文 | objectId | UUID-formatted string。 | はい | — |
| 本文 | type | 文字列。 | はい | — |
ルートでの使用: createChatMessageAttachmentRoute (経由: createChatMessageAttachmentFeature
機能での使用: createChatMessageAttachmentFeature完全なソースを表示
ChatMessageAttachment
定義
保存される添付ファイルメタデータ: objectId および type。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | objectId | 文字列。 | はい | — |
| 該当なし | type | 文字列。 | はい | — |
ルートでの使用: createChatMessageAttachmentRoute persists this shape。message create/get/list/update routes consume it during normalization, および deleteChatMessageAttachmentRoute removes it。機能での使用: createChatMessageAttachmentFeature。完全なソースを表示
NormalizedChatMessageAttachment
定義
公開添付ファイル形式: 署名付き url および type。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | url | 署名付きダウンロード URL 文字列。 | はい | — |
| 該当なし | type | 文字列。 | はい | — |
ルートでの使用: createChatMessageRoute, getChatMessageRoute, findChatMessagesRoute, updateChatMessageRoute, および createChatMessageAttachmentRoute expose this normalized shape。機能での使用: createChatMessageFeature, getChatMessageFeature, findChatMessagesFeature, updateChatMessageFeature, および createChatMessageAttachmentFeature。完全なソースを表示
createChatMessageSchema
定義
必須: content, senderId, および channelId。省略可能: title。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 本文 | content | 文字列。 | はい | — |
| 本文 | senderId | 文字列。 | はい | — |
| 本文 | channelId | 文字列。 | はい | — |
| 本文 | title | 文字列。 | いいえ | — |
ルートでの使用: createChatMessageRoute (経由: createChatMessageFeature
機能での使用: createChatMessageFeature完全なソースを表示
updateChatMessageSchema
定義
必須: messageId。省略可能: content, senderId, および title。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | messageId | 文字列。 | はい | — |
| 本文 | content | 文字列。 | いいえ | — |
| 本文 | senderId | 文字列。 | いいえ | — |
| 本文 | title | 文字列。 | いいえ | — |
ルートでの使用: updateChatMessageRoute (経由: updateChatMessageFeature
機能での使用: updateChatMessageFeature完全なソースを表示
getChatMessageSchema
定義
必須: messageId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | messageId | 文字列。 | はい | — |
ルートでの使用: getChatMessageRoute (経由: getChatMessageFeature
機能での使用: getChatMessageFeature完全なソースを表示
deleteChatMessageSchema
定義
必須: messageId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | messageId | 文字列。 | はい | — |
ルートでの使用: deleteChatMessageRoute (経由: deleteChatMessageFeature
機能での使用: deleteChatMessageFeature完全なソースを表示
findChatMessagesSchema
定義
必須: channelId。省略可能: メッセージフィルター および ページネーション。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| クエリ | channelId | 文字列。 | はい | — |
| クエリ | content | String filter。 | いいえ | — |
| クエリ | senderId | String filter。 | いいえ | — |
| クエリ | title | String filter。 | いいえ | — |
| クエリ | 共通ページネーションフィールド | 参照: paginationQueryParametersSchema。 | いいえ | — |
ルートでの使用: findChatMessagesRoute (経由: findChatMessagesFeature
機能での使用: findChatMessagesFeature完全なソースを表示
deleteChatMessageAttachmentSchema
定義
必須: messageId および attachmentId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | messageId | 文字列。 | はい | — |
| パス | attachmentId | 文字列。 | はい | — |
ルートでの使用: deleteChatMessageAttachmentRoute (経由: deleteChatMessageAttachmentFeature
機能での使用: deleteChatMessageAttachmentFeature完全なソースを表示
streamChatMessagesSchema
定義
必須: channelId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| クエリ | channelId | 文字列。 | はい | — |
ルートでの使用: streamChatMessagesRoute (経由: streamChatMessagesFeature
機能での使用: streamChatMessagesFeature完全なソースを表示
chatMessageTemplateSchema
定義
省略可能な 文字列の content および title。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | content | 文字列。 | いいえ | — |
| 該当なし | title | 文字列。 | いいえ | — |
ルートでの使用: chatMessageTemplateSchema は createChatMessageTemplateSchema および updateChatMessageTemplateSchema に展開されます。機能での使用: createChatMessageTemplateFeature および updateChatMessageTemplateFeature。完全なソースを表示
createChatMessageTemplateSchema
定義
必須: content および title。省略可能: organizationId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 本文 | content | 文字列。 | はい | — |
| 本文 | title | 文字列。 | はい | — |
| 本文 | organizationId | 文字列。 | いいえ | — |
ルートでの使用: createChatMessageTemplateRoute (経由: createChatMessageTemplateFeature
機能での使用: createChatMessageTemplateFeature完全なソースを表示
getChatMessageTemplateSchema
定義
必須: messageTemplateId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | messageTemplateId | 文字列。 | はい | — |
ルートでの使用: getChatMessageTemplateRoute (経由: getChatMessageTemplateFeature
機能での使用: getChatMessageTemplateFeature完全なソースを表示
updateChatMessageTemplateSchema
定義
必須: テンプレート ID。省略可能: content および title。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | messageTemplateId | 文字列。 | はい | — |
| 本文 | content | 文字列。 | いいえ | — |
| 本文 | title | 文字列。 | いいえ | — |
ルートでの使用: updateChatMessageTemplateRoute (経由: updateChatMessageTemplateFeature
機能での使用: updateChatMessageTemplateFeature完全なソースを表示
deleteChatMessageTemplateSchema
定義
必須: messageTemplateId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | messageTemplateId | 文字列。 | はい | — |
ルートでの使用: deleteChatMessageTemplateRoute (経由: deleteChatMessageTemplateFeature
機能での使用: deleteChatMessageTemplateFeature完全なソースを表示
findChatMessageTemplatesSchema
定義
共通のページネーションフィールドのみ。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| クエリ | 共通ページネーションフィールド | 参照: paginationQueryParametersSchema。 | いいえ | — |
ルートでの使用: findChatMessageTemplatesRoute (経由: findChatMessageTemplatesFeature
機能での使用: findChatMessageTemplatesFeature完全なソースを表示
findChatMessageTemplatesForOrganizationSchema
定義
必須: organizationId および 共通ページネーションフィールド。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| クエリ | 共通ページネーションフィールド | 参照: paginationQueryParametersSchema。 | いいえ | — |
| パス | organizationId | 文字列。 | はい | — |
ルートでの使用: findChatMessageTemplatesForOrganizationRoute (経由: findChatMessageTemplatesForOrganizationFeature
機能での使用: findChatMessageTemplatesForOrganizationFeature完全なソースを表示
chatChannelReadStateSchema
定義
以下を含む閉じたオブジェクト: identityId および lastReadMessageId フィールド。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | identityId | 文字列。リクエスト合成により必須になります。 | いいえ | — |
| 該当なし | lastReadMessageId | 文字列。リクエスト合成により必須になります。 | いいえ | — |
ルートでの使用: chatChannelReadStateSchema は upsertChatChannelReadStateSchema に展開されます。機能での使用: upsertChatChannelReadStateFeature。完全なソースを表示
upsertChatChannelReadStateSchema
定義
必須: channelId, identityId, および lastReadMessageId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | channelId | 文字列。 | はい | — |
| 本文 | identityId | 文字列。 | はい | — |
| 本文 | lastReadMessageId | 文字列。 | はい | — |
ルートでの使用: upsertChatChannelReadStateRoute (経由: upsertChatChannelReadStateFeature
機能での使用: upsertChatChannelReadStateFeature完全なソースを表示
chatSubscriptionSchema
定義
以下を含む閉じたサブスクリプションオブジェクト: 承認、チャンネル、権限、時刻、およびアイデンティティフィールド。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 該当なし | approved | Boolean。 | いいえ | — |
| 該当なし | channelId | 文字列。 | いいえ | — |
| 該当なし | permissions | 文字列の配列。 | いいえ | — |
| 該当なし | subscribedAt | 日時形式の文字列。 | いいえ | — |
| 該当なし | subscribedId | 文字列。 | いいえ | — |
ルートでの使用: chatSubscriptionSchema は createChatSubscriptionSchema に展開されます。機能での使用: createChatSubscriptionFeature。完全なソースを表示
createChatSubscriptionSchema
定義
必須: channelId および subscribedId。その他のサブスクリプションフィールドは省略可能です。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| 本文 | approved | Boolean。 | いいえ | — |
| 本文 | channelId | 文字列。 | はい | — |
| 本文 | permissions | 文字列の配列。 | いいえ | — |
| 本文 | subscribedAt | 日時形式の文字列。 | いいえ | — |
| 本文 | subscribedId | 文字列。 | はい | — |
ルートでの使用: createChatSubscriptionRoute (経由: createChatSubscriptionFeature
機能での使用: createChatSubscriptionFeature完全なソースを表示
getChatSubscriptionSchema
定義
必須: subscriptionId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | subscriptionId | 文字列。 | はい | — |
ルートでの使用: getChatSubscriptionRoute (経由: getChatSubscriptionFeature
機能での使用: getChatSubscriptionFeature完全なソースを表示
deleteChatSubscriptionSchema
定義
必須: subscriptionId。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| パス | subscriptionId | 文字列。 | はい | — |
ルートでの使用: deleteChatSubscriptionRoute (経由: deleteChatSubscriptionFeature
機能での使用: deleteChatSubscriptionFeature完全なソースを表示
findChatSubscriptionsSchema
定義
省略可能: サブスクリプションフィルター および 共通ページネーションフィールド。
| 場所 | フィールド | 型 | 必須 | 制約 |
|---|---|---|---|---|
| クエリ | approved | Boolean filter。 | いいえ | — |
| クエリ | channelId | String filter。 | いいえ | — |
| クエリ | subscribedAt | 日時形式の文字列フィルター。 | いいえ | — |
| クエリ | subscribedId | String filter。 | いいえ | — |
| クエリ | 共通ページネーションフィールド | 参照: paginationQueryParametersSchema。 | いいえ | — |
ルートでの使用: findChatSubscriptionsRoute (経由: findChatSubscriptionsFeature
機能での使用: findChatSubscriptionsFeature完全なソースを表示