ホームへ戻るAPI ドキュメント
言語: 日本語
简体中文English繁體中文Tiếng Việtالعربية日本語한국어ไทยBahasa IndonesiaBahasa MelayuPortuguêsEspañolFrançaisDeutschРусскийTürkçeहिन्दी
ドキュメントに戻る
POST
v1.1.0stable

デバイス会員期限更新

柔軟なマッチングと更新モードでデバイスメンバーシップの有効期限を一括更新します。

POST/api/device/membership/renew
auth:API Key
制限:30/分

リクエストパラメータ

すべてのパラメータは、クエリまたは本文を介して渡すことができます

パラメータータイプ必須内容
token
string必須
API トークン
例: your_api_token_here
mode
stringオプション
更新モード：拡張、設定、または恒久。EXPIRE_TIMEが指定されている場合はデフォルトで設定されます。それ以外の場合は拡張されます。
extendsetpermanent
例: extend
base
stringオプション
ベースを拡張：自動、現在、または現在
autocurrentnow
例: auto
days
numberオプション
拡張モードで追加する日数
例: 30
seconds
numberオプション
拡張モードで追加する秒数。日よりも優先度が高い
例: 2592000
duration
stringオプション
持続時間式： 30日、12時間、60分、または3600秒
例: 30d
expire_time
numberオプション
設定モード、秒またはミリ秒の新しい有効期限タイムスタンプ。0は永続的を意味します
例: 1772267945
kid
stringオプション
シングルデバイスキッド
例: KID001
udid
stringオプション
単一デバイスUDID
例: 00008030-001234567890002E
kids
arrayオプション
デバイスキッドアレイ。カンマ/スペース/改行区切り文字列もサポートされています
例: KID001,KID002
udids
arrayオプション
デバイスUDID配列。1つのUDIDに複数の証明書がある場合、デフォルトですべての更新が一致します。カンマ/スペース/改行区切りの文字列もサポートされています
例: 00008030-001234567890002E
items
arrayオプション
高度なバッチアイテム。各アイテムには、KIDまたはUDID、およびオーバーライドモード/BASE/DAYS/SECONDS/DURATION/EXPIRE_TIMEを含めることができます
例: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}]
match
stringオプション
複数一致処理： all、first、またはerror。デフォルトはall
allfirsterror
例: all
continue_on_error
booleanオプション
アイテムが失敗した後に続行するかどうか。デフォルトはtrue
例: true

回答

パラメータータイプ必須内容
code
number必須
ステータスコード： 1 =リクエストが処理されました
例: 1
data.total
number必須
リクエストされたデバイスアイテムの数
例: 2
data.success
number必須
正常に更新されたカウント
例: 2
data.failed
number必須
更新に失敗した回数
例: 0
data.results[].kid
string必須
デバイスキッド
例: KID001
data.results[].old_expire_time
number必須
以前のメンバーシップの有効期限のタイムスタンプ。0は永久を意味します
例: 1769675945
data.results[].new_expire_time
number必須
新しいメンバーシップの有効期限のタイムスタンプ。0は永続的を意味します
例: 1772267945
data.results[].new_expire_at
string必須
フォーマットされた新しい有効期限
例: 2026-02-28 15:04:05
応答例
{
"code":1,
"msg":"デバイスメンバーシップの更新が処理されました",
"time":1769675945,
"data":
{
"total":2,
"processed_results":2,
"success":2,
"failed":0,
"continue_on_error":true,
"match":"all",
"results":
[
{
"index":0,
"kid":"KID001",
"udid":"00008030-001234567890002E",
"success":true,
"code":1,
"msg":"续期成功",
"old_expire_time":1769675945,
"new_expire_time":1772267945,
"old_expire_at":"2026-01-29 15:04:05",
"new_expire_at":"2026-02-28 15:04:05",
"changed":true,
"matched_count":1
}
,
{
"index":1,
"kid":"KID002",
"udid":"00008030-009876543210002E",
"success":true,
"code":1,
"msg":"续期成功",
"old_expire_time":0,
"new_expire_time":0,
"old_expire_at":"permanent",
"new_expire_at":"permanent",
"changed":false,
"matched_count":1
}
]
}
,
"ip":"192.168.1.100",
"ysucc":"Ysucc"
}

お子様による30日間の一括延長

拡張モードでカンマ区切りの子供を使用する

お子様による30日間の一括延長
{
"token":"your_api_token_here",
"kids":"KID001,KID002",
"mode":"extend",
"days":30
}

Batch extend by UDID

UDIDのみが使用可能なシナリオの場合。1つのUDIDの下にある複数の証明書は、デフォルトで更新されます

Batch extend by UDID
{
"token":"your_api_token_here",
"udids":"00008030-001234567890002E,00008030-009876543210002E",
"mode":"extend",
"duration":"60d"
}

明示的な有効期限を設定する

明示的なメンバーシップの有効期限タイムスタンプを設定するには、mode = setを使用します

明示的な有効期限を設定する
{
"token":"your_api_token_here",
"kid":"KID001",
"mode":"set",
"expire_time":1772267945
}

パーマネントを設定

メンバーシップを恒久的にするには、mode = permanentを使用します

パーマネントを設定
{
"token":"your_api_token_here",
"kid":"KID001",
"mode":"permanent"
}

デバイスごとの戦略

各アイテムは、グローバル更新オプションを上書きできます

デバイスごとの戦略
{
"token":"your_api_token_here",
"items":
[
{
"kid":"KID001",
"mode":"extend",
"days":30
}
,
{
"kid":"KID002",
"mode":"set",
"expire_time":1772267945
}
,
{
"udid":"00008030-001234567890002E",
"mode":"permanent"
}
]
}

UDIDの最新の一致のみを更新する

Match = firstの場合、同じUDIDの下の最新の一致証明書のみが更新されます

UDIDの最新の一致のみを更新する
{
"token":"your_api_token_here",
"udid":"00008030-001234567890002E",
"mode":"extend",
"days":30,
"match":"first"
}

エラーコード

エラーコード4 defined
12
トークンは必須です。
トークンパラメーターがありません
20
少なくとも1つのデバイスを提供してください
行方不明のお子様、お子様、UDID、UDID、またはアイテム
21
無効なモード、有効な値： extend/set/permanent
無効な更新モード

X-Lang: en
zh, en, zh-TW, vi, ar

コード例

curl -X POST "https://testypro.iwai.cc,https://cer.xyul.cn,https://cer.iwai.cc/api/device/membership/renew" \
  -H "X-Lang: en" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "your_api_token_here",
    "mode": "extend",
    "base": "auto",
    "days": 30,
    "seconds": 2592000,
    "duration": "30d",
    "expire_time": 1772267945,
    "kid": "KID001",
    "udid": "00008030-001234567890002E",
    "kids": "KID001,KID002",
    "udids": "00008030-001234567890002E",
    "items": "[{\"kid\":\"KID001\",\"mode\":\"extend\",\"days\":30},{\"udid\":\"00008030-001234567890002E\",\"mode\":\"permanent\"}]",
    "match": "all",
    "continue_on_error": true
  }'

注

  • このAPIは、デバイスのメンバーシップ/証明書のダウンロードの有効期限のみを更新します。再署名や残高の請求は行われません
  • 0は永続的を意味します。拡張モードでは、永続的なデバイスはデフォルトで永続的なままです。base = nowを使用して、有効期限を強制します
  • UDIDが複数の証明書と一致する場合、MATCH =デフォルトですべて更新されます。最初に使用するか、エラーを使用して行動を変更します
  • JSONとフォーム要求の両方がサポートされています。フォーム項目はJSON配列文字列にすることができます

コンソールでお試しください

以下のパラメータを入力し、テストのリクエストを送信します。リクエストはこのサイトのAPIにのみ行きます。URLはロックされており、変更することはできません。現在のログインCookieが含まれています。

POSThttps://testypro.iwai.cc/api/device/membership/renewこのサイトにロックされています
string必須

API トークン

string

更新モード：拡張、設定、または恒久。EXPIRE_TIMEが指定されている場合はデフォルトで設定されます。それ以外の場合は拡張されます。

string

ベースを拡張：自動、現在、または現在

number

拡張モードで追加する日数

number

拡張モードで追加する秒数。日よりも優先度が高い

string

持続時間式： 30日、12時間、60分、または3600秒

number

設定モード、秒またはミリ秒の新しい有効期限タイムスタンプ。0は永続的を意味します

string

シングルデバイスキッド

string

単一デバイスUDID

array

デバイスキッドアレイ。カンマ/スペース/改行区切り文字列もサポートされています

array

デバイスUDID配列。1つのUDIDに複数の証明書がある場合、デフォルトですべての更新が一致します。カンマ/スペース/改行区切りの文字列もサポートされています

array

高度なバッチアイテム。各アイテムには、KIDまたはUDID、およびオーバーライドモード/BASE/DAYS/SECONDS/DURATION/EXPIRE_TIMEを含めることができます

string

複数一致処理： all、first、またはerror。デフォルトはall

boolean

アイテムが失敗した後に続行するかどうか。デフォルトはtrue