POST/bots/{botId}/attachments

Bot で使用するファイルや画像をアップロードするためのアップロード URL とファイル ID を生成する。
生成された URL にファイルをアップロードする。

参考

  • API を利用したコンテンツのアップロード方法は ファイルアップロード / ダウンロード を確認してください。

注意

  • アップロード URL およびファイル ID の有効期限は、コンテンツアップロード API をリクエストしてから 24 時間です。期限内にコンテンツのアップロードを行い、リッチメニュー画像の登録 API やメッセージの送信 API などにご利用ください。
  • 一度コンテンツをアップロードしたアップロード URL で、再度コンテンツをアップロードすることはできません。
  • アップロードできるファイルの最大サイズは、管理者画面 > サービス設定 > サービス > トーク > 一般 > トーク/ファイル管理 の 添付ファイル1個あたりの上限 で指定されているサイズです。
  • アップロードしたファイルの利用方法により、利用できるファイル サイズに別途制限が設けられている場合があります。

Authorization

oauth2

Access Token を指定します。
指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

bot.message
bot

HTTP Request

POSThttps://www.worksapis.com/v1.0/bots/{botId}/attachments

Path Parameters

ParameterTypeDescription
botId integer 

Bot ID


required
example : 2000001
format : int64 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Request Body

PropertyTypeDescription
fileName string 

ファイル名

 

Request Example

example

1{2  "fileName": "ExampleFile.pdf"3}

Response

HTTP 200

OK

PropertyTypeDescription
fileId string 

ファイル ID


required 
uploadUrl string 

ファイルのアップロード先の URL


required 

Response Example

example

1{2  "fileId": "jp1.1628695315008671000.1628781715.0.1000001.0.0.0",3  "uploadUrl": "https://storage.worksmobile.com/k/emsg/r/jp1/1628695775389602000.1628782175.1.1000001.0.0.0/file.pdf"4}