kintone APIドキュメント

外部にファイルをアップロードする

目次

外部にファイルをアップロードする

固定リンクがコピーされました

kintoneから外部サービスにファイルをアップロードします。
このAPIを利用すると、クロスドメイン制約を回避して、外部サービスにリクエストを送信できます。

関数

固定リンクがコピーされました

PC／モバイル

kintone.proxy.upload(url, method, headers, data, successCallback, failureCallback)

引数

固定リンクがコピーされました

引数 型 必須 説明
url 文字列 必須 リクエストURL
method 文字列 必須 HTTPメソッド
次のいずれかの値を指定します。
  • POST
  • PUT
headers オブジェクト 必須 リクエストヘッダー
例：
{
  "Content-Type": "application/json"
}
何も指定しない場合は{}を指定してください。
data オブジェクトまたは文字列 必須 リクエストボディ
data.format 文字列 必須 アップロードするファイルのフォーマット
「RAW」のみ指定できます。
data.value Blob型 （File型を含む） 必須 アップロードするファイルのデータ
指定できるデータのサイズは、200MBまでです。
successCallback 関数 省略可 リクエストが完了したときに実行されるコールバック関数
コールバック関数の引数には、次の情報が渡されます。
  • 第1引数：レスポンスボディ（文字列）
  • 第2引数：ステータスコード（数値）
  • 第3引数：レスポンスヘッダー（オブジェクト）
省略すると、kintone.Promiseオブジェクトが返り、レスポンスボディ、ステータスコード、レスポンスヘッダーが格納された配列で解決されます。
kintone.Promiseオブジェクト
failureCallback 関数 省略可 リクエストが失敗した時に実行されるコールバック関数
省略すると、kintone.Promiseオブジェクトが返り、プロキシAPIのレスポンスボディ（文字列）で棄却されます。
kintone.Promiseオブジェクト

戻り値

固定リンクがコピーされました

successCallbackを指定した場合、戻り値はありません。
引数のsuccessCallbackを省略した場合、kintone.Promiseオブジェクトが返ります。
kintone.Promiseオブジェクト

サンプルコード

固定リンクがコピーされました

コールバックを使った記述方法
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

const blob = new Blob(['テストファイルです'], {
  type: 'text/plain',
});
const data = {
  format: 'RAW',
  value: blob
};

kintone.proxy.upload('https://api.example.com', 'POST', {}, data, (body, status, headers) => {
  // success
  console.log(status, JSON.parse(body), headers);
}, (error) => {
  // error
  console.log(error); // proxy APIのレスポンスボディ(文字列)を表示
});
kintone.Promiseオブジェクトを使った記述方法
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

const blob = new Blob(['テストファイルです'], {
  type: 'text/plain',
});
const data = {
  format: 'RAW',
  value: blob
};
try {
  const resp = await kintone.proxy.upload('https://api.example.com', 'POST', {}, data);
  // success
  console.log(resp);
} catch (error) {
  // error
  console.log(error);
}

注意事項

固定リンクがコピーされました

  • 存在しないサーバーをurlに指定した場合、ステータスコード「503」（DNS Cache Missing）のエラーが返ります。
  • IPアドレス制限を設定している場合、このJavaScript APIを使って同一ドメインの別アプリに対しkintone REST APIを実行するには、kintoneのIPアドレスを許可してください。
    IPアドレスの詳細は、次のページを参照してください。
    cybozu.comが使用するドメインとIPアドレス (External link)
    ただし、外部APIを実行するAPIを通じてすべてのkintone環境から自由にアクセスできるようになるため、セキュリティの観点から推奨していません。
  • このAPIを使って外部のAPIを実行しても、実行したAPI先で発行されるべきCookieは、自動で発行されません。
  • HTTPメソッドにPOSTまたはPUTを指定した場合、「Content-Length」と「Transfer-Encoding」ヘッダーは自動で付加されます。
    リクエストするときに明示的に指定すると、エラーが発生します。
  • 利用できる「Content-Type」に制限はありません。

制限事項

固定リンクがコピーされました

  • 実行する外部APIのレスポンスに関する制限は、次のとおりです。
    • レスポンスヘッダーの上限は、100行で、1行あたりの最大長は8,180bytesです。
    • レスポンスボディの上限は10MBです。上限を超えるとエラーになります。
    • レスポンスボディは文字列のみ対応しています。画像などのバイナリデータは取得できません。
  • 自己証明書を使ったサーバーとの通信はできません。
  • 対象のブラウザーは、次のページの内容に準じます。
    動作環境のWebブラウザー (External link)