BulkAPIの利用方法について

BulkAPIは、通常のAPIと違い、一度に多量のデータを登録・更新したい際に利用できるAPIです。

CSVの形でデータを連携していただくことで、新規もしくは既存のカスタマーデータをSATORIに登録・更新することができます。

 

BulkAPIを利用する場合には下記をご参照ください。

 

APIリクエスト

データの登録・更新完了時にお知らせメールが届きます。

URL

  • 新規登録用 : https://api.satr.jp/api/v3/public/bulk_customers/registration.json
  • 新規登録および更新用 : https://api.satr.jp/api/v3/public/bulk_customers/upsert.json

ヘッダ

  • Content-Type : multipart/form-data
  • 文字コード : utf-8

パラメータ

user_key => 'ユーザーアクセスキー', #(管理画面より取得)
user_secret => 'ユーザーシークレットキー', #(管理画面より取得)
company_key => 'カンパニーアクセスキー', #(管理画面より取得)
company_secret => 'カンパニーシークレットキー', #(管理画面より取得)
identity_type => 'email' or 'hashcode'
customer_csv_file => <CSVファイル>

CSVファイル内容

ファイルテンプレート : こちらからダウンロードしてください。

CSVファイルエンコード : UTF-8

カラム 項目名 必須 補足
hashcode hashcode - identity_typeでhashcodeを指定した場合は必須
email メールアドレス  
lead_company_name 企業名 -  
department 部署名 -  
position 役職 -  
phone_number 電話番号 -  
mobile_phone_number 携帯電話番号 -  
delivery_permission 配信許可 -

approval (承認)
reject (拒否)

last_name 苗字 -  
first_name 名前 -  
web_site Webサイト -  
address 住所 -  
collection_route 情報獲得経路 -  
collection_date 情報獲得日 -  
status ステータス -

regist (未対応)
reply (返信済)
phone (電話済)
visit (訪問済)
contract (契約済)
lost (失注)

star スター -

true (有)
false (無)

append_tags 追加タグ - カンマ区切りで複数指定可
delete_tags 削除タグ - カンマ区切りで複数指定可

レスポンスについて

JSONフォーマットでレスポンスが返されます。
レスポンスは以下の種類があります。

 成功


{
  "status": 202,
  "message": "Accepted",
  "body": {
    "process_code": "csv_customer_process[09aed9d5e940731cde2a3457b506acae]"
  }
}

失敗


{
  "status": 400 or 401,
  "message": "エラー内容"
}

BulkAPIリクエストサンプル

curl -X POST \
     -F "user_key=<ユーザーアクセスキー>" \
     -F "user_secret=<ユーザーシークレットキー>" \
     -F "company_key=<カンパニーアクセスキー>" \
     -F "company_secret=<カンパニーシークレットキー>" \
     -F "identity_type=email" \
     -F "customer_csv_file=@/data/file/customer.csv;type=text/csv" \
     https://api.satr.jp/api/v3/public/bulk_customers/upsert.json

アップロードファイルのテンプレート

こちらからダウンロードしてください。

※中身は適切な記述に変えてご利用下さい。