Pesquisa, identificação e enriquecimento

Atualizada

Enriquecimento

A melhor maneira de obter dados em um dispositivo Apple é usando a chamada de lookup para enriquecer os dados. Isso é particularmente eficaz para pesquisas em dados seriais e IMEI e pode retornar muitos dados relacionados ao dispositivo. Se você simplesmente precisar obter propriedades para um determinado identificador, consulte a seção Pesquisa clássica abaixo.

Este é o seu formato de solicitação: https://di-api.reincubate.com/v2/lookup/

Existem duas maneiras de acessar essa funcionalidade.

Solicitações de resumo usando GET

Uma pesquisa pode ser realizada com uma solicitação no formato https://di-api.reincubate.com/v2/lookup/[IDENTIFIER-VALUE]/

Isso fornece uma maneira simples de acessar dados do DeviceIdentifier. No entanto, isso depende da identificação automática de tipos de valor e nem sempre fornece tantos dados quanto uma solicitação POST mais completa.

Solicitações completas usando POST

Para usá-los, a API deve receber uma solicitação POST de dados JSON semelhante à seguinte:

{
  "primary": {
    "identifier": "iPhone5,2",
    "type": "apple_identifier"
  },
  "additional": [{
    "identifier": "F2TK4TZ7DTWF",
    "type": "apple_serial"
  },{
    "identifier": "013554006297015",
    "type": "gsma_imei"
  },{
    "identifier": "8965880812100011146",
    "type": "gsma_iccid"
  }]
}

Nesta estrutura JSON, o valor do identifier primário é obrigatório e deve representar um número de série, IMEI ou modelo da Apple.

A passagem de valores de type é opcional, mas protege contra possíveis colisões. Qualquer valor de type documentado nas seções de identificadores suportados desta documentação é aceitável para um valor de tipo. Assim, na sua forma mais simples, uma solicitação válida pode ser assim:

{
  "primary": {
      "identifier": "DMPRC0P8H1MD"
  }
}

O dicionário additional também é totalmente opcional. No entanto, esses valores permitem que a API reduza os resultados e forneça maior precisão em suas respostas. É altamente recomendável enviar tantos dados adicionais quanto disponíveis para um dispositivo.

A API retornará dados em um formato uniforme, conforme descrito na seção de identificadores suportados em sua resposta.

Exemplos

{
  "primary": {
    "identifier": "iPhone5,2",
    "type": "apple_identifier"
  },
  "additional": [{
    "identifier": "F2TK4TZ7DTWF",
    "type": "apple_serial"
  },{
    "identifier": "013554006297015",
    "type": "gsma_imei"
  },{
    "identifier": "8965880812100011146",
    "type": "gsma_iccid"
  }]
}
{
    "warranty": {
        "url": "https://checkcoverage.apple.com/gb/en?sn=F2TK4TZ7DTWF",
        "apple_care_status": "LIKELY_EXPIRED",
        "apple_care_plus_status": "GSX_REQUIRED"
    },
    "production": {
        "week": "2013-01-22",
        "city": "Zhengzhou",
        "company": "Foxconn",
        "country": "China"
    },
    "hardware": {
        "model": "N42",
        "revision": [
            {
                "platform": "s5l8950x",
                "name": "N42AP",
                "cpid": 35152,
                "bdid": 2
            }
        ]
    },
    "meta": {
        "account": 34,
        "primary_identifier_type": "apple_identifier",
        "timestamp": "2019-11-04T13:11:04.605882",
        "results_narrowed_by_additional_identifiers": true,
        "primary_identifier": "iPhone5,2",
        "credits_remaining": -1,
        "cache_status": "UNCACHED"
    },
    "mobile": {
        "serial": "629701",
        "registration_country": "CTIA (PTCRB)",
        "reporting_body": "United States"
    },
    "marketing": {
        "images": [
            {
                "url": "https://di-api.reincubate.com/resource-d47c4d432532037b31e69be8fbc66dcb/",
                "width": 450,
                "height": 330
            },
            {
                "url": "https://di-api.reincubate.com/resource-4cb3c6fe7c62f327cd11712196c221b0/",
                "width": 120,
                "height": 120
            }
        ],
        "names": [
            "iPhone 5",
            "iPhone 5 (GSM, CDMA)"
        ]
    },
    "security": {
        "primary_identifier_anonymised": "F2TK4•••DTWF",
        "identifier_fraud": {
            "code": "ADDITIONAL_MISSING",
            "message": "Fraud scoring requires use of the `additional` parameter in your request.",
            "score": 0
        }
    },
    "valuation": {
        "resale": [
            {
                "url": "https://www.apple.com/shop/trade-in",
                "vendor": "official_tradein",
                "value": "$0.00"
            }
        ],
        "retail": []
    },
    "specification": {
        "configuration_code": [
            {
                "colour": null,
                "code": "DTWF",
                "storage": "16 GB"
            }
        ],
        "mpn": [
            {
                "factory_lock": "UNKNOWN",
                "colour": "Silver",
                "code": "D298",
                "storage": "16 GB",
                "distribution": null
            },
            {
                "factory_lock": "UNKNOWN",
                "colour": "Black",
                "code": "D297",
                "storage": "16 GB",
                "distribution": null
            }
        ],
        "type_allocation_code": [],
        "family": [],
        "summary": {
            "factory_lock": null,
            "colour": null,
            "storage": "16 GB",
            "url": "https://support.apple.com/kb/SP655",
            "unique_to_region": null,
            "distribution": null
        }
    },
    "software": {
        "shipped": "10.3.3",
        "name": "iOS",
        "latest": "10.3.4"
    }
}

Olho para cima

A API fornece funcionalidade para pesquisar detalhes de um determinado identificador. A chamada de pesquisa é RESTful e aceita o seguinte formato:

https://di-api.reincubate.com/v1/*[IDENTIFIER-TYPE]*/*[IDENTIFIER-VALUE]*/

Consulte as seções de identificadores suportados para obter informações sobre os formatos de identificadores suportados.

Exemplos

https://di-api.reincubate.com/v1/apple-identifiers/iPhone5,3/

$ python -m deviceidentifier.cli.apple_identifier iPhone5,3
{
    "id": "iPhone5,3",
    "image": {
        "height": 330,
        "url": "https://di-api.reincubate.com/resource-775ac9634280be8d7dfb0b75b4727f69/",
        "width": 450
    },
    "product": {
        "line": "iPhone",
        "sku": "iPhone 5c"
    },
    "variant": "GSM + CDMA"
}

Identificação

A API fornece funcionalidade para identificar um identificador desconhecido. A chamada de pesquisa é RESTful e aceita o seguinte formato:

https://di-api.reincubate.com/v1/identify-identifier/*[IDENTIFIER-VALUE]*/

Consulte as seções de identificadores suportados para obter informações sobre os formatos de identificadores suportados.

Exemplos

https://di-api.reincubate.com/v1/identify-identifier/iPhone5,3/

$ python -m deviceidentifier.cli.identify_identifier iPhone5,3
{
    "iPhone5,3": [
        "apple_identifier"
    ]
}
wzxhzdk: 70 As chamadas para a API por meio deste cliente tornam-se fáceis: wzxhzdk: 71 wzxhzdk: 72 ->

Como podemos ajudar?

Nossa equipe de suporte está aqui para ajudar!

Nosso horário de atendimento é de segunda a sexta, das 9h às 17h GMT. A hora é atualmente 10:22 PM GMT.

Nosso objetivo é responder a todas as mensagens dentro de um dia útil.

Vá para a seção de apoio › Entre em contato com a equipe da empresa ›
Nossa equipe de suporte incrível

Podemos melhorar este artigo?

Adoramos ouvir os usuários: por que não nos enviar um e-mail, deixar um comentário ou twittar? @reincubate?

© 2008 - 2019 Reincubate Ltd. Todos os direitos reservados. Registrado na Inglaterra e no País de Gales #5189175, VAT GB151788978. Reincubate® é uma marca registrada. Privacidade e Termos. Recomendamos 2FA. Construído com em Londres.