コンテンツにスキップ

Device KVSの追加

ネームスペースにDevice KVSを追加します。

※ネームスペースは、APIキーのネームスペースになります。

Device KVSのKeyは、ネームスペース内で一意になります。

Valueの書式はJSONです。末尾のカンマ、単一引用符(')はエラーになります。

セキュリティ対策

Valueに重要な情報、個人情報などを登録する場合は、事前に暗号化してから登録してください。

APIキーに必要な権限

DKVS : CREATE

メソッド

POST

URL

/v1/dkvs

URLパラメータ

Content-Type: application/json
パラメータ名 必須 内容
device_type 数値 デバイスの種類。
0: YubiKey(デフォルト)
1: OATH
2: FIDO
3: NJS ATKey
device_id 文字列 デバイスのID。
key 文字列 KVSのKey。
value 文字列 KVSのValue(JSON形式)。

リクエスト例

curl \
  -X POST \
  -H "X-DAUTH-API-KEY: <API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{"device_type": 0, "device_id":"xxxxxxxxxxxx", "key":"key1234", "value":"{\"type\":\"car\",\"color\":\"red\"}}' \
  "https://api.d-auth.com/v1/dkvs"
  • <API-KEY> : 使用するAPIキー

レスポンス例

ステータスライン / レスポンスヘッダ

HTTP/1.1 200 OK 
Content-Type:application/json;charset=utf-8 

レスポンスボディ

{
    "key": "key1234",
    "device_type": 0,
    "device_id": "xxxxxxxxxxxx",
    "value": {
        "type": "car",
        "color": "red"
    },
    "created_at": "2020-10-30 10:10:00"
} 
  • device_id : デバイスID

エラーレスポンス

詳細はこちらをご参照ください。