「楽楽販売」のAPI連携において、ファイル項目(PDF等)を直接レコード登録APIのパラメータに含めて送信することはできません。
ファイルを登録するためには、まず「ファイルアップロードAPI」を使用してファイルをシステムの一時領域へアップロードし、その際に発行される「fileId(ファイルID)」を取得する必要があります。
その後、取得した「fileId」を「CSVデータインポートAPI」のパラメータに指定してレコード登録(または更新)を行うことで、該当のファイル項目へファイルを紐付けることが可能です。
外部システム(RPAや自社アプリ等)から以下の手順でAPIを呼び出してください。
外部システムからファイルを送信し、一時領域へアップロードします。このリクエストのレスポンスとして、システムから「fileId」が返却されます。
手順1で取得した「fileId」を、インポート用CSVデータの該当項目(ファイル項目)の値として指定します。その後、CSVデータインポートAPIを実行することで、レコードの登録・更新と同時にファイルが項目へ格納されます。
API経由でファイルを登録する際、ご契約プランおよびリクエスト方式によって以下の制限がございます。
※上記上限を超えるファイルを送信しようとすると、APIリクエストが拒否されエラーとなります。上限を超える場合は、ファイルを分割するか、圧縮してサイズを抑えた状態で送信してください。
API経由でのファイル登録は、画面操作とは異なる仕様がございます。
※「ファイル」項目や「イメージ」項目へファイルをアップロードする際、APIリクエストのパラメータ指定や認証(APIトークン)が正しく行われていないと「400 Bad Request」等のエラーが発生します。必ず最新のAPI仕様書をご確認ください。
APIの具体的なリクエスト形式や、ファイルアップロードAPIの仕様については、下記記事をご確認ください。
外部システムから「楽楽販売」へリクエストを投げる際の認証ヘッダや、JSONパラメータの構成規則について詳しく解説しています。
プランごとのリクエスト上限や、大量データを連携する際の分割処理の考え方について記載されています。
(記事ID:2998)