ファイルのアップロード
Space は、アップロードされたすべてのファイルの永続的なストレージとして機能します。アプリケーションがファイルを Space にアップロードすると、添付ファイル ID を受け取ります。次に、この ID を使用してファイルを添付したり、課題やメッセージなどにファイルリンクを追加したりできます。Space は、イメージ、ビデオ、テキスト、バイナリファイルなど、すべての基本的なファイル形式をサポートしています。
ファイルのアップロード
ファイルを Space にアップロードするには、アプリケーションは次のエンドポイントに POST リクエストを送信する必要があります。/uploads?name=<filename>&spaceMediaType=<spaceMediaType>
filename
– (必須) アップロードするファイルの名前。spaceMediaType
– (オプション) アップロードされたファイルの使用コンテキスト。指定すると、Space はチャットメッセージや課題など、意図したコンテキストに適したファイルプレビューを生成します。そうでない場合 (または、指定されたコンテキストがファイルが使用される実際のコンテキストと一致しない場合)、ファイルはプレビューなしでそのまま表示されます。可能な値:issue-image-attachment
– ファイルは号に添付されたイメージです。chat-image-attachment
– ファイルはチャットメッセージに添付されたイメージです。chat-video-attachment
– ファイルはチャットメッセージに添付されたビデオです。
Content-Type
HTTP ヘッダーは必須です。ファイルはリクエスト本文に含めて送信する必要があります。
ベアラートークンの認証が必要です。権限はチェックされないため、承認されたクライアントはファイルを Space にアップロードできます。トークンの取得方法を学ぶ
応答で、アプリケーションは添付ファイル ID を含む
string
を受け取ります。この ID を使用してアップロードされたファイルを参照する方法を学びます
Kotlin Space SDK にはファイルをアップロードするための特定の方法はありません。代わりに、SpaceClient
クラスに組み込まれている ktorClient
を使用して、アップロードエンドポイントに POST リクエストを送信できます。
アップロードされたファイルを参照する
アプリケーションがファイルの添付ファイル ID を取得すると、Space 内のファイルを参照できるようになります。
メッセージへの添付ファイル
メッセージを送信するときは、attachments
フィールドにその ID を指定して、ファイルを添付ファイルとして追加します。Space では、チャットチャネルやチームメンバーだけでなく、課題、ドキュメント、コードレビュー、コメントをサポートするその他のモジュールにもメッセージを送信できることに注意してください。
デフォルトでは、メッセージの添付ファイルはすべて非公開です。これらは、現在のスコープ内のユーザー (たとえば、現在のチャットチャネルのメンバー) のみが使用できます。添付ファイルを公開するには、getPublicUrl
API メソッドを使用します。
課題への添付ファイル
課題を作成するときは、attachments
フィールドに ID を指定してファイルを添付ファイルとして追加します。
既存の課題に添付ファイルを追加することもできます。
ファイルリンク
Markdown をサポートする Space 内のすべての場所で、ファイルの ID を指定してファイルへのリンクを挿入できます。例: 
または [download the file]/d/here_goes_attachment_id
添付ファイルが public の場合、その添付ファイルへのリンクを誰とでも共有できます: https://mycompany.jetbrains.space/d/here_goes_attachment_id
関連ページ:

Space での認証
Space のセキュリティは、アクセストークン、つまり API リクエストの認証に使用されるシークレットに基づいています。Space と通信するには、アプリケーションはまずアクセストークンを取得する必要があります。その後、このトークンを使用してリクエストを Space に送信できます。例:GET https://mycompany.jetbrains.space/api/http/absences Authorization: Bearer <here-goes-access-token&...

同期 API
サンプル Sync API を使用したサンプルアプリケーション、Sync API は、アプリケーションが Space 内の特定のエンティティのすべての変更を確実に追跡できるようにする一連のメソッドです。変更を追跡するために、Sync API は etag (エンティティバージョン) を使用します。このアプローチにより、同期の課題 (バグやネットワークエラーなどによる) が防止され、アプリケーションによって取得されるデータが常に最新であり、Space の最新の変更との一貫性が保証されます。Space...

Web フック
サンプル Space Webhook を使用するサンプルアプリケーション、Webhook を使用すると、アプリケーションは Space のイベントに関する通知を受信できるようになります。イベントがトリガーされると、Space は指定されたアプリケーションエンドポイントに POST リクエストを送信します。リクエストには、イベントの詳細を含む JSON ペイロードが含まれています。Space では、Webhook はアプリケーションの不可欠な部分です。各アプリケーションは、独自の構成済み Webho...