Recherche, identification et enrichissement
Enrichissement
Le meilleur moyen d'obtenir des données sur un périphérique Apple consiste à utiliser l'appel de lookup pour enrichir les données. Cela est particulièrement efficace pour les recherches sur des données série et IMEI et permet de renvoyer beaucoup de données de périphérique associées. Si vous devez simplement obtenir des propriétés pour un identifiant donné, consultez la section Recherche classique ci-dessous.
C'est son format de requête: https://di-api.reincubate.com/v2/lookup/
Il y a deux façons d'accéder à cette fonctionnalité.
Récapitulatif des demandes à l'aide de GET
Une recherche peut être effectuée avec une requête au format https://di-api.reincubate.com/v2/lookup/[IDENTIFIER-VALUE]/
Cela fournit un moyen simple d'accéder aux données DeviceIdentifier. Cependant, cela repose sur l'identification automatique des types de valeur et ne fournira pas toujours autant de données qu'une demande POST plus complète.
Requêtes complètes via POST
Pour les utiliser, l'API doit recevoir une demande POST de données JSON similaire à celle-ci:
{ "primary": { "identifier": "iPhone5,2", "type": "apple_identifier" }, "additional": [{ "identifier": "F2TK4TZ7DTWF", "type": "apple_serial" },{ "identifier": "013554006297015", "type": "gsma_imei" },{ "identifier": "8965880812100011146", "type": "gsma_iccid" }] }
Dans cette structure JSON, la valeur de l' identifier principal est obligatoire et doit représenter un numéro de série Apple, un numéro IMEI ou un modèle.
Le passage de valeurs de type est facultatif, mais il protège contre les collisions potentielles. Toute valeur de type documentée dans les sections d'identificateurs pris en charge de cette documentation est acceptable pour une valeur de type. Ainsi, dans sa forme la plus simple, une demande valide pourrait ressembler à ceci:
{ "primary": { "identifier": "DMPRC0P8H1MD" } }
Le dictionnaire additional est également entièrement facultatif. Cependant, ces valeurs permettent à l'API de limiter les résultats et de fournir des réponses plus précises. Il est fortement recommandé d'envoyer autant de données supplémentaires que disponibles pour un périphérique.
L'API renverra les données dans un format uniforme, comme décrit dans la section relative aux identificateurs pris en charge dans sa réponse.
Exemples
{ "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", "carrier": "O2", "carrier_country": "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, "sale_region": "United States", "sale_format": "Personalised" } }, "software": { "shipped": "10.3.3", "name": "iOS", "latest": "10.3.4" } }
Chercher
L'API fournit une fonctionnalité permettant de rechercher les détails d'un identifiant donné. L'appel de recherche est RESTful et prend le format suivant:
https://di-api.reincubate.com/v1/*[IDENTIFIER-TYPE]*/*[IDENTIFIER-VALUE]*/
Consultez les sections relatives aux identificateurs pris en charge pour plus d'informations sur les formats d'identificateur pris en charge.
Exemples
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" }
Identification
L'API fournit une fonctionnalité permettant d'identifier un identifiant inconnu. L'appel de recherche est RESTful et prend le format suivant:
https://di-api.reincubate.com/v1/identify-identifier/*[IDENTIFIER-VALUE]*/
Consultez les sections relatives aux identificateurs pris en charge pour plus d'informations sur les formats d'identificateur pris en charge.
Exemples
https://di-api.reincubate.com/v1/identify-identifier/iPhone5,3/
$ python -m deviceidentifier.cli.identify_identifier iPhone5,3
{ "iPhone5,3": [ "apple_identifier" ] }
