Renovar Associação do Dispositivo
Atualização em lote da expiração da associação de dispositivos com correspondência flexível e modos de renovação.
/api/device/membership/renewParâmetros da Requisição
Todos os parâmetros podem ser passados via Query ou Body
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
token | string | Obrigatório | Token de API do usuário Exemplo: your_api_token_here |
mode | string | Opcional | Modo de renovação: estender, definir ou permanente. O padrão é definir quando expire_time é fornecido, caso contrário, estender extendsetpermanent Exemplo: extend |
base | string | Opcional | Base de extensão: automático, atual ou agora autocurrentnow Exemplo: auto |
days | number | Opcional | Dias a adicionar no modo de extensão Exemplo: 30 |
seconds | number | Opcional | Segundos a adicionar no modo de extensão. Maior prioridade que dias Exemplo: 2592000 |
duration | string | Opcional | Expressão de duração: 30d, 12h, 60m ou 3600s Exemplo: 30d |
expire_time | number | Opcional | Novo timestamp de expiração para o modo definir, em segundos ou milissegundos. 0 significa permanente Exemplo: 1772267945 |
kid | string | Opcional | KID de dispositivo único Exemplo: KID001 |
udid | string | Opcional | UDID de dispositivo único Exemplo: 00008030-001234567890002E |
kids | array | Opcional | Array de dispositivos KID. Strings separadas por vírgula/espaço/linha nova também são suportadas Exemplo: KID001,KID002 |
udids | array | Opcional | Array de dispositivos UDID. Se um UDID tiver múltiplos certificados, match=all atualiza todos por padrão. Strings separadas por vírgula/espaço/linha nova também são suportadas Exemplo: 00008030-001234567890002E |
items | array | Opcional | Itens de lote avançados. Cada item pode incluir kid ou UDID e substituir modo/base/dias/segundos/duração/tempo_de_expiração Exemplo: [{"kid":"KID001","mode":"extend","days":30},{"udid":"00008030-001234567890002E","mode":"permanent"}] |
match | string | Opcional | Manipulação de múltiplos matches: all, first ou error. Padrão all allfirsterror Exemplo: all |
continue_on_error | boolean | Opcional | Se deve continuar após a falha de um item. Padrão verdadeiro Exemplo: true |
Resposta
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
code | number | Obrigatório | Código de status: 1=solicitação processada Exemplo: 1 |
data.total | number | Obrigatório | Número de itens de dispositivo solicitados Exemplo: 2 |
data.success | number | Obrigatório | Contagem de renovações bem-sucedidas Exemplo: 2 |
data.failed | number | Obrigatório | Contagem de renovações falhadas Exemplo: 0 |
data.results[].kid | string | Obrigatório | KID do dispositivo Exemplo: KID001 |
data.results[].old_expire_time | number | Obrigatório | Carimbo de data/hora de expiração da associação anterior. 0 significa permanente Exemplo: 1769675945 |
data.results[].new_expire_time | number | Obrigatório | Novo carimbo de data/hora de expiração da associação. 0 significa permanente Exemplo: 1772267945 |
data.results[].new_expire_at | string | Obrigatório | Novo tempo de expiração formatado Exemplo: 2026-02-28 15:04:05 |
Extensão em lote de 30 dias por KID
Use KIDs separados por vírgula com modo de extensão
Extensão em lote por UDID
Para cenários onde apenas UDIDs estão disponíveis. Vários certificados sob um UDID são atualizados por padrão
Definir tempo de expiração explícito
Use mode=set para definir um carimbo de data/hora de expiração de associação explícito
Tornar permanente
Use mode=permanent para tornar a associação permanente
Estratégia por dispositivo
Cada item pode substituir as opções globais de renovação
Atualize apenas a correspondência mais recente para um UDID
Com match=first, apenas o certificado mais recente correspondente sob o mesmo UDID é atualizado
Códigos de Erro
122021X-Lang: enzh, en, zh-TW, vi, arExemplos de Código
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
}'Notas
- Esta API apenas atualiza a validade da associação do dispositivo/baixa do certificado. Não realiza nova assinatura nem cobra saldo
- 0 significa permanente. No modo de extensão, dispositivos permanentes permanecem permanentes por padrão; use base=now para forçar uma expiração finita
- Quando um UDID corresponde a vários certificados, match=all atualiza todos por padrão. Use first ou error para alterar o comportamento
- São suportadas requisições JSON e de formulário. Itens de formulário podem ser uma string de array JSON
Tente no Console
Preencha os parâmetros abaixo e envie uma solicitação para testar. As solicitações vão apenas para a API deste site; a URL está bloqueada e não pode ser alterada, e seu cookie de login atual é incluído.
https://testypro.iwai.cc/api/device/membership/renewBloqueado para este siteToken de API do usuário
Modo de renovação: estender, definir ou permanente. O padrão é definir quando expire_time é fornecido, caso contrário, estender
Base de extensão: automático, atual ou agora
Dias a adicionar no modo de extensão
Segundos a adicionar no modo de extensão. Maior prioridade que dias
Expressão de duração: 30d, 12h, 60m ou 3600s
Novo timestamp de expiração para o modo definir, em segundos ou milissegundos. 0 significa permanente
KID de dispositivo único
UDID de dispositivo único
Array de dispositivos KID. Strings separadas por vírgula/espaço/linha nova também são suportadas
Array de dispositivos UDID. Se um UDID tiver múltiplos certificados, match=all atualiza todos por padrão. Strings separadas por vírgula/espaço/linha nova também são suportadas
Itens de lote avançados. Cada item pode incluir kid ou UDID e substituir modo/base/dias/segundos/duração/tempo_de_expiração
Manipulação de múltiplos matches: all, first ou error. Padrão all
Se deve continuar após a falha de um item. Padrão verdadeiro