Blog

kintoneのAPIプロキシーでFormデータを送信する方法

Published:September 23, 2023Updated:February 4, 2026Posted over 2 years ago

この記事をシェア:

Stripe APIなど、外部のAPIに対して、JSONではなくFormデータを送信する方法を調べました。

Stripe APIをkintoneのApp Proxyから呼び出す

サンプルとして、Stripe APIを呼び出すラッパー関数を作ります。

async function callStripeAPI<Body = any, Result = any>(
  path: string,
  method: "GET" | "POST" | "PUT" | "DELETE",
  body?: Body
) {
  const apiResult = await new Promise<Result>((resolve, reject) => {
    kintone.plugin.app.proxy(
      PLUGIN_ID,
      `https://api.stripe.com/v1/${path}`,
      method,
      {
        "Content-Type": "application/x-www-form-urlencoded",
        "Authorization": "Bearer sk_test_xxx",
      },
      body || {},
      (response) => {
        const result = JSON.parse(response);
        resolve(result);
      },
      (e) => {
        console.log(e);
        reject(e);
      }
    );
  });
  return apiResult;
}

今回は簡略化のためにAPIキーを直接記述していますが、kintoneプラグインでは、Proxy Configを利用して安全にAPIキーを管理する仕組みが用意されています。

Qiitaに「kintoneプラグインのAPIプロキシー機能を使って、プラグインからStripe APIを呼び出す方法」として記事を公開していますので、実案件で試されたい方は、こちらもあわせてご確認ください。

Formデータは、`URLSearchParams`で生成する

new FormData()も試したのですが、kintone.plugin.app.proxyでAPIを呼び出す場合、URLSearchParamsを使うのが良いみたいです。

    const recordData = kintone.app.record.get();
    const searchParams = new URLSearchParams("");
    searchParams.set("name", recordData.record.宛名.value);
    searchParams.set("description", "Created by kintone plugin");
    const customers = await callStripeAPI(
      "customers",
      "POST",
      searchParams.toString()
    );
    console.log(customers);
  });

Constructorでname-xxxのように文字列として設定しても良さそうですが、個人的な好みもあってsetで都度登録させています。

この書き方ならば、kintoneプラグイン経由でStripeとkintoneを連携させたりもできるようになります。