役職インポートAPI

役職インポートAPI

ファイルアップロード API でアップロードした CSV ファイルを組織情報として取り込むためのAPIです。

HTTP メソッド

POST

URI

https://{sub-domain}.cybozu.com/v1/csv/title.json

リクエストヘッダ

ヘッダ	値と説明
X-Cybozu-Authorization	「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。
Authorization	Basic認証を利用している場合、文字列「Basic 」と「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。
Content-Type	「application/json」を指定します。 ※指定しない場合は JSON が解釈できないため、実行時エラーとなります。

// Sample
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json

リクエストボディ

パラメータ値	指定する値	必須	説明
fileKey	文字列	必須	ファイルアップロード API でアップロードした際にレスポンスで取得した「fileKey」を指定します。

レスポンス

レスポンスには、結果確認 API で使用する処理の結果確認用 ID がセットされます。

CSVファイルのフォーマット

役職情報 CSV をご参照ください。

アクセス権

cybozu システム管理権限が必要です。

注意事項

• CSV は差分取り込みです。役職コードが CSV に記述されていない役職への更新／削除処理は行われません。
• 項目数は揃える必要があります。項目数が少なくても多くても取り込みエラーになります。