2.6 アクセスルールAPI
最終更新
最終更新
概要
タイムテーブルを追加します。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/timetable
リクエスト方法
POST application/json
リクエストパラメーター
Time フィールドの説明
Special_day フィールドの説明
認証パラメーター
通常のレスポンス
レスポンスのフィールド
dataフィールドの説明
time フィールドの説明
special_day フィールドの説明
エラーレスポンスのフィールド
概要
タイムテーブルを削除します。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/timetable/delete
リクエスト方法
GET
リクエストパラメーター
認証パラメーター
通常のレスポンス
レスポンスのフィールド
エラーレスポンスのフィールド
概要
タイムテーブルを更新します。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/timetable/update
リクエスト方法
POST application/json
リクエストパラメーター
time フィールドの説明
special_day フィールドの説明
認証パラメーター
通常のレスポンス
レスポンスのフィールド
dataフィールドの説明
time フィールドの説明
special_day フィールドの説明
エラーレスポンスのフィールド
概要
タイムテーブルリストを取得します。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/timetable/list
リクエスト方法
GET
認証パラメーター
通常のレスポンス
レスポンスのフィールド
dataフィールドの説明
エラーレスポンスのフィールド
概要
タイムテーブルの詳細を取得します。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/timetable
リクエスト方法
GET
リクエストパラメーター
認証パラメーター
通常のレスポンス
レスポンスのフィールド
dataフィールドの説明
time フィールドの説明
special_day フィールドの説明
エラーレスポンスのフィールド
概要
アクセスルールを追加します。一括追加をサポートします。最初にデバイスをグループに連携する必要があります。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/rule
リクエスト方法
POST application/json
リクエストパラメーター
passRule フィールドの説明
認証パラメーター
通常のレスポンス
レスポンスのフィールド
dataフィールドの説明
エラーレスポンスのフィールド
概要
アクセスルールを削除します。一括削除が可能です。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/rule/delete
リクエスト方法
GET
リクエストパラメーター
認証パラメーター
通常のレスポンス
レスポンスのフィールド
エラーレスポンスのフィールド
概要
構成されているアクセスルールのリストを取得します。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/rule/list
リクエスト方法
GET
認証パラメーター
通常のレスポンス
レスポンスのフィールド
dataフィールドの説明
エラーレスポンスのフィールド
概要
すべてのデバイスおよびグループの連携関係 (アクセスルール情報を含む) を取得します。
リクエストアドレスの例
https://link.japancv.co.jp/api/v3/pass/devices/passrules
リクエスト方法
GET
リクエストパラメーター
認証パラメーター
通常のレスポンス
レスポンスのフィールド
dataフィールドの説明
timetableGroup フィールドの説明
エラーレスポンスのフィールド
パラメーター名
型
必須
説明
name
string
Yes
タイムテーブルの名前
monday_period
list<time>
Yes
月曜日のアクセスルール
tuesday_period
list<time>
Yes
火曜日のアクセスルール
wednesday_period
list<time>
Yes
水曜日のアクセスルール
thursday_period
list<time>
Yes
木曜日のアクセスルール
friday_period
list<time>
Yes
金曜日のアクセスルール
saturday_period
list<time>
Yes
土曜日のアクセスルール
sunday_period
list<time>
Yes
日曜日のアクセスルール
holiday_period
list<time>
Yes
祝日のアクセスルール
start_timestamp
long
Yes
有効期限開始のタイムスタンプ
end_timestamp
long
Yes
有効期限終了のタイムスタンプ
special_days
list<special_day>
No
特別な祝日
パラメーター名
型
必須
説明
start_time
string
Yes
00:00:00 形式
end_time
string
Yes
00:00:00 形式
パラメーター名
型
必須
説明
date
string
Yes
日付
remark
string
No
特記事項
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
パラメーター名
型
説明
id
int
ID
name
string
タイムテーブルの名前
monday
string
30分ごとのおおまかな 24 時間のアクセスルール
tuesday
string
30分ごとのおおまかな 24 時間のアクセスルール
wednesday
string
30分ごとのおおまかな 24 時間のアクセスルール
thursday
string
30分ごとのおおまかな 24 時間のアクセスルール
friday
string
30分ごとのおおまかな 24 時間のアクセスルール
saturday
string
30分ごとのおおまかな 24 時間のアクセスルール
sunday
string
30分ごとのおおまかな 24 時間のアクセスルール
holiday
string
30分ごとのおおまかな 24 時間のアクセスルール
monday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
tuesday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
wednesday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
thursday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
friday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
saturday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
sunday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
holiday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
start_timestamp
long
タイムスタンプ(ミリ秒単位)
end_timestamp
long
タイムスタンプ(ミリ秒単位)
update_at
string
更新時間(使用できません)
special_days
list<special_day>
特別な日
パラメーター名
型
説明
start_time
string
00:00:00 形式
end_time
string
00:00:00 形式
パラメーター名
型
説明
id
int
特別な日の ID
date
string
日付。0000 は毎年を示し、2019 は特定の年に一度だけ有効であることを示します
remark
string
特記事項
timetable_id
int
タイムテーブルの ID
code
メッセージ
説明
610
Similar record Exist
タイムテーブルの名前がすでに存在しています
30001
Param Invalid
タイムテーブルの名前が空です
30001
Param Invalid
タイムテーブルの名前が長すぎます
30001
Param Invalid
時間のフォーマットが不正です
30001
Param Invalid
特別な日が不正です
30001
Param Invalid
特記事項が長すぎます
30001
Param Invalid
特別な日が重複しています
50001
RPC FAILED
内部エラー
パラメーター名
型
必須
説明
id
long
Yes
タイムテーブルの ID
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
code
メッセージ
説明
610
Similar record Exist
タイムテーブルはアクセスルールに連携されているため、削除できません
620
Record non-existent Error
タイムテーブルが存在しません
30001
Param Invalid
パラメーターエラー
30004
Missing Param
パラメーターが不足しています
50001
RPC FAILED
内部エラー
パラメーター名
型
必須
説明
id
int
Yes
タイムテーブルの ID
name
string
Yes
タイムテーブルの名前
monday_period
list<time>
Yes
月曜日のアクセスルール
tuesday_period
list<time>
Yes
火曜日のアクセスルール
wednesday_period
list<time>
Yes
水曜日のアクセスルール
thursday_period
list<time>
Yes
木曜日のアクセスルール
friday_period
list<time>
Yes
金曜日のアクセスルール
saturday_period
list<time>
Yes
土曜日のアクセスルール
sunday_period
list<time>
Yes
日曜日のアクセスルール
holiday_period
list<time>
Yes
祝日のアクセスルール
start_timestamp
long
Yes
有効期限開始のタイムスタンプ
end_timestamp
long
Yes
有効期限終了のタイムスタンプ
special_days
list<special_day>
No
特別な祝日
パラメーター名
型
必須
説明
start_time
string
Yes
00:00:00 形式
end_time
string
Yes
00:30:00 形式
パラメーター名
型
必須
説明
date
string
Yes
日付
remark
string
No
特記事項
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
パラメーター名
型
説明
id
int
タイムテーブルの ID
name
string
タイムテーブルの名前
monday
string
24 時間を 48 の期間に分割します。string は 0 と 1 で構成され、1 は該当する期間にアクセスが可能であることを示し、0 はアクセスが可能ではないことを示します。例:100000000000000000000000000000000000000000000001 は、00:00~00:30 を示し、23:30~24:00 はアクセス可能であることを示します
tuesday
string
24 時間のアクセスルール
wednesday
string
24 時間のアクセスルール
thursday
string
24 時間のアクセスルール
friday
string
24 時間のアクセスルール
saturday
string
24 時間のアクセスルール
sunday
string
24 時間のアクセスルール
holiday
string
24 時間のアクセスルール
monday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
tuesday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
wednesday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
thursday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
friday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
saturday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
sunday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
holiday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
start_timestamp
long
タイムスタンプ(ミリ秒単位)
end_timestamp
long
タイムスタンプ(ミリ秒単位)
special_days
list<special_day>
特別な日
パラメーター名
型
説明
start_time
string
00:00:00 形式
end_time
string
00:30:00 形式
パラメーター名
型
説明
id
int
特別な日の ID
date
string
日付。0000 は毎年を示し、2019 は特定の年に一度だけ有効であることを示します
remark
string
特記事項
timetable_id
int
タイムテーブルの ID
code
メッセージ
説明
610
Similar record Exist
タイムテーブルの名前がすでに存在しています
30001
Param Invalid
タイムテーブルの名前が空です
30001
Param Invalid
タイムテーブルの名前が長すぎます
30001
Param Invalid
時間のフォーマットが不正です
30001
Param Invalid
特別な日が不正です
30001
Param Invalid
特記事項が長すぎます
30001
Param Invalid
特別な日が重複しています
50001
RPC FAILED
内部エラー
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
パラメーター名
型
説明
id
int
タイムテーブルの ID
name
string
タイムテーブル名
code
メッセージ
説明
30001
Param Invalid
パラメーターエラー
パラメーター名
型
必須
説明
id
long
Yes
タイムテーブルの ID
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
パラメーター名
型
説明
id
integer
タイムテーブルの ID
name
string
タイムテーブルの名前
monday
string
30分ごとのおおまかな 24 時間のアクセスルール
tuesday
string
30分ごとのおおまかな 24 時間のアクセスルール
wednesday
string
30分ごとのおおまかな 24 時間のアクセスルール
thursday
string
30分ごとのおおまかな 24 時間のアクセスルール
friday
string
30分ごとのおおまかな 24 時間のアクセスルール
saturday
string
30分ごとのおおまかな 24 時間のアクセスルール
sunday
string
30分ごとのおおまかな 24 時間のアクセスルール
holiday
string
30分ごとのおおまかな 24 時間のアクセスルール
monday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
tuesday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
wednesday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
thursday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
friday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
saturday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
sunday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
holiday_period
list<time>
アクセス時間(24時間形式、秒単位で指定)
start_timestamp
long
タイムスタンプ(ミリ秒単位)
end_timestamp
long
タイムスタンプ(ミリ秒単位)
special_days
list<special_day>
特別な日
パラメーター名
型
説明
start_time
string
00:00:00 形式
end_time
string
00:30:00 形式
パラメーター名
型
説明
id
int
特別な日の ID
date
string
日付。0000 は毎年を示し、2019 は特定の年に一度だけ有効であることを示します
remark
string
特記事項
timetable_id
int
タイムテーブルの ID
code
メッセージ
説明
30001
Param Invalid
パラメーターエラー
パラメーター名
型
必須
説明
list<passRule>
Yes
アクセスルールのパラメーター
パラメーター名
型
必須
説明
device_id
long
Yes
デバイスの ID
group_id
long
Yes
グループID
timetable_id
long
Yes
タイムテーブルの ID
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
パラメーター名
型
説明
id
long
アクセスルールの ID
device_id
long
デバイスの ID
device_name
string
デバイス名
group_id
long
グループID
group_name
string
グループ名
group_type
int
グループタイプ
timetable_id
long
タイムテーブルの ID
timetable_name
string
タイムテーブル名
コード
メッセージ
説明
600
Sync Failed
リモートコールに失敗しました
620
grpc.device-strategy-failed
30001
Param Invalid
パラメーターエラー
パラメーター名
型
必須
説明
ids
list<long>
Yes
アクセスルール ID
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
コード
メッセージ
説明
620
Record non-existent Error
レコードが存在しません。
30001
Param Invalid
パラメーターエラー
30004
Missing Param
パラメーターが不足しています
50001
RPC FAILED
内部エラー
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
パラメーター名
型
説明
id
int
アクセスルール ID
device_id
int
デバイスの ID
device_name
string
デバイス名
group_id
int
アクセスグループ ID
group_name
string
アクセスグループ名
timetable_id
int
タイムテーブルの ID
timetable_name
string
タイムテーブル名
group_type
int
グループタイプ
コード
メッセージ
説明
30001
Param Invalid
パラメーターエラー
パラメーター名
型
必須
説明
device_ids
list<long>
Yes
デバイスの ID
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
code
int
リターンコード
message
string
リターンメッセージ
desc
string
リターンの説明
data
object
データ
パラメーター名
型
説明
device_id
int
デバイスの ID
device_name
string
デバイス名
timetable_groups
list<timetableGroup>
連携されているタイムテーブルとアクセスグループ
パラメーター名
型
説明
group_id
int
アクセスグループ ID
group_name
string
アクセスグループ名
group_type
int
グループタイプ
timetable_id
int
タイムテーブルの ID
timetable_name
string
タイムテーブル名
コード
メッセージ
説明
30001
Param Invalid
パラメーターエラー
60001
Device Not Exist
デバイスが存在しません