API docs by Redocly

KEYVOX API | 開発者ポータル

Download OpenAPI specification:

KEYVOXアクセス管理サービスは、対応するロックやロッカーを導入することで、 宿泊施設、レンタルスペースやコワーキングスペース等の空間管理ビジネスを簡単に始められるソリューションです （サービスサイト https://keyvox.co）。KEYVOX APIはそのような空間管理ビジネスに必要な業務をAPIとして外部に提供することで、ユーザーの予約システム、管理システム、モバイルアプリなどに簡単に接続することを可能にします。 またWebhookを利用することで自社サービス等への解錠／施錠に関する通知も行えます。KEYVOX APIを利用してKEYVOXサービスを更に活用しましょう。
ご質問はDiscordコミュニティまでお寄せください。
※APIコール数には制限があります。

サンプルソースとして、Java、 PHP、JS(Postman用)を提供しています。

  1. 事前準備
    • KEYVOXのロックを利用する場合
      - ロックを購入します
      - KEYVOX管理画面（BACS - Blockchainlock Access Control Service）右上の①組織＞②開発者メニュー＞③APIキーを生成　からAPIキーを生成します
      - 生成したAPIキーとシークレットキーは④コピーで保存してください。


      - ⑤⑥でAPIを呼び出すサーバの公開IPアドレスを登録します。連携パートナーからAPIを呼び出す場合は、パートナーにIPアドレスをご確認ください。IPアドレスはレンジで指定することもできます。登録されているIPアドレス（レンジ）からのみAPIを呼び出すことができます。
      - KEYVOX Basicでデバイスのペアリングをします
      - KEYVOX 管理画面（BACS）で場所、ドア、デバイスの関係を設定します
    • 他社ロックを利用する場合（L!NKEY, OPELO, igloohome）
      - 各販売店よりデバイスを購入します
      - KEYVOX管理画面（BACS - Blockchainlock Access Control Service）右上の①組織＞②開発者メニュー＞③APIキーを生成　からAPIキーを生成し、公開IPアドレスを登録します。
      - (KEYVOXのロックを利用する場合を参照ください。)
      - BACSの設定＞デバイス＞デバイス追加で該当ロックを追加します
      - KEYVOX 管理画面（BACS）で場所、ドア、デバイスの関係を設定します
    • ロッカーを利用する場合
      - 販売店からロッカーを購入します
      - KEYVOX管理画面（BACS - Blockchainlock Access Control Service）右上の①組織＞②開発者メニュー＞③APIキーを生成　からAPIキーを生成し、公開IPアドレスを登録します。
      - (KEYVOXのロックを利用する場合を参照ください。)
      - ロッカーのMACアドレスをKEYVOX管理画面（BACS）に設定し、口数等必要な設定を済ませます（設定方法は納品時にご確認ください）

  2. Java、PHPでAPIを呼び出す場合
    - Java、PHPのサンプルソースをダウンロードします
    - 上記で取得したAPIキーに入れ替えて実行してみます
  3. postmanでAPIを呼び出す場合
    - postmanに使われるサンプルファイルpostman_collectionをダウンロードします
    - 参照:  Youtubeハンズオン

共通ヘッダ

Parameter Description Example
x-target-host

default.pms固定

 "default.pms"
date Client time. A difference of 5 seconds or more from the server time will deny access Mon, 29 Oct 2018 13:16:39 GMT
digest Sha256 summary of the body part (base64 encoding) SHA-256=2LJ53DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
authorization  Hmac256 authentication header. Contains 5 parts. hmac username="an9y4AidwJ3hsxfltlX7XXXXXXfGh", algorithm="hmac-sha256", headers="date request-line digest", signature="Mk0EOHf2ljFkltwPJBBvj5XXXXXNnCBnHs=" 
   Authentication header type "hmac" 
  username Issued apikey 
  algorithm Signature method. Fixed to "HMAC-SHA256"
  headers The data to be signed is composed. Fixed as "date request-line digest" 
  signature The value obtained by concatenating the data to be signed into a string in a specific way and then signing the string with apisecret.※ 

スマートロック

部屋リスト取得

WEB管理画面「BACS」で設定したドア(部屋)、ドアに紐づいているスマートロックまたはスマートロッカーの情報を取得します。カギの発行はドア(部屋)に対して行います。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Responses

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

部屋暗証番号リスト取得

WEB管理画面「BACS」で設定したドア(部屋)に発行されている暗証番号を取得します。
デバイスに対し、未発行(利用開始から72時間以上前)の暗証番号も取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

unitId
required
string

ドア（部屋）を識別するユニークIDです

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

position
string

取得レコードの位置を示すポインタIDです

records
string

取得レコード数です。未指定の場合50が指定されます

Responses

Request samples

Content type
application/json
{
  • "unitId": "000D6F0014A6F0B2",
  • "sTime": "1633359600",
  • "eTime": "1633532340",
  • "position": "11256",
  • "records": "10"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

QRコード・暗証番号発行

ドア(部屋)に対し暗証番号を新規発行します。発行された暗証番号は、ドア(部屋)に紐づけられたすべてのスマートロックに対して配信されます。スマートロックによって仕様が異なるため、異なる機種のスマートロックには同じドア(部屋)からのQRコード・暗証番号発行ができません。詳細はgetLockStatusのレスポンスを参照してください。

スマートロックの機種によって、発行できる暗証番号の桁数やタイミングが異なります。ご利用になるスマートロックの機種が特定できない場合、あらかじめgetLockStatusでスマートロックの種別を確認したうえで処理を変えていただくか、一律以下の処理を行うことを推奨します。

・クライアント側での暗証番号の指定は行わず、自動発行とする
・暗証番号の桁数をクライアント側で指定しない(スマートロック機種によって異なります)。
・createLockPinのおよそ5分後以降に、getLockPinStatusで暗証番号を取得する。
※getLockPinStatusのstatusに3X(30,31,32)が返却されるまで、定期的に取得を繰り返してください。
※暗証番号の発行は利用開始日時の72時間前から、となります。getLockPinStatusでの結果取得も「利用開始日時の72時間前」を過ぎてから行ってください。

QR1が発行するQRコードに関して
QR1が発行するQRコードには「オンラインQRコード」と「オフラインQRコード」の２種類があります。

オンラインQRコード:
サーバ側で発行したQRコードをQR1デバイスに配信します。配信後解錠できるまで数分の時間がかかります。

オフラインQRコード:
サーバ側のアルゴリズムで作成したQRコードを、QR1デバイスと通信することなく発行されたQRコードで即時に解錠できます。

/createLockPinにて「オンラインQRコード」もしくは「オフラインQRコード」のどちらを受け取るかは、KEYVOX管理画面、BACSの 設定＞デバイス＞デバイス詳細 で指定できます。
https://keyvox.notion.site/0834db2a7e6b4b19809448112ef68fa3?pvs=4

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

unitId
required
string

WEB管理画面「BACS」で設定したドア(部屋)ごとに割り当てられるユニークIDです。getUnitsで取得可能です

pinCode
string

スマートロックに配信する暗証番号に任意の数字を指定する場合に使用します。4桁から8桁を指定できます。指定がなければ6桁が自動発番されます。自動発番は6桁固定になります。オンラインQRコードは4桁から6桁のみの対応となります

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "unitId": "5de092a8ef16f9512c1f1fff",
  • "pinCode": "123456",
  • "sTime": "1633305600",
  • "eTime": "1633316400",
  • "targetName": "BCL 太郎"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ユーザーアクセス型QRコード・暗証番号発行

作成したユーザーに対して、QRコード・暗証番号を発行。ユーザーへの通知も任意のタイミングで行えます。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

unitId
required
string

WEB管理画面「BACS」で設定したドア(部屋)ごとに割り当てられるユニークIDです。getUnitsで取得可能です

pinCode
string

スマートロックに配信する暗証番号に任意の数字を指定する場合に使用します。4桁から8桁を指定できます。指定がなければ6桁が自動発番されます。自動発番は6桁固定になります。オンラインQRコードは4桁から6桁のみの対応となります

sTime
required
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
required
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

partnerEndpoint
boolean

パートナーサイトでOAuth認証をしている場合に指定します

userId
string

ユーザーID

keyType
integer

鍵の種類を指定します
0: システムが出すPINとQR
1: オフラインQRコード
2: ICカード
3: アプリ
4: ユーザーQR

metaData
object

発行側が付与しておきたいデータです。キーと値のペアを持つオブジェクトの配列として定義されます。パートナーWebhookで回収可能です

notificationMethod
string

通知方法を指定するためのフィールドです。可能な値は "email", "sms", "webhook" です

object

通知先の具体的な情報を保持するオブジェクト。以下のサブフィールドを持つことができます
email: メールアドレス
phoneNumber: SMS送信先の携帯番号
webhookURL: Webhook通知のためのエンドポイントURL

object

このパラメータは、通知のタイミングを制御します

Responses

Request samples

Content type
application/json
{
  • "unitId": "5de092a8ef16f9512c1f1fff",
  • "pinCode": "123456",
  • "sTime": "1633305600",
  • "eTime": "1633316400",
  • "targetName": "BCL 太郎",
  • "partnerEndpoint": true,
  • "userId": "existingUserId12345",
  • "keyType": 1,
  • "metaData": {
    },
  • "notificationMethod": "email",
  • "notificationDetails": {},
  • "notificationTiming": {
    }
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

QRコード・暗証番号変更

発行したQRコード・暗証番号を変更します。変更を行う際には、createLockPinのレスポンスに含まれるpinIdを指定する必要があります。一部のスマートロックは仕様が異なるため、変更、削除ができません。(※)

※スマートロック igloohome、OPELO をご利用されている場合、発行済みの暗証番号を変更、削除することはできません。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

pinId
required
string

暗証番号を識別するユニークIDです

pinCode
string

スマートロックに配信する暗証番号に任意の数字を指定する場合に使用します。4桁から8桁を指定できます。指定がなければ6桁が自動発番されます。自動発番は6桁固定になります。オンラインQRコードは4桁から6桁のみの対応となります

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "pinId": "c62325518edc528e24492ee8",
  • "pinCode": "123456",
  • "sTime": "1633305600",
  • "eTime": "1633316400",
  • "targetName": "XXXで利用"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

QRコード・暗証番号削除

発行したQRコード・暗証番号を削除します。削除を行う際には、createLockPinのレスポンスに含まれるpinIdを指定する必要があります。一部のスマートロックは仕様が異なるため、変更、削除ができません。(※)

※スマートロック igloohome、OPELO をご利用されている場合、発行済みの暗証番号を変更、削除することはできません。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

pinId
required
string

暗証番号を識別するユニークIDです

Responses

Request samples

Content type
application/json
{
  • "pinId": "c62325518edc528e24492ee8"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

暗証番号ステータス取得

pinIdを指定して、発行した暗証番号のスマートロックへの配信状況を確認します。スマートロックが複数ある場合、最も遅いステータスが返却されます。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

pinId
required
string

暗証番号を識別するユニークIDです

Responses

Request samples

Content type
application/json
{
  • "pinId": "c62325518edc528e24492ee8"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

デバイス暗証番号リスト取得

lockIdを指定して、スマートロックごとに発行済みの暗証番号を取得します。取得できるのはデバイスに配信済みの暗証番号のみです。
未来の暗証番号について、利用開始予定時間が72時間以内であれば、すぐ配信しますが、72間後以降の場合、72時間以内になってから配信を行います。
このAPIで取得できるのは配信済(利用開始予定時間が72時間以内）の暗証番号だけであり、それ以降のものについては取得できません。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

lockId
required
string

スマートロックを識別するユニークIDです

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

position
string

取得レコードが全体で何番目かの位置を示す情報です

records
string

取得レコード数です。未指定の場合50が指定されます

Responses

Request samples

Content type
application/json
{
  • "lockId": "000D6F0014A6F0B2",
  • "sTime": "1633359600",
  • "eTime": "1633532340",
  • "position": "200",
  • "records": "10"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ロック状態取得

lockIdを指定して、ロックの開閉状態、バッテリー残量、Wi-Fi接続状況を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

lockId
required
string

スマートロックを識別するユニークIDです

Responses

Request samples

Content type
application/json
{
  • "lockId": "000D6F0014A6F0B2"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ロック解錠履歴取得

デバイスのID（lockId）を指定して、ロックの開閉履歴を取得します。新しいAPIであるロックイベント履歴 /eventの利用を推奨します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

lockId
required
string

スマートロックを識別するユニークIDです

position
string

取得レコードの位置を示すポインタIDです
※初回で「position」を指定せず、履歴を取得したレスポンスの「position」を次回のパラメータとして使用します

records
string

取得レコード数です。未指定の場合50が指定されます

Responses

Request samples

Content type
application/json
{
  • "lockId": "000D6F0014A6F0B2",
  • "position": "62fbba54a5ec72404000c962",
  • "records": "10"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ロックイベント履歴取得

既存の/getLockHistoryに代わる新しいインターフェースで、QR1やその他のスマートロックの解錠、施錠などの操作・イベント履歴を条件指定で検索します。
header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

actionType
string

絞り込み条件（操作種別）
"all":すべてのログ
"open":解錠
"close":施錠
"switch":解錠・施錠操作のみ
"unlockerror":解錠エラーのみ
"remotelink":クラウド連携イベント
"adduser":ユーザー追加
"deluser":ユーザー削除

keyType
string

絞り込み条件（解錠方法）
"all":すべての手段
"pin":暗証番号による解錠
"QR":QRコードによる解錠
"ic":ICカードによる解錠
"remote":クラウド・Bluetooth経由での解錠
"auto":オートロックによる施錠
"pressbtn":本体ボタンによる解錠
"knobbtn":サムターン操作
"touchscreen":タッチパネル操作
"remotelink":クラウド連携による操作

keyWord
string

任意のキーワード（デバイス名等に一致）

sTime
required
string

検索範囲の開始日時
UNIX時間（秒）で指定します

eTime
required
string

検索範囲の終了日時
UNIX時間（秒）で指定します

sortWord
string

並び替え対象のフィールド

sequence
integer

0:降順 / 1:昇順

page
integer

1ページ目から指定

count
integer

表示件数（最大100前後）

Responses

Request samples

Content type
application/json
{
  • "actionType": "switch",
  • "keyType": "pin",
  • "keyWord": "QR1",
  • "sTime": "1745078400",
  • "eTime": "1745769540",
  • "sortWord": "createtime",
  • "sequence": 0,
  • "page": 1,
  • "count": 10
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ビーコンイベント履歴取得

ビーコンのイベント履歴を条件指定で検索します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

lockId
required
string

BX1のlockID

sTime
required
string

検索範囲の開始日時
UNIX時間（秒）で指定します

eTime
required
string

検索範囲の終了日時
UNIX時間（秒）で指定します

page
integer

1ページ目から指定

count
integer

表示件数（最大100前後）

Responses

Request samples

Content type
application/json
{
  • "lockId": "BX35YILMR7HY2MBW",
  • "sTime": "1755649591",
  • "eTime": "1756269376",
  • "page": 1,
  • "count": 10
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ロック開閉

lockIdを指定して、直接解錠、施錠を行います。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

lockId
required
string

スマートロックを識別するユニークIDです

flag
required
string
Enum: "0" "1"

鍵の開閉操作を指定します。0:施錠, 1:解錠

Responses

Request samples

Content type
application/json
{
  • "lockId": "000D6F0014A6F0B2",
  • "flag": "0"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

カード配信

ドアに対しICカードを新規発行

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

unitId
required
string

WEB管理画面「BACS」で設定したドア(部屋)ごとに割り当てられるユニークIDです。getUnitsで取得可能です

cardCode
required
string

Mifereの場合は、UIDを、Felicaの場合はIDmの値を指定します

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "unitId": "5de092a8ef16f9512c1f1fff",
  • "cardCode": "C3AD47FC",
  • "sTime": "1633305600",
  • "eTime": "1633532340",
  • "targetName": "XXXで利用"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

カード更新

発行したICカードの利用期間、名前を変更します。変更を行う際には、setCardのレスポンスに含まれるcardIdを指定する必要があります。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

cardId
required
string

カードを識別するユニークIDです

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "cardId": "c62325518edc5224492ee8",
  • "sTime": "1633305600",
  • "eTime": "1633532340",
  • "targetName": "XXXで利用"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

カード削除

発行したICカードを削除します。削除を行う際には、setCardのレスポンスに含まれるcardIdを指定する必要があります。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

cardId
required
string

カードを識別するユニークID

Responses

Request samples

Content type
application/json
{
  • "cardId": "c62325518edc5224492ee8"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

カードステータス取得

accessIdを指定して、発行したICカードのスマートロックへの配信状況を確認します。スマートロックが複数ある場合、最も遅いステータスが返却されます。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

cardId
string

setLockerCardでアクセス権を設定した際に返却される、アクセス権ごとのユニークIDです。アクセス権を更新する際に指定します

Responses

Request samples

Content type
application/json
{
  • "cardId": "5f7e9dba0cc45444a0b3a895"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

カードリスト取得

lockIdを指定して、スマートロックごとに発行済みのICカード情報を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

lockId
required
string

スマートロックを識別するユニークIDです

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

position
string

取得レコードが全体で何番目かの位置を示す情報です

records
string

取得レコード数です。未指定の場合50が指定されます

Responses

Request samples

Content type
application/json
{
  • "lockId": "000D6F0014A6F0B2",
  • "sTime": "1633305600",
  • "eTime": "1633532340",
  • "position": "200",
  • "records": "10"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ユーザー新規登録

ユーザー名を指定して、ユーザーを新規登録します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

usreName
string

ユーザー名

groupId
string

グループに所属させたい場合に使用します。複数指定可能です

email
string

ユーザーのメールアドレスです。通知の送信先として使用されます

phoneNumber
string

ユーザーの携帯番号です。SMS通知の送信先として使用されます

webhookURL
string

ユーザーが指定するWebhookのURLです。通知を受け取るためのエンドポイントになります

defaultNotificationMethod
string

デフォルトの通知方法です。可能な値は "email", "sms", "webhook" です

customQR
string

ユーザーが独自に設定するオリジナルQRコードです

requestUserQR
boolean

レスポンスにUserQRが欲しい場合Trueを指定してください

requestInvitationURL
boolean

レスポンスにBCL招待URLが欲しい場合Trueを指定してください

Responses

Request samples

Content type
application/json
{
  • "usreName": "田中 太郎",
  • "groupId": "659e249e0cc4547f25a4e508",
  • "email": "tanaka@example.com",
  • "phoneNumber": "09012345678",
  • "webhookURL": "https://webhook.example.com/notifications",
  • "defaultNotificationMethod": "sms",
  • "customQR": "MK12A795D6036745A44F57FA03E4A540D3LKC368D78AF44A89A88DEE31BD6608C5E8",
  • "requestUserQR": "true",
  • "requestInvitationURL": "true"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ユーザー情報更新

ユーザー名を指定して、ユーザー情報を更新します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

usreName
string

ユーザー名

email
string

ユーザーのメールアドレスです。通知の送信先として使用されます

phoneNumber
string

ユーザーの携帯番号です。SMS通知の送信先として使用されます

webhookURL
string

ユーザーが指定するWebhookのURLです。通知を受け取るためのエンドポイントになります

defaultNotificationMethod
string

デフォルトの通知方法です。可能な値は "email", "sms", "webhook" です

requestInvitationURL
boolean

BCLInvitation URLをレスポンスで受け取りたい場合はtrueを、そうでない場合はfalseを入力するか未入力とします

Responses

Request samples

Content type
application/json
{
  • "usreName": "田中 太郎",
  • "email": "tanaka@example.com",
  • "phoneNumber": "09012345678",
  • "webhookURL": "https://webhook.example.com/notifications",
  • "defaultNotificationMethod": "sms",
  • "requestInvitationURL": "true"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

スマートロッカー

部屋リスト取得

WEB管理画面「BACS」で設定したドア(部屋)、ドアに紐づいているスマートロックまたはスマートロッカーの情報を取得します。カギの発行はドア(部屋)に対して行います。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Responses

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

ロッカー取得

WEB管理画面「BACS」に登録されているロッカー本体の情報を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Responses

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

ロッカーステータス取得

deviceIdを指定し、ロッカー本体ごとの各ボックスの利用状況を取得します。ボックス番号(boxNum)はWEB管理画面「BACS」にて確認できます。
※boxNumは数字でxx-yyの形式となり、xxは副キャビネット番号、yyはBOX番号です。それぞれの番号は固定ではなくロッカー毎に違います。BACSの設定＞ロッカー＞ボックス設定画面で確認の上、指定してください。
詳しくはこちら

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
required
string

スマートロッカーを識別するユニークIDです

boxNum
string

ボックスの番号情報を"00-01"のような書式で指定します。00は副キャビネット番号、01はBOX番号を表します

Responses

Request samples

Content type
application/json
{
  • "deviceId": "5bceb8e2076d20135c307916",
  • "boxNum": "00-01"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

ロッカーステータス設定

deviceIdを指定し、ロッカー本体ごとの各ボックスの状況を設定します。ボックス番号(boxNum)はWEB管理画面「BACS」にて確認できます。
※boxNumは数字でxx-yyの形式となり、xxは副キャビネット番号、yyはBOX番号です。それぞれの番号は固定ではなくロッカー毎に違います。BACSの設定＞ロッカー＞ボックス設定画面で確認の上、指定してください。
詳しくはこちら

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
required
string

スマートロッカーを識別するユニークIDです

boxNum
required
string

ボックスの番号情報を"00-01"のような書式で指定します。00は副キャビネット番号、01はBOX番号を表します

status
required
string
Enum: "0" "3"

ステータス。0:未使用, 3:故障

Responses

Request samples

Content type
application/json
{
  • "deviceId": "5bceb8e2076d20135c307916",
  • "boxNum": "00-01",
  • "status": "0"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

ロッカー解錠

deviceId、boxNumを指定して、ロッカーの特定のボックスを直接解錠します。
※boxNumは数字でxx-yyの形式となり、xxは副キャビネット番号、yyはBOX番号です。それぞれの番号は固定ではなくロッカー毎に違います。BACSの設定＞ロッカー＞ボックス設定画面で確認の上、指定してください。
詳しくはこちら

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
required
string

スマートロッカーを識別するユニークIDです

boxNum
required
string

ボックスの番号情報を"00-01"のような書式で指定します。00は副キャビネット番号、01はBOX番号を表します

Responses

Request samples

Content type
application/json
{
  • "deviceId": "A5C8A98B35260000",
  • "boxNum": "00-01"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

ロッカーにカード配信

ロッカーの特定のボックスに対し、ICカードの利用権限を発行します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
string

スマートロッカーを識別するユニークIDです

boxNum
string

ボックスの番号情報が"00-01"のような書式で返却されます。00は副キャビネット番号、01はBOX番号を表します。
getLockerStatusのレスポンスでboxNumを確認することができます

cardCode
string

Mifereの場合は、UIDを、Felicaの場合はIDmの値を指定します

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "deviceId": "A5C8A98B35260000",
  • "boxNum": "00-01",
  • "cardCode": "C3AD47FC",
  • "sTime": "1633305600",
  • "eTime": "1633532340",
  • "targetName": "XXX用ロッカーのカード"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

ロッカーにカード更新

発行したICカードの利用期間、名前を変更します。変更を行う際には、setLockerCardのレスポンスに含まれるaccessIdを指定する必要があります。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

accessId
required
string

setLockerCardでアクセス権を設定した際に返却される、アクセス権ごとのユニークIDです

sTime
required
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
required
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "accessId": "string",
  • "sTime": "1633305600",
  • "eTime": "1633532340",
  • "targetName": "XXXロッカーのカード"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

ロッカーQRコード・暗証番号発行

ロッカーの特定のボックスに対し、暗証番号を発行します。 暗証番号の他に、レスポンスとしてQRコード生成用URLも取得することができます。 暗証番号の扱いについてはいくつかのオプションがあります。 詳細はインターフェース内容の説明をご確認ください。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
required
string

ロッカーを識別するユニークIDです

boxNum
string

ボックスの番号情報を"00-01"のような書式で指定します。00は副キャビネット番号、01はBOX番号を表します

checkin
string
Enum: "0" "1"

ボックスのステータスを指定します。
0:「利用中」の状態でボックスを確保します。ロッカーを解錠した際、利用中のボックスを再度開いた扱いとなります
1:「利用前」の状態でボックスを確保します。ロッカーを解錠した際、新規利用の扱いとなります。他の利用権限ですでにボックスを利用されている場合、利用開始ができません

mode
string
Enum: "0" "1" "2"

0:once(一度のみ利用可能なモードです。利用開始後、返却したら再度利用開始することはできません。また、利用中のままeTimeを過ぎても自動的に返却扱いとはなりません)
1:multi(繰り返し利用可能なモードです。sTime - eTimeの間、返却しても再度利用開始することができます。利用中のままeTimeを過ぎても自動的に返却扱いとはなりません)
2:always(sTime - eTimeの間、何度も解錠可能なモードです。期間中は確保したボックスを占有し、ゲストから返却することはできません。eTimeを過ぎたら自動的に返却扱いとなります)

reassign
string
Enum: "0" "1"

Reassign. 0:false(指定したボックスが利用中の場合、空きがないエラーをロッカー端末に表示します)
1:true(指定したボックスが利用中の場合、別のボックスを自動的にアサインします)

pinCode
string

スマートロッカーに配信する暗証番号に6桁の任意の数字を指定する場合に使用します

sTime
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "deviceId": "A5C8A98B35260000",
  • "boxNum": "00-01",
  • "checkin": "1",
  • "mode": "0",
  • "reassign": "0",
  • "pinCode": "123456",
  • "sTime": "1633305600",
  • "eTime": "1633532340",
  • "targetName": "XXX用のロッカー暗証番号"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ロッカーQRコード・暗証番号更新

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

pinId
required
string

暗証番号を識別するユニークIDです

pinCode
string

スマートロッカーに配信する暗証番号に6桁の任意の数字を指定する場合に使用します

sTime
required
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
required
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

targetName
string

カギを利用する利用者名を指定します。WEB管理画面「BACS」の履歴などに表示されます

Responses

Request samples

Content type
application/json
{
  • "pinId": "ABACCD0G1",
  • "pinCode": "123456",
  • "sTime": "1633359600",
  • "eTime": "1633532340",
  • "targetName": "XXX用のロッカー"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

ロッカーQRコード・暗証番号削除

発行したQRコード・暗証番号を削除します。削除を行う際には、createLockerPinのレスポンスに含まれるpinIdを指定する必要があります。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

pinId
required
string

暗証番号を識別するユニークIDです

Responses

Request samples

Content type
application/json
{
  • "pinId": "ABACCD0G1"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

ロッカー権限リスト取得

ロッカーの特定のボックスに対し、登録済みのカギ情報を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
required
string

スマートロッカーを識別するユニークIDです

boxNum
string

ボックスの番号情報を"00-01"のような書式で指定します。00は副キャビネット番号、01はBOX番号を表します。
getLockerStatusのレスポンスでboxNumを確認することができます

sTime
required
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
required
string (getLockerOrdersIn)

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

Responses

Request samples

Content type
application/json
{
  • "deviceId": "A5C8A98B35260000",
  • "boxNum": "00-01",
  • "sTime": "1633359600",
  • "eTime": "1633532340"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

ロッカー空きボックスリスト取得

ロッカー本体ごとに、空いているボックスを取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
required
string

スマートロッカーを識別するユニークIDです

boxSize
string

WEB管理画面「BACS」で設定したスマートロッカーのサイズ情報を指定するサイズ番号が返却されます

sTime
required
string

利用開始日時です。1970/01/01からの秒数(UNIX時間)で指定します

eTime
required
string

利用終了日時です。1970/01/01からの秒数(UNIX時間)で指定します

Responses

Request samples

Content type
application/json
{
  • "deviceId": "5bceb8e2076d20135c307916",
  • "boxSize": "1",
  • "sTime": "1633359600",
  • "eTime": "1633532340"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": [
    ]
}

ロッカーLED色指定

ロッカーボックス毎のLED状態を指定します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

deviceId
required
string

スマートロッカーを識別するユニークIDです

boxNum
required
string

ボックスの番号情報を"00-01"のような書式で指定します。00は副キャビネット番号、01はBOX番号を表します

boxColor
required
integer

ボックスの色を指定します。
0:消灯、1:点灯(緑)、2:点灯(赤)、3:点灯(青)

Responses

Request samples

Content type
application/json
{
  • "deviceId": "A5C8A98B35260000",
  • "boxNum": "00-01",
  • "boxColor": 0
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

ロッカーイベント履歴取得

ロッカーの解錠、施錠などの操作・イベント履歴を条件指定で検索します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

orgId
string

組織ID

userName
string

ユーザー名

count
integer

表示件数（最大100前後）

page
integer

1ページ目から指定

sTime
required
string

検索範囲の開始日時
UNIX時間（秒）で指定します

eTime
required
string

検索範囲の終了日時
UNIX時間（秒）で指定します

actionType
string

絞り込み条件（操作種別）
"all":すべて
"openByPIN":暗証番号
"openByQR":QRコード
"openByICCARD":ICカード
"bacs":bacs
"basic":basic
"api":API
"confirmPin":暗証番号確認
"manualConfirmPin":暗証番号確認(手動)

keyType
string

絞り込み条件（解錠方法）
"all":すべて
"open":解錠
"close":閉じる
"returnBox":返却
"setBoxPin":暗証番号を設定
"setLocker":利用開始
"clear":未使用に変更
"borrowBox":宅配ロッカー預け入れ
"unlockerror":解錠エラー
"basicOpen":KEYVOX Basicで開く
"setLedColor":LED設定
"setLedColorError":LED設定エラー
"confirmPin":暗証番号確認
"manualConfirmPin":暗証番号確認(手動)
"basic":basic
"api":API
"confirmPin":暗証番号確認
"manualConfirmPin":暗証番号確認(手動)

Responses

Request samples

Content type
application/json
{
  • "orgId": "5f35065f968a8874400fb156",
  • "userName": "山田太郎",
  • "count": 10,
  • "page": 1,
  • "sTime": "1745078400",
  • "eTime": "1745769540",
  • "actionType": "switch",
  • "keyType": "pin"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

WEB管理画面「BACS」操作

カード登録

WEB管理画面「BACS」に対し、ICカードの情報を登録します。あらかじめICカードのIDｍ/UIDをご用意いただく必要があります。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

cardCode
required
string

Mifereの場合はUIDを、Felicaの場合はIDmの値を指定します

cardName
required
string

カード名

cardDesc
string

カード備考

Responses

Request samples

Content type
application/json
{
  • "cardCode": "C3AD47FC",
  • "cardName": "XXXX用カード",
  • "cardDesc": "XXXXで利用"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

カード削除

WEB管理画面「BACS」に対し、登録したICカードの情報を削除します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

Array of objects (delCard)

Responses

Request samples

Content type
application/json
{
  • "cardList": [
    ]
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success"
}

予約

予約リスト取得

WEB管理画面「BACS」で設定したドア(部屋)に紐づいている、未チェックインの予約情報一覧を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

unitId
required
string

WEB管理画面「BACS」で設定したドア(部屋)ごとに割り当てられるユニークIDです。getUnitsで取得可能です

Responses

Request samples

Content type
application/json
{
  • "unitId": "5de092a8ef16f9512c1f1fff"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

場所一覧取得

Bacsに登録されている場所一覧を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

page
required
integer

ページ番号

count
required
integer

１ページ件数

placeType
string

場所カテゴリ
"hotel":ビルディング, "locker":ロッカー, "doubleLocker":両面開きロッカー, "vendingMachine":自動販売機

Responses

Request samples

Content type
application/json
{
  • "page": 0,
  • "count": 20,
  • "placeType": "hotel"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {}
}

場所詳細情報取得

Bacsに登録されている場所の詳細情報を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550"
}

Response samples

Content type
application/json
{}

部屋プラン一覧取得

Bacsに登録されている部屋プラン一覧を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

page
required
integer

ページ番号

count
required
integer

１ページ件数

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "page": 0,
  • "count": 20
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

部屋プラン詳細取得

指定プラン詳細情報、および在庫状況を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

commodityId
required
string

部屋プランID

targetType
string

プランタイプ
"order":予約
"order"で指定された場合、「貸出不可時間」を返却する

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "commodityId": "5f35065f968a8874400fb230",
  • "targetType": "order"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

部屋一覧取得

Bacsに登録されている部屋一覧を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

page
required
integer

ページ番号

count
required
integer

１ページ件数

searchWord
string

検索キーワード

unitBusinessType
string

ビジネスタイプ
"housing":宿泊, "rentalSpace":レンタルスペース, "conferenceRoom":コーワーキング, "locker":ロッカー, "airdrop":ドロップイン, "vendingMachine":自動販売機

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "page": 0,
  • "count": 20,
  • "searchWord": "埼玉",
  • "unitBusinessType": "housing"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

予約作成

予約を新規作成します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

orderSource
required
string

予約サイト名(システム名)

channelOrderNo
string

予約サイト予約番号

userId
string

ユーザーID

checkin
required
integer

チェックイン時間
UNIX時間（秒）で指定します

checkout
required
integer

チェックアウト時間
UNIX時間（秒）で指定します

orderContact
required
string

お客様氏名

contactAddress
string

お客様住所

contactCertificateNum
string

お客様証明書ID

contactCountry
string

お客様国コード

contactEmail
string

お客様メールアドレス

contactGender
string

お客様性別
"M":男, "F":女

contactPinyin
string

お客様名ふりがな

contactTel
string

お客様電話番号

customerNum
required
integer

予約人数

maleNum
integer

予約人数（男性）

femaleNum
integer

予約人数（女性）

payTypeCode
required
string

支払方法を指定します
"stripeCreditCard":クレジットカード, "offlinePayment":オフライン決済, "cash":現金

paymentMethod
string

stripe支払方法を指定します
・payTypeCode="stripeCreditCard"の場合、Stripe側の支払方法ID
・上記外の場合、未利用

earlyTime
required
integer

アーリーチェックイン
単位（分）、指定必要。特別な要件がなければ、0をセットしてください

extendTime
required
integer

レイトチェックアウト
単位（分）、指定必要。特別な要件がなければ、0をセットしてください

required
Array of objects (CommodityDataIn)

予約する部屋プランの詳細

Array of objects (PayDataIn)

支払情報

unitNum
required
integer

予約する部屋数

Array of objects (OrderUnitDataIn)

ドア情報

Array of objects (OrderTenantCreateIn)

同行者情報

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "orderSource": "楽天トラベル",
  • "channelOrderNo": "123456789",
  • "userId": "5fe15ae6bb2f0c41e382c7c1",
  • "checkin": 1635832800,
  • "checkout": 1635901200,
  • "orderContact": "山田太郎",
  • "contactAddress": "千葉県千葉市美浜区",
  • "contactCertificateNum": "21634161354",
  • "contactCountry": "CN",
  • "contactEmail": "1261117576@qq.com",
  • "contactGender": "M",
  • "contactPinyin": "lxy",
  • "contactTel": "090-1234-5678",
  • "customerNum": 1,
  • "maleNum": 0,
  • "femaleNum": 0,
  • "payTypeCode": "stripeCreditCard",
  • "paymentMethod": "pm_1JwKcOInYjCWEx8ccnE5Ljkd",
  • "earlyTime": 30,
  • "extendTime": 15,
  • "commodityList": [
    ],
  • "payList": [
    ],
  • "unitNum": 1,
  • "unitList": [
    ],
  • "tenantList": []
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

予約変更

予約を変更します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

orgId
required
string

組織ID

placeId
required
string

場所ID

orderId
required
string

注文番号

orderSource
string

予約サイト名(システム名)

channelOrderNo
string

予約サイト予約番号

userId
string

ユーザーID

checkin
required
integer

チェックイン時間
UNIX時間（秒）で指定します

checkout
required
integer

チェックアウト時間
UNIX時間（秒）で指定します

orderContact
required
string

お客様氏名

contactAddress
string

お客様住所

contactCertificateNum
string

お客様証明書ID

contactCountry
string

お客様国コード

contactEmail
string

お客様メールアドレス

contactGender
string

お客様性別
"M":男、"F":女

contactPinyin
string

お客様名ふりがな

contactTel
string

お客様電話番号

customerNum
required
integer

人数

maleNum
integer

人数（男性）

femaleNum
integer

人数（女性）

payTypeCode
required
string

支払方法
"stripeCreditCard":クレジットカード、
"offlinePayment":オフライン決済、
"cash":現金

paymentMethod
string

stripe支付方法
・　payTypeCode="stripeCreditCard"の場合、Stripe側の支払方法ID
・　上記外の場合、未利用

earlyTime
required
integer

アーリーチェックイン
単位（分）、指定必要。特別な要件がなければ、0をセットしてください

extendTime
required
integer

レイトチェックアウト
単位（分）、指定必要。特別な要件がなければ、0をセットしてください

required
Array of objects (CommodityUpdateIn)

商品リスト
商品が更新されていない場合でも入力は必須です

Array of objects (PayUpdateIn)

支払情報

unitNum
required
integer

ドア本数

required
Array of objects (OrderUnitUpdateIn)

ドア情報
ドア情報が変更されていない場合、unitListは省略可能です

Array of objects (OrderTenantUpdateIn)

同行者情報

Responses

Request samples

Content type
application/json
{
  • "orgId": "5dc02d9557a9445018f12605",
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "orderId": "EAIQNXSBZ",
  • "orderSource": "楽天トラベル",
  • "channelOrderNo": "123456789",
  • "userId": "5fe15ae6bb2f0c41e382c7c1",
  • "checkin": 1635832800,
  • "checkout": 1635901200,
  • "orderContact": "山田太郎",
  • "contactAddress": "千葉県千葉市美浜区",
  • "contactCertificateNum": "21634161354",
  • "contactCountry": "CN",
  • "contactEmail": "1261117576@qq.com",
  • "contactGender": "M",
  • "contactPinyin": "lxy",
  • "contactTel": "090-1234-5678",
  • "customerNum": 1,
  • "maleNum": 0,
  • "femaleNum": 0,
  • "payTypeCode": "stripeCreditCard",
  • "paymentMethod": "pm_1JwKcOInYjCWEx8ccnE5Ljkd",
  • "earlyTime": 30,
  • "extendTime": 15,
  • "commodityList": [
    ],
  • "payList": [
    ],
  • "unitNum": 2,
  • "unitList": [
    ],
  • "tenantList": []
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

予約一覧取得

指定条件より、予約一覧を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

fromDate
required
integer

開始日
UNIX時間（秒）で指定します

toDate
required
integer

終了日
UNIX時間（秒）で指定します

isAssigned
string

割当フラグ
null:未設定、0:未割当、1:割当済み

total
integer

トータル区分
0:すべて、1:（キャンセル・チェックアウト）以外

searchWord
string

検索キーワード

orderStateCodeList
Array of strings

注文ステータス
配列である。"Q":予約申込、"B":予約拒否、"A":未チェックイン、 "C":キャンセル済み、 "I":チェックイン済み、 "M":メンテ中、"O":チェックアウト済み

payStateCodeList
Array of strings

支払ステータス
配列である。"0":未支払、"2":支払中、"30":一部支払済、"20":支払完了、"40":支払失敗

stateType
integer

注文ステータス
"0":通常、"1":重要

count
required
integer

１ページ件数

page
integer

ページ番号

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "fromDate": 1635832800,
  • "toDate": 1635901200,
  • "isAssigned": "1",
  • "total": 0,
  • "searchWord": "埼玉",
  • "orderStateCodeList": [
    ],
  • "payStateCodeList": [
    ],
  • "stateType": 2,
  • "count": 20,
  • "page": 0
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

予約詳細取得

予約の詳細情報を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

unitId
string

ドアID

orderId
required
string

注文番号

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dc02d9557a9445018f12605",
  • "unitId": "5db10292ef16f96af51b7b73",
  • "orderId": "EAIQNXSBZ"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

チェックイン

利用開始前に、チェックイン処理を実施します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

orderId
required
string

注文番号

unitId
required
string

ドアID

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "orderId": "EAIQNXSBZ",
  • "unitId": "5db10292ef16f96af51b7b73"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": 1
}

チェックアウト

利用終了後に、チェックアウト処理を実施します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

orderId
required
string

注文番号

unitId
required
string

ドアID

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "orderId": "EAIQNXSBZ",
  • "unitId": "5db10292ef16f96af51b7b73"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": 1
}

予約キャンセル

予約をキャンセルします。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

placeId
required
string

場所ID

orderId
required
string

注文番号

Responses

Request samples

Content type
application/json
{
  • "placeId": "5dbab6b4ef16f9770d09a550",
  • "orderId": "EAIQNXSBZ"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": 1
}

空き部屋一覧取得

場所内の空き部屋一覧を取得します。

header Parameters
x-target-host
required
string

default.pms

date
required
string

RFC-1123 Ex: Mon, 20 Sep 2021 13:16:39 GMT

digest
required
string

Sha256 summary of the body part (base64 encoding)

authorization
required
string

Hmac256 authentication header

Request Body schema: application/json
required

入力パラメータ

fromTime
required
integer

from時間
UNIX時間（秒）で返却されます

toTime
required
integer

to時間
UNIX時間（秒）で返却されます

placeId
string

場所ID

Responses

Request samples

Content type
application/json
{
  • "fromTime": 1652976000,
  • "toTime": 1653062400,
  • "placeId": "60d044901d9b6750a89c8a83"
}

Response samples

Content type
application/json
{
  • "code": "0",
  • "msg": "success",
  • "data": {
    }
}

©2025 KEYVOX