中国語カテゴリパラメータの受け渡し問題 - Docflow API

DocFlow API を使用する際、ファイルカテゴリ名に中国語またはその他の非英語文字が含まれている場合、カテゴリ名をそのまま渡すと次の問題が発生する可能性があります。

カテゴリのマッチング失敗: API が中国語カテゴリ名を正しく認識できない
処理エラー: カテゴリが存在しないというエラーメッセージが返される
エンコード問題: 非 ASCII 文字を含む URL パラメータによりリクエストが失敗する

解決方法

1. URL エンコード処理

中国語カテゴリ名は、API パラメータとして渡す前に UTF-8 URL エンコードする必要があります。

Python の例

import urllib.parse

# 元の中国語カテゴリ名
category = "发票"

# URL エンコード
encoded_category = urllib.parse.quote(category)
print(f"エンコード後: {encoded_category}")
# 出力: %E5%8F%91%E7%A5%A8

JavaScript の例

// 元の中国語カテゴリ名
const category = "发票";

// URL エンコード
const encodedCategory = encodeURIComponent(category);
console.log(`エンコード後: ${encodedCategory}`);
// 出力: %E5%8F%91%E7%A5%A8

ファイルカテゴリの設定方法製品料金