Ricerca, identificazione e arricchimento

aggiornato

arricchimento

Il modo migliore per ottenere dati su un dispositivo Apple è utilizzare la chiamata di lookup per arricchire i dati. Ciò è particolarmente efficace per le ricerche su dati seriali e IMEI ed è in grado di restituire molti dati relativi al dispositivo. Se hai semplicemente bisogno di ottenere proprietà per un determinato identificatore, consulta la sezione Ricerca classica di seguito.

Questo è il suo formato di richiesta: https://di-api.reincubate.com/v2/lookup/

Esistono due modi per accedere a questa funzionalità.

Richieste di riepilogo tramite GET

Una ricerca può essere eseguita con una richiesta nel formato come https://di-api.reincubate.com/v2/lookup/[IDENTIFIER-VALUE]/

Ciò fornisce un modo semplice per accedere ai dati DeviceIdentifier. Tuttavia, ciò si basa sull'identificazione automatica dei tipi di valore e non fornirà sempre tutti i dati di una richiesta POST più completa.

Richieste complete utilizzando POST

Per usarli, l'API deve ricevere una richiesta POST di dati JSON simili ai seguenti:

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

In questa struttura JSON, il valore identifier principale è obbligatorio e deve rappresentare un numero seriale Apple, un IMEI o un modello.

Il passaggio di valori di type è facoltativo, ma protegge da potenziali collisioni. Qualsiasi valore di type documentato nelle sezioni degli identificatori supportati di questa documentazione è accettabile per un valore di tipo. Pertanto, nella sua forma più semplice, una richiesta valida potrebbe apparire così:

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

Il dizionario additional è anche del tutto facoltativo. Tuttavia, questi valori consentono all'API di restringere i risultati e fornire una maggiore precisione nelle sue risposte. Si consiglia vivamente di inviare tutti i dati aggiuntivi disponibili per un dispositivo.

L'API restituirà i dati in un formato uniforme come descritto nella sezione identificatori supportati nella sua risposta.

Esempi

{
  "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"
    }
}

Consultare

L'API fornisce funzionalità per cercare i dettagli per un dato identificatore. La chiamata di ricerca è RESTful e assume il seguente formato:

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

Consultare le sezioni degli identificatori supportati per informazioni sui formati identificativi supportati.

Esempi

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"
}

Identificazione

L'API fornisce funzionalità per identificare un identificatore sconosciuto. La chiamata di ricerca è RESTful e assume il seguente formato:

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

Consultare le sezioni degli identificatori supportati per informazioni sui formati identificativi supportati.

Esempi

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

$ python -m deviceidentifier.cli.identify_identifier iPhone5,3
{
    "iPhone5,3": [
        "apple_identifier"
    ]
}
wzxhzdk: 70 Le chiamate all'API tramite questo client diventano facili: wzxhzdk: 71 wzxhzdk: 72 ->

Come possiamo aiutare?

Il nostro team di supporto è qui per aiutarti!

I nostri orari di ufficio sono dal lunedì al venerdì, dalle 9:00 alle 17:00 GMT. L'ora è attualmente 10:35 PM GMT.

Miriamo a rispondere a tutti i messaggi entro un giorno lavorativo.

Vai alla sezione di supporto › Contatta il team aziendale ›
Il nostro fantastico team di supporto

Possiamo migliorare questo articolo?

Ci piace ascoltare gli utenti: perché non mandarci un'email, lasciare un commento o twittare @reincubate?

© 2008 - 2019 Reincubate Ltd. Tutti i diritti riservati. Registrato in Inghilterra e Galles #5189175, VAT GB151788978. Reincubate® è un marchio registrato. Termini e Condizioni. Raccomandiamo 2FA. Costruito con a Londra.