Adicionar Dispositivo V2
API unificada para adicionar um único dispositivo. Alterne entre o modo instantâneo e o modo de reserva com um parâmetro, mantendo as APIs legadas disponíveis.
/api/adddevice/v2Parâ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 |
udid | string | Obrigatório | UDID do dispositivo (deve ter 25 ou 40 caracteres) Exemplo: 00008030-001234567890ABCD |
mode | string | Opcional | Modo de adição: instantâneo ou revisão. O padrão é instantâneo instantreview Exemplo: instant |
add_mode | string | Opcional | Apelido do modo. Tem prioridade sobre o modo instantreview Exemplo: review |
force | boolean | Opcional | Forçar flag de adição. true/1/yes/y/on ignora verificações de período de força e de dispositivo existente Exemplo: true |
warranty | string | Opcional | Tipo de garantia: 0/1/2/3/4/6. modo de revisão não suporta 4/6 012346 Exemplo: 1 |
shtype | string | Opcional | Alias legada da garantia, usado apenas quando a garantia está vazia 012346 Exemplo: 1 |
type | string | Opcional | Tipo de pool: 0=público, 1=privado. Padrões seguem a lógica da API legada 01 Exemplo: 0 |
deviceType | string | Opcional | Tipo de dispositivo: iphone ou ipad. Padrão iphone iphoneipad Exemplo: iphone |
beizhu | string | Opcional | Observação Exemplo: 测试设备 |
code | string | Opcional | Código de ativação (opcional) Exemplo: ABC123XYZ |
Resposta
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
code | number | Obrigatório | Código de status: 1=sucesso, 0=falha Exemplo: 1 |
msg | string | Obrigatório | Mensagem de resposta Exemplo: 添加成功 |
data.id | string | Obrigatório | ID do certificado / ID da reserva Exemplo: AB12CD34 |
data.mobileprovision | string | Obrigatório | mobileprovision em Base64. Pode estar vazio enquanto a revisão estiver pendente Exemplo: Base64EncodedString... |
data.p12 | string | Obrigatório | Certificado P12 em Base64 Exemplo: Base64EncodedString... |
Códigos de Erro
000X-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/adddevice/v2" \
-H "X-Lang: en" \
-H "Content-Type: application/json" \
-d '{
"token": "your_api_token_here",
"udid": "00008030-001234567890ABCD",
"mode": "instant",
"add_mode": "review",
"force": true,
"warranty": "1",
"shtype": "1",
"type": "0",
"deviceType": "iphone",
"beizhu": "测试设备",
"code": "ABC123XYZ"
}'Notas
- Legado /API/adddevice e /API/addyydevice permanecem disponíveis e compatíveis
- mode=instant reaproveita a lógica de adição instantânea; mode=review reaproveita a lógica de adição de reserva/revisão
- Query, x-www-form-urlencoded e corpo JSON são suportados; corpo JSON é recomendado para V2
- force=true apenas ignora as verificações locais de período de força/existentes. A Apple ainda pode rejeitar duplicatas
- o modo de revisão ainda segue as restrições da API de reserva, por exemplo, warranty=4/6 não é suportado
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/adddevice/v2?token=your_api_token_here&udid=00008030-001234567890ABCD&mode=instant&add_mode=review&force=true&warranty=1&shtype=1&type=0&deviceType=iphone&beizhu=%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87&code=ABC123XYZBloqueado para este siteToken de API do usuário
UDID do dispositivo (deve ter 25 ou 40 caracteres)
Modo de adição: instantâneo ou revisão. O padrão é instantâneo
Apelido do modo. Tem prioridade sobre o modo
Forçar flag de adição. true/1/yes/y/on ignora verificações de período de força e de dispositivo existente
Tipo de garantia: 0/1/2/3/4/6. modo de revisão não suporta 4/6
Alias legada da garantia, usado apenas quando a garantia está vazia
Tipo de pool: 0=público, 1=privado. Padrões seguem a lógica da API legada
Tipo de dispositivo: iphone ou ipad. Padrão iphone
Observação
Código de ativação (opcional)