2.4 登録者のAPI

APIでの登録者操作では、ご利用のプランとAPIによって顔写真品質チェックの登録レベルが異なります。「サーバー側認証」かつ以下のAPIの場合、「レベル高」が実行されます。

• /api/v2/black

• /api/v2/black/update

「サーバー側認証」で上記以外のAPIを使用する場合と「端末側認証」で利用する場合は、全て「レベル低」が実行されます。認証精度向上のため、事前に認証用顔写真品質の検出APIで確認することをを推奨します。

2.4.1 従業員の追加 (/api/v1/user)

概要

従業員を追加します。

ご利用のプランによって、登録人数の上限が異なります。詳しくはお客様のご契約内容をご確認ください。

リクエストアドレスの例

https://link.japancv.co.jp/api/v1/user

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
avatarFile	file	No	認証用顔写真。4MB以下の写真データを利用してください
force	int	No	強制追加するかどうか デフォルトで0 0：強制ではない 1：強制
groups	list<long>	Yes	従業員グループIDのリスト。デフォルト値はタイプで定義します。渡さない場合、または空の場合は、どのグループにも追加しないことを示します
icNumber	string	No	IC カード番号。空の string も指定可能。長さ制限は 20です
jobNumber	string	No	従業員番号。空の string も指定可能。長さ制限は 45です
mobile	string	No	携帯電話番号。空の string も指定可能。長さ制限は 20です
name	string	Yes	従業員名
remark	string	No	特記事項。空の string も指定可能。長さ制限は 255
departmentId	long	No	部署ID
areaCode	string	No	電話番号の国別コードおよび市外局番
birthday	string	No	誕生日（日付形式：2019-06-15）
entryTime	string	No	入社日（日付形式：2019-06-15）
mail	string	No	メールアドレス。長さ制限は 45です
position	string	No	役職。長さ制限は 45です
location	string	No	勤務地。長さ制限は 45です
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）
prompt	string	No	顔認証時に表示するカスタムメッセージ
gender	int	No	性別。1 : 女性、2 : 男性

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 65838,
        "name": "1312313123123122",
        "avatar": "5cbe78b135060d0001750ef5",
        "mobile": "",
        "remark": "",
        "type": 1,
        "birthday": "",
        "mail": null,
        "position": null,
        "location": null,
        "groupList": [
            {
                "id": 1,
                "name": "Default group",
                "type": 1
            }
        ],
        "gender": 1,
        "prompt": "",
        "ic_number": "",
        "id_number": "te9+d6aXoDe5zTCUywgn9+zmx4HElB4W",
        "job_number": "",
        "company_id": 1,
        "create_at": "2019-04-23 10:30:08",
        "update_at": "2019-04-23 10:30:08",
        "department_id": 0,
        "area_code": null,
        "entry_time": "2018-9-10"
    }
}

類似登録者が存在する場合のレスポンス

{
    "code": 610,
    "message": "Similar User Exist",
    "data": {
        "similar_user_id": 65833,
        "similar_user_name": "11111111",
        "similar_user_avatar": "5cbe7dec35060d0001750f15",
        "can_force": 0
    },
    "desc": "ex.similar-user"
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	従業員ID
name	string	従業員名
avatar	string	認証用顔写真
mobile	string	携帯電話番号
remark	string	特記事項
type	int	タイプ。 1：従業員 2：ビジター
birthday	string	誕生日
mail	string	メールアドレス
position	string	役職
location	string	勤務地
groupList	list<group>	従業員グループ情報
gender	string	性別
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
job_number	string	従業員番号
company_id	long	企業ID
create_at	string	登録時間
update_at	string	更新時間
department_id	long	部署ID
area_code	string	携帯電話番号の国別コードおよび市外局番
entry_time	string	入社日

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
709	The maximum number of persons in the tenant has been reached.	ご利用のプランの登録人数上限に達しました。
30001	Param Invalid	無効なパラメーターです。登録者名の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者名が空です。
30001	Param Invalid	無効なパラメーターです。登録者IC 番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者の携帯電話番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。特記事項の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者の認証用顔写真の形式が無効です
30001	Param Invalid	無効なパラメーターです。登録者グループのID が存在しません
30001	Param Invalid	無効なパラメーターです。登録者のICカード番号がすでに存在します
30001	Param Invalid	無効なパラメーターです。登録者のIDカード番号がすでに存在します
30001	Param Invalid	無効なパラメーターです。登録者の携帯電話番号がすでに存在します
30001	Param Invalid	無効なパラメーターです。従業員の認証用顔写真のファイルが大きすぎます
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔が検知されていません
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。複数の顔が検知されました
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔の検知に失敗しました

2.4.2 従業員の追加 (/api/v2/user)

概要

従業員を追加します。「similar」と「similarPin」、2つのパラメータが新規追加されました。 従業員を管理する場合、双子など似ている人が存在するときに、この2つのパラメータを利用することにより、区別して顔認識することができます。この2パラメータは非必須ですが、「similar」にtrueと指定されたときに、「similarPin」は必須になり、４桁4Pinコードを指定する必要があります。

ご利用のプランによって、登録人数の上限が異なります。詳しくはお客様のご契約内容をご確認ください。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/user

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
avatarFile	file	No	認証用顔写真。4MB以下の写真データを利用してください
force	int	No	強制追加するかどうか デフォルトで0 0：強制ではない 1：強制
groups	list<long>	Yes	従業員グループIDのリスト。デフォルト値はタイプで定義します。渡さない場合、または空の場合は、どのグループにも追加しないことを示します
icNumber	string	No	IC カード番号。空の string も指定可能。長さ制限は 20です
jobNumber	string	No	従業員番号。空の string も指定可能。長さ制限は 45です
mobile	string	No	携帯電話番号。空の string も指定可能。長さ制限は 20です
name	string	Yes	従業員名
remark	string	No	特記事項。空の string も指定可能。長さ制限は 255
departmentId	long	No	部署ID
areaCode	string	No	電話番号の国別コードおよび市外局番
birthday	string	No	誕生日（日付形式：2019-06-15）
entryTime	string	No	入社日（日付形式：2019-06-15）
mail	string	No	メールアドレス。長さ制限は 45です
position	string	No	役職。長さ制限は 45です
location	string	No	勤務地。長さ制限は 45です
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）
prompt	string	No	顔認証時に表示するカスタムメッセージ
similar	boolean	No	よく似た人。デフォルトは falseです
similarPin	string	No	よく似た人が存在する場合の当該登録者のパスコード。4桁の数字です。similarがtrueの場合、このパラメータは必須となります return cannnot show the similar pin
gender	int	No	性別。1 : 女性、2 : 男性

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
	"code": 200,
	"message": "OK",
	"data": {
		"id": 65838,
		"name": "1312313123123122",
		"avatar": "5cbe78b135060d0001750ef5",
		"mobile": "",
		"remark": "",
		"type": 1,
		"birthday": "",
		"mail": null,
		"position": null,
		"location": null,
		"groups": [{
			"id": 1,
			"name": "default group",
			"type": 1,
			"devices": [{
				"id": 1,
				"name": "SenseThunderAir",
				"type": 19
			}],
			"is_default": 0,
			"person_count": 1
		}],
		"gender": 1,
		"prompt": "",
		"ic_number": "",
		"id_number": "te9+d6aXoDe5zTCUywgn9+zmx4HElB4W",
		"job_number": "",
		"companyId": 1,
		"create_at": "2019-04-23 10:30:08",
		"update_at": "2019-04-23 10:30:08",
		"department": 0,
		"area_code": null,
		"entry_time": "2018-9-10"
		"similar": true,
	}
}

類似登録者が存在する場合のレスポンス

{
    "code": 610,
    "message": "Similar User Exist",
    "data": {
        "similar_user_id": 65833,
        "similar_user_name": "11111111",
        "similar_user_avatar": "5cbe7dec35060d0001750f15",
        "can_force": 0
    },
    "desc": "ex.similar-user"
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	従業員ID
name	string	従業員名
avatar	string	認証用顔写真
mobile	string	携帯電話番号
remark	string	特記事項
type	int	タイプ。1：従業員、2：ビジター
birthday	string	誕生日
mail	string	メールアドレス
position	string	役職
location	string	勤務地
groups	list<group>	従業員グループ情報
gender	string	性別
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
job_number	string	従業員番号
create_at	string	登録時間
update_at	string	更新時間
department	long	部署ID
area_code	string	携帯電話番号の国別コードおよび市外局番
entry_time	string	入社日
similar	boolean	よく似た人

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ
devices	list<device>	デバイスのリスト
is_default	integer	デフォルトグループかどうか
person_count	integer	グループの人数

device フィールドの説明

パラメーター名	型	説明
id	long	デバイスID
name	string	デバイス名
type	int	デバイスタイプ

エラーレスポンスのフィールド

code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
709	The maximum number of persons in the tenant has been reached.	ご利用のプランの登録人数上限に達しました。
30001	Param Invalid	無効なパラメーターです。登録者名の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者名が空です。
30001	Param Invalid	無効なパラメーターです。登録者IC 番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者の携帯電話番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。特記事項の長さが無効です
30001	Param Invalid	無効なパラメーターです。登録者の認証用顔写真の形式が無効です
30001	Param Invalid	無効なパラメーターです。登録者グループのID が存在しません
30001	Param Invalid	無効なパラメーターです。登録者のICカード番号がすでに存在します
30001	Param Invalid	無効なパラメーターです。登録者のIDカード番号がすでに存在します
30001	Param Invalid	無効なパラメーターです。登録者の携帯電話番号がすでに存在します
30001	Param Invalid	無効なパラメーターです。従業員の認証用顔写真のファイルが大きすぎます
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔が検知されていません
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。複数の顔が検知されました
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔の検知

2.4.3 従業員情報の変更 (/api/v2/user/update/{id})

概要

従業員情報を変更します。

バージョン v1 から、従業員ID、IC カード番号、および空の ID 番号の処理ロジックが改善されました。パラメーターが渡されなかった場合やパラメーターが null の場合、変更は行われません。空の string (””） が渡された場合、空として設定されます。バージョン v1 のインターフェースは、引き続きご利用いただくことができます。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/user/update/{id}

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
id	int	Yes	変更する従業員ID の情報。タイプは path で、URL に記述されます
avatarFile	file	No	従業員の認証用顔写真
force	int	No	強制追加するかどうか。デフォルトで0 0：強制ではない 1：強制
groups	list<group>	No	従業員グループIDのリスト。 空のリストが渡される場合、従業員はどのグループにも属さないことを示します。情報が渡されない場合、変更は行われません。 従業員はリスト内の有効なグループ（グループID が存在し、企業に属しており、かつグループタイプが従業員）にのみ追加されます。
icNumber	string	No	IC カード番号。長さ制限は 20です
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）です
jobNumber	string	No	従業員番号。長さ制限は 45です
mobile	string	No	携帯電話番号。空の string を指定できます
name	string	No	名前。空の string は指定できません
remark	string	No	特記事項。空の string も指定可能。長さ制限は 255
gender	int	No	性別。1：女性、2：男性
departmentId	int	No	部署ID
areaCode	string	No	国別コードおよび市外局番
birthday	string	No	誕生日
entryTime	string	No	入社日
mail	string	No	メールアドレス。長さ制限は 45です
position	string	No	役職。長さ制限は 45です
location	string	No	勤務地。長さ制限は 45です
prompt	string	No	カスタマイズされたウェルカムプロンプト

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 79653,
 "name": "1312313123123122",
 "avatar": "",
 "mobile": "123",
 "remark": "",
 "type": 1,
 "birthday": null,
 "mail": null,
 "position": null,
 "location": null,
 "groupList": [{
 "id": 1,
 "name": "Default group",
 "type": 1
 }],
 "gender": null,
 "prompt": null,
 "ic_number": "1234000",
 "id_number": null,
 "job_number": "120003",
 "company_id": 1,
 "create_at": null,
 "update_at": "2019-08-22 11:03:18",
 "department_id": null,
 "area_code": null,
 "entry_time": null,
 }
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	従業員ID
name	string	従業員名
avatar	string	従業員の認証用顔写真
mobile	string	携帯電話番号
remark	string	特記事項
type	int	タイプ。1：従業員、2：ビジター
birthday	string	誕生日
mail	string	メールアドレス
position	string	役職
location	string	勤務地
groupList	list<group>	従業員グループ情報
gender	string	性別
prompt	string	顔認証時に表示するカスタムメッセージ
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
job_number	string	従業員ID
company_id	long	企業ID
create_at	string	作成時間
update_at	string	更新時間
department_id	long	部署ID
area_code	string	携帯電話番号の国別コードおよび市外局番
entry_time	string	入社日

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
30001	Param Invalid	無効なパラメーターです
50001	RPC FAILED	RPCに失敗しました（顔の検知に失敗したなど）
50002	Internal Server Error	内部エラーです。従業員をグループに連携できませんでした

2.4.4 従業員情報の変更 (/api/v3/user/update/{id})

概要

従業員情報を変更します。

バージョン v2 をもとに、「similar」と「similarPin」、２つのパラメータが新規追加されました。従業員を管理する場合、双子など似ている人が存在するときに、この２つのパラメータを利用することにより、区別して顔認識することができます。この２パラメータは非必須ですが、「similar」にtrueと指定されたときに、「similarPin」は必須になり、４桁のPinコードを指定する必要があります。

バージョン v2 のインターフェースは、引き続きご利用いただくことができます。

リクエストアドレスの例

https://link.japancv.co.jp/api/v3/user/update/{id}

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
id	int	Yes	変更する従業員ID の情報。タイプは path で、URL に記述されます
avatarFile	file	No	従業員の認証用顔写真
force	int	No	強制追加するかどうか。デフォルトで0 0：強制ではない 1：強制
groups	list<group>	Yes	従業員グループIDのリスト。デフォルト値はタイプで定義します。空の場合は、どのグループにも追加しないことを示します
icNumber	string	No	IC カード番号。空の string も指定可能。長さ制限は 20です
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）
jobNumber	string	No	従業員番号。空の string も指定可能。長さ制限は 45です
mobile	string	No	携帯電話番号。空の string も指定可能。長さ制限は 20です
name	string	Yes	従業員名。空の string は指定不可です
remark	string	No	特記事項。空の string も指定可能。長さ制限は 255
gender	int	No	性別。1 : 女性、2 : 男性
departmentId	int	No	部署ID
areaCode	string	No	電話番号の国別コードおよび市外局番
birthday	string	No	誕生日（日付形式：2019-06-15）
entryTime	string	No	入社日（日付形式：2019-06-15）
mail	string	No	メールアドレス。長さ制限は 45です
position	string	No	役職。長さ制限は 45です
location	string	No	勤務地。長さ制限は 45です
prompt	string	No	顔認証時に表示するカスタムメッセージ
similar	boolean	No	よく似た人。デフォルトはfalseです
similarPin	string	No	よく似た人が存在する場合の当該登録者のパスコード。4桁の数字です。similarがtrueの場合、このパラメータは必須となります

groupフィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 65838,
        "name": "1312313123123122",
        "avatar": "5cbe78b135060d0001750ef5",
        "mobile": "",
        "remark": "",
        "type": 1,
        "birthday": "",
        "mail": null,
        "position": null,
        "location": null,
        "groups": [
            {
                "id": 1,
                "name": "default group",
                "type": 1,
            }
        ],
        "gender": 1,
        "prompt": "",
        "ic_number": "",
        "id_number": "te9+d6aXoDe5zTCUywgn9+zmx4HElB4W",
        "job_number": "",
        "companyId": 1,
        "create_at": "2019-04-23 10:30:08",
        "update_at": "2019-04-23 10:30:08",
        "department": 0,
        "area_code": null,
        "entry_time": "2018-9-10"
        "similar": true,
    }
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	従業員ID
name	string	従業員名
avatar	string	従業員の認証用顔写真
mobile	string	携帯電話番号
remark	string	特記事項
type	int	タイプ。1：従業員、2：ビジター
birthday	string	誕生日
mail	string	メールアドレス
position	string	役職
location	string	勤務地
groups	list<group>	従業員グループ情
gender	string	性別
prompt	string	顔認証時に表示するカスタムメッセージ
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
job_number	string	従業員ID
companyId	long	企業ID
create_at	string	作成時間
update_at	string	更新時間
department	long	部署ID
area_code	string	携帯電話番号の国別コードおよび市外局番
entry_time	string	入社日
similar	Boolean	よく似た人がいるかどうか

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ
is_default	integer	デフォルトグループかどうか
person_count	integer	グループの人数

device フィールドの説明

パラメーター名	型	説明
id	long	デバイスID
name	string	デバイス名
type	int	デバイスタイプ

エラーレスポンスのフィールド

Code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
30001	Param Invalid	無効なパラメーターです：名前が長すぎます
30001	Param Invalid	無効なパラメーターです：名前が空です
30001	ex.method-argument-type-mismatch:id	型が一致しません
30001	ex.method-argument-type-mismatch:groups	型が一致しません
30001	Param Invalid	部署が一致しません
30001	Param Invalid	無効なパラメーターです：特記事項が長すぎます
30001	Param Invalid	無効なパラメーターです：認証用写真タイプが無効です
30001	Param Invalid	無効なパラメーターです
30001	Param Invalid	登録者が存在しません
610	Similar record Exist	従業員ID番号がすでに存在します
610	Similar record Exist	従業員ICカード番号がすでに存在します
610	Similar record Exist	従業員携帯電話番号がすでに存在します
30001	Param Invalid	従業員グループが存在しません
30001	Param Invalid	ICナンバーが長すぎます
30001	Param Invalid	従業員番号が長すぎます
30001	Param Invalid	Emailの値が長すぎます
30001	Param Invalid	勤務地の値が長すぎます
30001	Param Invalid	役職の値が長すぎます
30001	Param Invalid	ID番号が長すぎます
30001	Param Invalid	認証用写真のタイプが違います
30001	Param Invalid	写真が大きすぎます
30001	Param Invalid	従業員がこの企業に存在しません
30001	Param Invalid	無効な携帯電話番号の国別コードおよび市外局番です
610	Similar record Exist	従業員番号がすでに存在します
50502	A batch upload task is still processing. Please try again after the task is finished	バッチ処理タスクが存在します。タスクが完了後に再度試してください
50501	The maximum number of persons in the group: %groupName% has been reached	当該グループの最大人数を超えます
600	Sync Failed	顔を検出できませんでした
600	Sync Failed	複数の顔を検出しました
500	Internal Server Error	内部エラーです。従業員を登録できませんでした
50002	Internal Server Error	内部エラーです。従業員を削除できませんでした

2.4.5 従業員の削除 (/api/v1/user/delete/{id})

概要

従業員を削除します。

リクエストアドレスの例

https://link.japancv.co.jp/api/v1/user/delete/{id}

リクエスト方法

GET

リクエストパラメーター

パラメーター名	型	必須	説明
id	long	Yes	従業員のID。タイプは path で、URL に記述されます

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
  "code": 200,
  "message": "OK"
}

レスポンスのフィールド

パラメーター名	型	説明
code	int	リターンコード
message	string	リターンメッセージ

エラーレスポンスのフィールド

code	メッセージ	説明
600	Sync Failed	削除が失敗しました
700	Multi Request Error	グループから解除できませんでした
30001	Param Invalid	無効なパラメーターです

2.4.6 指定された日付（日）に追加、または更新された従業員アバターの取得（/api/v2/staff/image_updated）

概要

指定された日付（日）に追加、または更新された従業員アバターリストを取得します。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/staff/image_updated

リクエスト方法

GET

リクエストパラメーター

パラメーター名	型	必須	説明
date	string	Yes	指定された日付

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
  "code": 200,
  "message": "OK",
	"data": [
        {
             "employee_id":"001"
             "image_URL": "xxx",
             "remark": 0
         },
         {
             "employee_id":"002"
             "image_URL": "xxx",
             "remark": 1
         }
    ]
}

レスポンスのフィールド

パラメーター名	型	説明
code	int	リターンコード
message	string	リターンメッセージ
employee_id	string	従業員ID
image_URL	string	従業員アバターのリンク （現在はサポートしておりません。出力結果は無視 てください）
remark	int	従業員アバターの新規または更新の識別子 0：新規追加 1：更新

エラーレスポンスのフィールド

code	メッセージ	説明
30001	Param Invalid	無効なパラメーターです

2.4.7 ビジターの追加 (/api/v1/guest)

概要

ビジターを追加します。

ご利用のプランによって登録人数の上限が異なります。詳しくはお客様のご契約内容をご確認ください。

リクエストアドレスの例

https://link.japancv.co.jp/api/v1/guest

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
name	string	Yes	ビジター名。長さ制限は 45です
avatarFile	file	Yes	認証用顔写真
mobile	string	Yes	携帯電話番号。長さ制限は20。空の値で登録しないでください
remark	string	Yes	特記事項。空の string も指定可能。長さ制限は 255です
groups	list<long>	Yes	ビジターグループIDのリスト。デフォルト値はタイプで定義します。渡さない場合、または空の場合は、どのグループにも追加しないことを示します
force	int	No	強制追加するかどうか。デフォルトで0 0：強制ではない 1：強制
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）
receptionUserId	long	Yes	受付担当者 ID
dateTimeFrom	datetime	Yes	来訪時間（開始）。例 : 2018-07-20 12:30:45
dateTimeTo	datetime	Yes	来訪時間（終了）。例 : 2019-07-20 12:30:45
gender	int	No	性別。1：女性、2：男性
guestCompany	string	No	ビジターの企業。長さ制限は 45です
position	string	No	役職。長さ制限は 45です
guestPurpose	string	No	ビジターの来訪目的。長さ制限は 45です
mail	string	No	メールアドレス。長さ制限は 45です
icNumber	string	No	IC カード番号。長さ制限は 20です
birthday	string	No	誕生日
level	string	No	ビジターのレベル。長さ制限は 20です
prompt	string	No	カスタマイズプロンプト。長さ制限は 45です
areaCode	string	No	携帯電話番号の国別コードおよび市外局番

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 79661,
 "name": "zml",
 "avatar": "5d5e36e4f684640001b34027",
 "mobile": "123",
 "remark": "",
 "groups": [],
 "position": null,
 "level": null,
 "mail": null,
 "birthday": null,
 "prompt": null,
 "gender": null,
 "ic_number": "",
 "id_number": "kBDHQ/IUQtY=",
 "company_id": 1,
 "reception_user_id": 4567,
 "reception_user_name": "太朗",
 "group_count": 0,
 "date_time": "2018-07-20 12:30:45.0",
 "date_time_from": "2018-07-20 12:30:45.0",
 "date_time_to": "2020-07-20 12:30:45.0",
 "create_at": "2019-08-22 14:32:04.0",
 "update_at": "2019-08-22 6:32:04.0",
 "area_code": null,
 "guest_company": null,
 "guest_purpose": null
 }
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	ビジターID
name	string	ビジター名
avatar	string	ビジターの認証用顔写真
mobile	string	電話番号
remark	string	特記事項
groups	list<group>	ビジターのグループ情報
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
company_id	long	企業ID
create_at	string	作成時間
update_at	string	更新時間
reception_user_id	long	受付担当者ID
reception_user_name	string	受付担当者名
date_time_from	string	来訪時間（開始）
date_time_to	string	来訪時間（終了）
areaCode	string	電場番号の国別コードおよび市外局番。例 : 86
guestCompany	string	ビジターの企業名
position	string	役職
guestPurpose	string	ビジターの来訪目的
level	string	ビジターのレベル
mail	string	ビジターのメールアドレス
birthday	string	ビジターの誕生日。例 : 2019-06-17
prompt	string	カスタマイズプロンプト
gender	int	ビジターの性別。1：女性、2：男性

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
709	The maximum number of persons in the tenant has been reached.	利用プランの登録人数上限に達しました。
30001	Param Invalid	無効なパラメーターです。ビジター名の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジター名が空です
30001	Param Invalid	無効なパラメーターです。ビジターのID 番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターの携帯電話番号は空にはできません
30001	Param Invalid	無効なパラメーターです。ビジターの携帯電話番号の長さが空です
30001	Param Invalid	無効なパラメーターです。ビジターのコメントは空にはできません
30001	Param Invalid	無効なパラメーターです。ビジターのコメントの長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターの応対者は空にはできません
30001	Param Invalid	無効なパラメーターです。来訪時間（開始）の形式が無効です
30001	Param Invalid	無効なパラメーターです。来訪時間（終了）の形式が無効です
30001	Param Invalid	無効なパラメーターです。終了時間の形式が無効です
30001	Param Invalid	無効なパラメーターです。ビジターの認証用顔写真の形式が無効です
30001	Param Invalid	無効なパラメーターです。ビジターのグループID が存在しません
30001	Param Invalid	無効なパラメーターです。ビジターの認証用顔写真ファイルが大きすぎます
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔が検知されていません
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。複数の顔が検知されました
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔の検知に失敗しました

2.4.8 ビジターの追加 (/api/v2/guest)

概要

ビジターを追加します。

バージョン v1 をもとに、「similar」と「similarPin」、2つのパラメータが新規追加されました。ゲストを管理する場合、双子など似ている人が存在するときに、この2つのパラメータを利用することにより、区別して顔認識することができます。この2パラメータは非必須ですが、「similar」にtrueと指定されたときに、「similarPin」は必須になり、4桁のPinコードを指定する必要があります。また、認証用顔写真「avatarFile」が非必須となります。

バージョン v1 のインターフェースは、引き続きご利用いただくことができます。

ご利用のプランによって登録人数の上限が異なります。詳しくはお客様のご契約内容をご確認ください。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/guest

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
name	string	Yes	ビジター名。長さ制限は 45です
avatarFile	file	No	認証用顔写真
mobile	string	Yes	携帯電話番号。長さ制限は20。空の値で登録しないでください
remark	string	Yes	特記事項。空の string も指定可能。長さ制限は 255です
groups	list<long>	Yes	ビジターグループIDのリスト。デフォルト値はタイプで定義します。空の場合は、どのグループにも追加しないことを示します
force	int	No	強制追加するかどうか。デフォルトで0 0：強制ではない 1：強制
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）
receptionUserId	long	Yes	受付担当者 ID
dateTimeFrom	datetime	Yes	来訪時間（開始）。例 : 2018-07-20 12:30:45
dateTimeTo	datetime	Yes	来訪時間（終了）。例 : 2019-07-20 12:30:45
gender	int	No	性別。1：女性、2：男性
guestCompany	string	No	ビジターの企業。長さ制限は 45です
position	string	No	役職。長さ制限は 45です
guestPurpose	string	No	ビジターの来訪目的。長さ制限は 45です
mail	string	No	メールアドレス。長さ制限は 45です
icNumber	string	No	IC カード番号。長さ制限は 20です
birthday	string	No	誕生日
level	string	No	ビジターのレベル。長さ制限は 20です
prompt	string	No	カスタマイズプロンプト。長さ制限は 45です
areaCode	string	No	携帯電話番号の国別コードおよび市外局番
similar	boolean	No	よく似た人。デフォルトはfalseです
similarPin	string	No	よく似た人が存在する場合の当該登録者のパスコード。4桁の数字です。similarがtrueの場合、このパラメータは必須となります

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
           "id": 124379,
           "name": "zml",
           "avatar": "5dad624c199e160001c45e8f",
           "mobile": "123",
           "remark": "",
           "groups": [{
                  "id": 14,
                  "name": "Default group",
                  "type": 2
           }],
           "position": "",
           "level": "",
           "mail": "",
           "birthday": null,
           "prompt": "",
           "gender": 2,
           "ic_number": "",
           "id_number": "kBDHQ/IUQtY=",
           "companyId": 12,
           "reception_user_id": 124794,
           "reception_user_name": "Jason",
           "date_time_from": "2018-07-20 12:30:45",
           "date_time_to": "2020-07-20 12:30:45",
           "area_code": "86",
           "guest_company": "",
           "guest_purpose": "",
           "similar": true
    }
}

類似登録者が存在する場合のレスポンス

{
    "code": 30002,
    "message": "Similar User Exist",
    "data": {
        "similar_user_id": 65833,
        "similar_user_name": "11111111",
        "similar_user_avatar": "5cbe7dec35060d0001750f15",
        "can_force": 0
    },
    "desc": "ex.similar-user"
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	ビジターID
name	string	ビジター名
avatar	string	ビジターの認証用顔写真
mobile	string	電話番号
remark	string	特記事項
groups	list<group>	ビジターのグループ情報
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
companyId	long	企業ID
reception_user_id	long	受付担当者ID
reception_user_name	string	受付担当者名
date_time_from	string	来訪時間（開始）
date_time_to	string	来訪時間（終了）
area_code	string	電場番号の国別コードおよび市外局番。例 : 86
guest_company	string	ビジターの企業名
position	string	役職
guest_purpose	string	ビジターの来訪目的
level	string	ビジターのレベル
mail	string	ビジターのメールアドレス
birthday	string	ビジターの誕生日。例 : 2019-06-17
prompt	string	カスタマイズプロンプト
gender	int	ビジターの性別。1：女性、2：男性
similar	boolean	よく似た人がいるかどうか

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

Code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
620	Record non-existent Error	受付担当者が存在しません
20002	Permission Denied	拒否されました。受付担当者が存在しません
30001	Param Invalid	パスコードを入力してください。４桁のパスコードが必要です
30001	Param Invalid	無効なパラメーターです。ビジター名の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジター名が空です
30001	Param Invalid	無効なパラメーターです。ビジターのID 番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターの携帯電話番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターのコメントの長さが無効です
30001	Param Invalid	無効なパラメーターです。来訪時間（開始）の形式が無効です
30001	Param Invalid	無効なパラメーターです。来訪時間（終了）の形式が無効です
30001	Param Invalid	無効なパラメーターです。guest.come-time-not-null
30001	Param Invalid	無効なパラメーターです。guest.leave-time-not-null
30001	Param Invalid	無効なパラメーターです。ビジター電場番号の国別コードおよび市外局番の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジター電場番号の国別コードおよび市外局番が無効です
30001	Param Invalid	無効なパラメーターです。ビジターの企業名が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターの役職名が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターの来訪目的が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのレベルが長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのIC番号が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのメールが長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのメールが無効です
30001	Param Invalid	無効なパラメーターです。ビジターのコメントが長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターの性別が無効です
30001	Param Invalid	無効なパラメーターです。ビジターの誕生日が無効です
30001	Param Invalid	ビジターの携帯電話番号が空にできません
30001	Param Invalid	ビジターの認証用写真のタイプが無効です
30001	Param Invalid	ビジターの認証用写真のサイズが大きすぎます
30001	Param Invalid	ビジターのグループが存在しません
30001	Param Invalid	ビジターの応対者が存在しません
30001	Param Invalid	ビジターの認証用写真のサイズが大きすぎます
610	Similar record Exist	従業員携帯電話番号がすでに存在します
610	Similar record Exist	従業員ICカード番号がすでに存在します
610	Similar record Exist	従業員ID番号がすでに存在します
30004	Missing Param	パラメータが不足です
600	Sync Failed	顔を検出できませんでした
600	Sync Failed	複数の顔を検出しました
500	Internal Server Error	登録できませんでした
50501	The maximum number of persons in the group has been reached.	ユーザが最大数を超えています

2.4.9 ビジター情報の変更 (/api/v1/guest/update/{id})

概要

ビジター情報を変更します。

（すでに登録済みの他者の写真を利用して更新する場合、ビジター情報の変更や顔認証が正常に登録や正常に行われません。ご注意ください。）

リクエストアドレスの例

https://link.japancv.co.jp/api/v1/guest/update/{id}

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
id	long	Yes	ビジターID
name	string	Yes	ビジター名。長さ制限は 45です
avatarFile	file	No	ビジターの認証用顔写真
mobile	string	No	携帯電話番号。長さ制限は　20です
remark	string	No	特記事項。空の string も指定可能。長さ制限は 255です
groups	list<long>	Yes	ビジターグループIDのリスト。デフォルト値はタイプで定義します。渡さない場合、または空の場合は、どのグループにも追加しないことを示します
force	int	No	強制追加するかどうか。デフォルトで0：強制ではない、1：強制
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）
receptionUserId	long	Yes	受付担当者ID
dateTimeFrom	datetime	Yes	来訪時間（開始）。例 : 2018-07-20 12:30:45
dateTimeTo	datetime	Yes	来訪時間（開始）。例 : 2019-07-20 12:30:45
areaCode	string	No	携帯電話番号の国別コードおよび市外局番。
guestCompany	string	No	ビジターの企業名。長さ制限は 45
position	string	No	役職。長さ制限は 45です
guestPurpose	string	No	ビジターの来訪目的。長さ制限は 45です
level	string	No	ビジターのレベル。長さ制限は 20です
mail	string	No	ビジターのメールアドレス。長さ制限は 45です
birthday	string	No	ビジターの誕生日。例 : 2019-06-17
prompt	string	No	個別化されたプロンプト。長さ制限は 45です
gender	int	No	ビジターの性別。1：女性、2：男性
icNumber	string	No	IC カード番号。長さ制限は 20です

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "data": {
 "id": 124379,
 "name": "zml",
 "avatar": "5dad624c199e160001c45e8f",
 "mobile": "123",
 "remark": "",
 "groups": [{
 "id": 14,
 "name": "Default group",
 "type": 2
 }],
 "position": "",
 "level": "",
 "mail": "",
 "birthday": null,
 "prompt": "",
 "gender": 2,
 "ic_number": "",
 "id_number": "kBDHQ/IUQtY=",
 "company_id": 12,
 "reception_user_id": 124794,
 "reception_user_name": "太朗",
 "group_count": 1,
 "date_time": "2018-07-20 12:30:45",
 "date_time_from": "2018-07-20 12:30:45",
 "date_time_to": "2020-07-20 12:30:45",
 "create_at": "2019-10-21 15:51:28",
 "update_at": "2019-10-30 20:45:05",
 "area_code": "86",
 "guest_company": "",
 "guest_purpose": ""
 }
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	ビジターID
name	string	ビジター名
avatar	string	ビジターの認証用顔写真
mobile	string	電話番号
remark	string	特記事項
groups	list<group>	ビジターグループ情報
position	string	役職
level	string	ビジターのレベル
mail	string	メールアドレス
birthday	string	誕生日
prompt	string	カスタマイズプロンプト
gender	int	ビジターの性別。1：女性、2：男性
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
company_id	long	企業ID
create_at	string	作成時間
update_at	string	更新時間
reception_user_id	long	受付担当者ID
reception_user_name	string	受付担当者名
group_count	int	ビジターグループ数
date_time_from	string	来訪時間（開始）
date_time_to	string	来訪時間（終了）
date_time	string	来訪時間。
area_code	string	携帯電話番号の国別コードおよび市外局番です。例 ：86
guest_company	string	ビジターの企業
guest_purpose	string	ビジターの来訪目的

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	long	グループタイプ

エラーレスポンスのフィールド

code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
30001	Param Invalid	ビジターが存在しません
30001	Param Invalid	ビジターが企業に属していません
30001	Param Invalid	無効なパラメーターです。ビジター名の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジター名が空です
30001	Param Invalid	無効なパラメーターです。ビジターのID 番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターの携帯電話番号は空にはできません
30001	Param Invalid	無効なパラメーターです。ビジターの携帯電話番号の長さが空です
30001	Param Invalid	無効なパラメーターです。ビジターのコメントは空にはできません
30001	Param Invalid	無効なパラメーターです。ビジターのコメントの長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターの応対者は空にはできません
30001	Param Invalid	無効なパラメーターです。来訪時間（開始）の形式が無効です
30001	Param Invalid	無効なパラメーターです。来訪時間（開始）の形式が無効です
30001	Param Invalid	無効なパラメーターです。終了時間の形式が無効です
30001	Param Invalid	無効なパラメーターです。ビジターの認証用顔写真の形式が無効です
30001	Param Invalid	無効なパラメーターです。ビジターのグループID が存在しません
30001	Param Invalid	無効なパラメーターです。ビジターの認証用顔写真ファイルが大きすぎます
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔が検知されていません
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。複数の顔が検知されました
50001	RPC FAILED	リモート rpc の呼び出しに失敗しました。顔の検知に失敗しました

2.4.10 ビジター情報の変更 (/api/v2/guest/update/{id})

概要

ビジター情報を変更します。

バージョン v1 をもとに、「similar」と「similarPin」、2つのパラメータが新規追加されました。従業員を管理する場合、双子など似ている人が存在するときに、この2つのパラメータを利用することにより、区別して顔認識することができます。これらのパラメータは任意ですが、「similar」にtrueと指定された場合「similarPin」は必須となり、4桁のPinコードを指定する必要があります。

バージョン v1 のインターフェースは、引き続きご利用いただくことができます。

（すでに登録済みの他者の写真を利用して更新する場合、ビジター情報の変更や顔認証が正常に登録や正常に行われません。ご注意ください。）

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/guest/update/{id}

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
id	long	Yes	ビジターID
name	string	Yes	ビジター名。長さ制限は 45です
avatarFile	file	No	ビジターの認証用顔写真
mobile	string	No	携帯電話番号。長さ制限は　20です
remark	string	No	特記事項。空の string も指定可能。長さ制限は 255です
groups	list<long>	Yes	ビジターグループIDのリスト。デフォルト値はタイプで定義します。渡さない場合、または空の場合は、どのグループにも追加しないことを示します
force	int	No	強制追加するかどうか。デフォルトで0：強制ではない、1：強制
idNumber	string	No	ID 番号。長さ制限は 6～30（利用できません）
receptionUserId	long	Yes	受付担当者ID
dateTimeFrom	datetime	Yes	来訪時間（開始）。例 : 2018-07-20 12:30:45
dateTimeTo	datetime	Yes	来訪時間（開始）。例 : 2019-07-20 12:30:45
areaCode	string	No	携帯電話番号の国別コードおよび市外局番。
guestCompany	string	No	ビジターの企業名。長さ制限は 45
position	string	No	役職。長さ制限は 45です
guestPurpose	string	No	ビジターの来訪目的。長さ制限は 45です
level	string	No	ビジターのレベル。長さ制限は 20です
mail	string	No	ビジターのメールアドレス。長さ制限は 45です
birthday	string	No	ビジターの誕生日。例 : 2019-06-17
prompt	string	No	個別化されたプロンプト。長さ制限は 45です
gender	int	No	ビジターの性別。1：女性、2：男性
icNumber	string	No	IC カード番号。長さ制限は 20です
similar	boolean	No	よく似た人。デフォルトはfalseです
similarPin	string	No	よく似た人が存在する場合の当該登録者のパスコード。4桁の数字です。similarがtrueの場合、このパラメータは必須となります

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
           "id": 124379,
           "name": "zml",
           "avatar": "5dad624c199e160001c45e8f",
           "mobile": "123",
           "remark": "",
           "groups": [{
                  "id": 14,
                  "name": "Default group",
                  "type": 2
           }],
           "position": "",
           "level": "",
           "mail": "",
           "birthday": null,
           "prompt": "",
           "gender": 2,
           "ic_number": "",
           "id_number": "kBDHQ/IUQtY=",
           "companyId": 12,
           "reception_user_id": 124794,
           "reception_user_name": "Jason",
           "date_time_from": "2018-07-20 12:30:45",
           "date_time_to": "2020-07-20 12:30:45",
           "area_code": "86",
           "guest_company": "",
           "guest_purpose": "",
           "similar": truegetId
    }
}

類似登録者が存在する場合のレスポンス

{
    "code": 30002,
    "message": "Similar User Exist",
    "data": {
        "similar_user_id": 65833,
        "similar_user_name": "11111111",
        "similar_user_avatar": "5cbe7dec35060d0001750f15",
        "can_force": 0
    },
    "desc": "ex.similar-user"
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	ビジターID
name	string	ビジター名
avatar	string	ビジターの認証用顔写真
mobile	string	電話番号
remark	string	特記事項
groups	list<group>	ビジターのグループ情報
position	string	役職
level	string	ビジターのレベル
mail	string	ビジターのメールアドレス
birthday	string	ビジターの誕生日。例 : 2019-06-17
prompt	string	カスタマイズプロンプト
gender	int	ビジターの性別。 1：女性、2：男性
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
companyId	long	企業ID
reception_user_id	long	受付担当者ID
reception_user_name	string	受付担当者名
date_time_from	string	来訪時間（開始）
date_time_to	string	来訪時間（終了）
area_code	string	電場番号の国別コードおよび市外局番。例 : 86
guest_company	string	ビジターの企業名
guest_purpose	string	ビジターの来訪目的
similar	boolean	類似する人の有無が

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

Code	メッセージ	説明
610	Similar User Exist	類似する従業員がすでに存在します
620	Record non-existent Error	受付担当者が存在しません
20002	Permission Denied	拒否されました。受付担当者が存在しません
30001	Param Invalid	パスコードを入力してください。４桁のパスコードが必要です
30001	Param Invalid	無効なパラメーターです。ビジター名の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジター名が空です
30001	Param Invalid	無効なパラメーターです。ビジターのID 番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターの携帯電話番号の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジターのコメントの長さが無効です
30001	Param Invalid	無効なパラメーターです。来訪時間（開始）の形式が無効です
30001	Param Invalid	無効なパラメーターです。来訪時間（終了）の形式が無効です
30001	Param Invalid	無効なパラメーターです。guest.come-time-not-null
30001	Param Invalid	無効なパラメーターです。guest.leave-time-not-null
30001	Param Invalid	無効なパラメーターです。ビジター電場番号の国別コードおよび市外局番の長さが無効です
30001	Param Invalid	無効なパラメーターです。ビジター電場番号の国別コードおよび市外局番が無効です
30001	Param Invalid	無効なパラメーターです。ビジターの企業名が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターの役職名が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターの来訪目的が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのレベルが長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのIC番号が長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのメールが長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターのメールが無効です
30001	Param Invalid	無効なパラメーターです。ビジターのコメントが長すぎます
30001	Param Invalid	無効なパラメーターです。ビジターの性別が無効です
30001	Param Invalid	無効なパラメーターです。ビジターの誕生日が無効です
30001	Param Invalid	ビジターの携帯電話番号が空にできません
30001	Param Invalid	ビジターの認証用写真のタイプが無効です
30001	Param Invalid	ビジターの認証用写真のサイズが大きすぎます
30001	Param Invalid	ビジターのグループが存在しません
30001	Param Invalid	ビジターの応対者が存在しません
30001	Param Invalid	ビジターの認証用写真のサイズが大きすぎます
30001	ex.method-argument-type-mismatch:groups	グループが一致しません
30001	Param Invalid	ビジターが存在しません
610	Similar record Exist	従業員携帯電話番号がすでに存在します
610	Similar record Exist	従業員ICカード番号がすでに存在します
610	Similar record Exist	従業員ID番号がすでに存在します
30004	Missing Param	パラメータが不足です:groups
30004	Missing Param	パラメータが不足です
600	Sync Failed	顔を検出できませんでした
600	Sync Failed	複数の顔を検出しました
500	Internal Server Error	内部エラーです。従業員を登録できませんでした
50501	The maximum number of persons in the group: %group% has been reached	ユーザーが最大数を超えています

2.4.11 ビジターの削除 (/api/v1/guest/delete/{id})

概要

ビジターを削除します。

リクエストアドレスの例

https://link.japancv.co.jp/api/v1/guest/delete/{id}

リクエスト方法

GET

リクエストパラメーター

パラメーター名	型	必須	説明
id	long	Yes	ビジターID。タイプは path で、URL に記述されます

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
  "code": 200,
  "message": "OK"
}

レスポンスのフィールド

パラメーター名	型	説明
code	int	リターンコード
message	string	リターンメッセージ

エラーレスポンスのフィールド

code	メッセージ	説明
30001	Param Invalid	ビジターが存在しません
30001	Param Invalid	ビジターが企業に属していません
50001	RPC FAILED	ビジターを削除するためのRPCに失敗しました

2.4.12 拒否リストの追加 (/api/v2/black)

ご利用のプランによって登録人数の上限が異なります。詳しくはお客様のご契約内容をご確認ください。

概要

拒否リストを追加します。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/black

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
avatarFile	file	No	認証用顔写真
name	string	Yes	名前。長さ制限は 45です
force	int	No	強制追加するかどうか。デフォルトで0です 0：強制ではない 1：強制
groups	list<long>	No	拒否リストグループIDのリストです。渡さない場合、または空は、どのグループにも追加しないことを示します
areaCode	string	No	国別コードおよび市外局番。長さ制限は 8です
mobile	string	No	携帯電話番号。長さ制限は20です
gender	int	No	性別。1：女性、2：男性
birthday	string	No	誕生日（日付形式 : 2019-06-15）
mail	string	No	メールアドレス。長さ制限は 45です
icNumber	string	No	IC カード番号。長さ制限は 20です
idNumber	string	No	ID カード番号。長さ制限は 6～30（利用できません）
prompt	string	No	カスタマイズプロンプト。長さ制限は 255です
remark	string	No	特記事項。長さ制限は 255です

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": {
        "id": 66865,
        "name": "山田",
        "avatar": "5d084f23b2814100015ad03c",
        "mobile": "13655588555",
        "mail": "[e-mail]",
        "birthday": "2019-06-11",
        "remark": "demo",
        "groups": [
            {
                "id": 126,
                "name": "デフォルト拒否リスト",
                "type": 3
            },
            {
                "id": 127,
                "name": "2",
                "type": 3
            }
        ],
        "prompt": "ようこそ",
        "gender": 0,
        "createBy": "OPEN API",
        "avatar_show": "",
        "ic_number": "",
        "id_number": "1545557788555",
        "area_code": "86",
        "last_type": 0,
        "create_at": "2019-06-18 02:40:35.0"
    }
} 

レスポンスのフィールド

パラメーター名	型	説明
id	int	拒否リスト ID
name	string	拒否リスト名
avatar	string	認証用顔写真 ID
mobile	string	携帯電話番号
mail	string	メールアドレス
birthday	string	誕生日
remark	string	追加情報
groups	list<group>	グループ情報
prompt	string	カスタマイズプロンプト
gender	int	性別。0：不明、1：女性、2：男性
avatar_show	string	表示用写真
ic_number	string	IC カード番号
id_number	string	ID カード番号
area_code	string	国別コードおよび市外局番です。数字のみを指定できます。何も入力されなかった場合のデフォルトは 86 です
last_type	int	型
create_at	string	作成時間

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

code	メッセージ	エラーの説明
709	The maximum number of persons in the tenant has been reached.	利用プランの登録人数上限に達しました。
30001	Param Invalid	電話番号はシステム内に存在しています
30001	Param Invalid	ID カード番号はシステム内に存在しています
30001	Param Invalid	IC カード番号はシステム内に存在しています
30001	Param Invalid	従業員IDはシステム内に存在しています
30001	Param Invalid	グループID は企業に属していません
600	Sync Failed	認証用顔写真内で顔を検出できません
600	Sync Failed	認証用顔写真内で複数の顔が検出されました
600	Sync Failed	顔の数が最大数の制限を超えています
600	Sync Failed	認証用顔写真が小さすぎます
600	Sync Failed	検知スコアが低すぎます
600	Sync Failed	顔フレームのピクセルが少なすぎます
600	Sync Failed	ピッチ角が大きすぎます
600	Sync Failed	転向角が大きすぎます
600	Sync Failed	ロール角が大きすぎます
600	Sync Failed	対面距離が基準を満たしていません
600	Sync Failed	顔サイズ比が低すぎます (顔の長方形部分/画像領域)
600	Sync Failed	顔が遮られすぎています
600	Sync Failed	明るさが基準を満たしていません
600	Sync Failed	あいまいさが基準を満たしていません
600	Sync Failed	口が開き過ぎています
600	Sync Failed	欠けた顔が多すぎます
600	Sync Failed	RPCに失敗しました
610	Similar User Exist	類似する登録者がすでに存在します
700	Multi Request Error	一括処理に失敗しました
700	Multi Request Error	拒否リストとグループの連携に失敗しました
30001	Param Invalid	拒否リスト名は空にはできません
30001	Param Invalid	拒否リスト名が長すぎます
30001	Param Invalid	拒否リストの電話番号が無効です
30001	Param Invalid	拒否リストのメールアドレスが長すぎます
30001	Param Invalid	拒否リストのメールアドレスが無効です
30001	Param Invalid	拒否リストの誕生日の形式が無効です
30001	Param Invalid	拒否リストの電話番号が長すぎます
30001	Param Invalid	拒否リストのカスタマイズメッセージが長すぎます
30001	Param Invalid	拒否リストの特記事項が長すぎます
30001	Param Invalid	拒否リストのIC カード番号が長すぎます
30001	Param Invalid	拒否リストのID カード番号の長さが無効です
30001	Param Invalid	拒否リストの領域の長さが無効です
30001	Param Invalid	拒否リストの領域の形式が無効です
30001	Param Invalid	拒否リストの認証用顔写真ファイルが無効です
30001	Param Invalid	拒否リストの認証用顔写真ファイルが大きすぎます

2.4.13 拒否リストへの移動 (/api/v2/black/move/in)

概要

既存の従業員またはビジターを選択して拒否リストに移動（登録者タイプを変更）します。

拒否リストに移動した後、登録者タイプが拒否リスト（type = 5） に変更されます。元の登録者グループと部署情報はクリアされますが、他の情報は保持されます。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/black/move/in

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
userId	long	Yes	従業員またはビジターのID
groupIds	list<long>	Yes	拒否リストのグループID リスト。空の場合は拒否リストグループには追加されません

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
}

エラーレスポンスのフィールド

code	メッセージ	エラーの説明
498	Param Invalid	拒否リストが存在しません
498	Param Invalid	無効な登録者タイプです（拒否リストに移動中で、従業員でもビジターでもありません）
30001	Param Invalid	グループが空になっています
700	Multi Request Error	拒否リストとグループの連携に失敗しました
700	Multi Request Error	拒否リストとグループの連携解除に失敗しました

2.4.14 拒否リストからの削除 (/api/v2/black/move/out)

概要

拒否リストを削除します。 拒否リストから外されると、登録者タイプは元の識別子に戻ります（タイプ 1 または 2）。他の情報は保持されます。 拒否リストの登録者自体を削除するには、「拒否リストの削除」の章を参照してください。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/black/move/out

リクエスト方法

GET

リクエストパラメーター

パラメーター名	型	必須	説明
id	long	Yes	拒否リストのID

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
}

エラーレスポンスのフィールド

code	メッセージ	エラーの説明
30001	Param Invalid	登録者タイプが正しくありません。拒否リストの元の識別子が従業員またはビジターではないため、拒否リストから外すことができません
30001	Param Invalid	登録者タイプが正しくありません。拒否リストには元の識別子が無いため、拒否リストから外すことができません

2.4.15 拒否リストの変更 (/api/v2/black/update)

概要

拒否リストの情報を変更します。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/black/update

リクエスト方法

POST: form-data

リクエストパラメーター

パラメーター名	型	必須	説明
id	long	Yes	拒否リストのID
name	string	Yes	名前
force	int	No	強制追加するかどうか。 デフォルトで0：強制ではない、1：強制
areaCode	string	No	国別コードおよび市外局番
avatarFile	file	No	認証用顔写真
birthday	string	No	誕生日（日付形式 : 2019-06-15）
gender	int	No	性別。1：女性、2：男性
groups	list	No	拒否リストグループIDのリスト。渡さない場合、または空の場合は、どのグループにも追加しないことを示します
icNumber	string	No	IC カード番号。長さ制限は 20です
idNumber	string	No	ID カード番号。長さ制限は 6～30（利用できません）
mail	string	No	メールアドレス
mobile	string	No	携帯電話番号
prompt	string	No	カスタマイズプロンプト
remark	string	No	特記事項

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
 "code": 200,
 "message": "OK",
 "desc": "",
 "data": {
 "id": 124759,
 "name": "668089",
 "avatar": "5dba86ff7bf01300010b02c9",
 "mobile": "",
 "mail": "",
 "birthday": "",
 "remark": "",
 "groups": [{
 "id": 15,
 "name": "Blacklist default group",
 "type": 5
 }],
 "prompt": "",
 "gender": 2,
 "avatar_show": "",
 "ic_number": "",
 "id_number": "3O8bqu0sRiKA7+LVRzE3eQ==",
 "area_code": "86",
 "last_type": 0,
 "create_by": "admin1234",
 "create_at": "2019-10-23 17:28:19"
 }
}

レスポンスのフィールド

パラメーター名	型	説明
id	int	拒否リスト ID
name	string	従業員名
avatar	string	認証用顔写真 ID
mobile	string	携帯電話番号
mail	string	メールアドレス
birthday	string	誕生日
remark	string	追加情報
groups	list<group>	グループ情報
prompt	string	カスタマイズプロンプト
gender	int	性別 0：不明 1：女性 2：男性
avatar_show	string	表示用写真
ic_number	string	IC カード番号
id_number	string	ID カード番号
area_code	string	国別コードおよび市外局番。数字のみを指定できます。何も入力されなかった場合のデフォルトは 86です
last_type	int	タイプ
create_at	string	作成時間
create_by	string	作成者

group フィールド

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

code	メッセージ	エラーの説明
30001	Param Invalid	拒否リストID が存在しません
30001	Param Invalid	電話番号はシステム内に存在しています
30001	Param Invalid	ID カード番号はシステム内に存在しています
30001	Param Invalid	IC カード番号はシステム内に存在しています
30001	Param Invalid	従業員IDはシステム内に存在しています
30001	Param Invalid	グループID は企業に属していません
600	Sync Failed	認証用顔写真内で顔を検出できません
600	Sync Failed	認証用顔写真内で複数の顔が検出されました
600	Sync Failed	顔の数が最大数の制限を超えています
600	Sync Failed	認証用顔写真が小さすぎます
600	Sync Failed	検知スコアが低すぎます
600	Sync Failed	顔フレームのピクセルが少なすぎます
600	Sync Failed	ピッチ角が大きすぎます
600	Sync Failed	転向角が大きすぎます
600	Sync Failed	ロール角が大きすぎます
600	Sync Failed	対面距離が基準を満たしていません
600	Sync Failed	顔サイズ比が低すぎます（顔の長方形の領域 / 画像領域）
600	Sync Failed	顔が遮られすぎています
600	Sync Failed	明るさが基準を満たしていません
600	Sync Failed	あいまいさが基準を満たしていません
600	Sync Failed	口が開き過ぎています
600	Sync Failed	欠けた顔が多すぎます
600	Sync Failed	RPCに失敗しました
610	Similar User Exist	類似する登録者がすでに存在します
700	Multi Request Error	一括処理に失敗しました
700	Multi Request Error	拒否リストとグループの連携に失敗しました
30001	Param Invalid	拒否リスト名は空にはできません
30001	Param Invalid	拒否リスト名が長すぎます
30001	Param Invalid	拒否リストの電話番号が無効です
30001	Param Invalid	拒否リストのメールアドレスが長すぎます
30001	Param Invalid	拒否リストのメールアドレスが無効です
30001	Param Invalid	拒否リストの誕生日の形式が無効です
30001	Param Invalid	拒否リストの電話番号が長すぎます
30001	Param Invalid	拒否リストのカスタマイズメッセージが長すぎます
30001	Param Invalid	拒否リストの特記事項が長すぎます
30001	Param Invalid	拒否リストのIC カード番号が長すぎます
30001	Param Invalid	拒否リストのID カード番号の長さが無効です
30001	Param Invalid	拒否リストの領域の長さが無効です
30001	Param Invalid	拒否リスト領域の形式が無効です
30001	Param Invalid	拒否リストの認証用顔写真ファイルが無効です
30001	Param Invalid	拒否リストの認証用顔写真ファイルが大きすぎます

2.4.16 拒否リストの削除 (/api/v2/black/delete/{id})

概要

拒否リストを削除します。

リクエストアドレスの例

https://link.japancv.co.jp/api/v2/black/delete/{id}

リクエスト方法

GET

リクエストパラメーター

パラメーター名	型	必須	説明
id	long	Yes	拒否リスト ID。タイプは path で、URL に記述されます

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
}

エラーレスポンスのフィールド

code	メッセージ	エラーの説明
30001	Param Invalid	拒否リストID が存在しません
600	Sync Failed	リモート削除に失敗しました
700	Multi Request Error	拒否リストとグループの連携解除に失敗しました
50001	RPC FAILED	削除に失敗しました

2.4.17 登録者の参照 (/api/v1/user/list)

概要

従業員、ビジター、および拒否リストのすべての登録者の情報を取得します。特定のフィールドのフィルター検索が可能です。

リクエストアドレスの例

https://link.japancv.co.jp/api/v1/user/list

リクエスト方法

GET

リクエストパラメーター

パラメーター名	型	必須	説明
type	int	No	登録者の識別子タイプ。 1：従業員、2：ビジター、5：拒否リスト 情報が渡されなかった場合、すべてのリストが返されます
name	string	No	登録者名
jobNumber	string	No	従業員ID
mobile	string	No	携帯電話番号
mail	string	No	メールアドレス
icNumber	string	No	IC カード番号
idNumber	string	No	ID カード番号（利用できません）
id	long	No	登録者ID
departmentID	long	No	部署ID
groups	array	No	グループIDのリスト
page	int	No	ページ番号（デフォルトは 1 ）
size	int	No	1 ページあたりのデータの数（デフォルトは 20）。最大値は 100

認証パラメーター

パラメーター名	型	必須	説明
app_key	string	Yes	Appキー
sign	string	Yes	シグネチャ。1.3.1 シグネチャ（sign）の計算の項を参照してください
timestamp	string	Yes	タイムスタンプ

通常のレスポンス

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "id": 67015,
            "name": "太郎",
            "avatar": "5d0afdde1870ac00019ffffd",
            "mobile": "1882960772",
            "remark": "",
            "type": 1,
            "birthday": null,
            "mail": "",
            "position": "",
            "location": "",
            "groupList": [
                {
                    "id": 1,
                    "name": "Default group",
                    "type": 1
                }
            ],
            "gender": 1,
            "prompt": "",
            "ic_number": "",
            "id_number": "",
            "job_number": "",
            "company_id": 1,
            "create_at": "2019-06-20 03:30:37.0",
            "update_at": "2019-06-20 03:30:38.0",
            "department_id": 0,
            "area_code": "86",
            "entry_time": null,
            "country_code": null,
            "place_code": null,
            "staff_type": 0,
            "reception_user_id": 0,
            "date_time_from": "2017-01-01 00:00:00.0",
            "date_time_to": "2017-01-01 00:00:00.0",
            "avatar_show": null,
            "phone_suffix": "",
            "guest_company": null,
            "guest_purpose": null,
            "guest_level": null,
            "add_time": "2019-06-20 03:30:38.0",
            "guest_auth_status": 1,
            "last_type": 0
        }
    ]
}

レスポンスのフィールド

パラメーター名	型	説明
id	long	登録者ID
type	int	識別子タイプ 1：従業員 2：ビジター 3：不明 4： 非生体 5：拒否リスト
last_type	int	元の識別子。拒否リストの登録者にのみ適用されます 1：従業員 2：ビジター
groupList	list<group>	グループ情報。 インターフェースから返された登録者数が 1 人のみの場合、グループ情報が含まれます。複数の登録者が返された場合、グループ情報は含まれません
name	string	登録者名
avatar	string	登録者の認証用顔写真
mobile	string	携帯電話番号
ic_number	string	IC カード番号
id_number	string	IDカード番号（利用できません）
job_number	string	従業員ID
birthday	string	誕生日
mail	string	メールアドレス
gender	string	性別。1：女性、2：男性
prompt	string	顔認証時に表示するカスタムメッセージ
remark	string	特記事項
position	string	役職
location	string	場所
company_id	long	企業ID
department_id	long	部署ID
area_code	string	携帯電話番号の国別コードおよび市外局番
entry_time	string	入社日
receptionUserId	long	ビジター応対者の登録者ID
dateTimeFrom	datetime	来訪開始時間（秒単位）。例：2018-07-20 12:30:45
dateTimeTo	datetime	来訪終了時間（秒単位）。例：2018-07-20 12:30:45
guest_company	string	ビジターの企業
guest_purpose	string	ビジターの来訪目的
guest_level	string	ビジターのレベル
create_at	string	作成時間
update_at	string	更新時間

group フィールドの説明

パラメーター名	型	説明
id	long	グループID
name	string	グループ名
type	int	グループタイプ

エラーレスポンスのフィールド

code	メッセージ	エラーの説明
30001	Param Invalid	無効なパラメーターです