Opzoeken, identificeren en verrijken
verrijking
De beste manier om gegevens op een Apple-apparaat te krijgen, is door de lookup te gebruiken om gegevens te verrijken. Dit is met name effectief bij het zoeken naar seriële en IMEI-gegevens en kan veel gerelateerde apparaatgegevens retourneren. Als u eenvoudigweg eigenschappen voor een bepaalde ID wilt verkrijgen, raadpleegt u de klassieke sectie Opzoeken hieronder.
Dit is het verzoekformaat: https://di-api.reincubate.com/v2/lookup/
Er zijn twee manieren om toegang te krijgen tot deze functionaliteit.
Samenvattingsverzoeken met behulp van GET
Een opzoeking kan worden uitgevoerd met een verzoek in het formaat zoals https://di-api.reincubate.com/v2/lookup/[IDENTIFIER-VALUE]/
Dit biedt een eenvoudige manier om toegang te krijgen tot DeviceIdentifier-gegevens. Dit is echter afhankelijk van automatische identificatie van waardetypes en levert niet altijd zoveel gegevens op als een vollediger POST verzoek.
Volledige aanvragen met POST
Om deze te gebruiken, moet de API een POST-verzoek met JSON-gegevens ontvangen, vergelijkbaar met het volgende:
{ "primary": { "identifier": "iPhone5,2", "type": "apple_identifier" }, "additional": [{ "identifier": "F2TK4TZ7DTWF", "type": "apple_serial" },{ "identifier": "013554006297015", "type": "gsma_imei" },{ "identifier": "8965880812100011146", "type": "gsma_iccid" }] }
In deze JSON-structuur is de primaire identifier verplicht en moet deze een Apple serienummer, IMEI of model vertegenwoordigen.
Passing type waarden is optioneel, maar het beschermt tegen mogelijke botsingen. Elke type is gedocumenteerd in de ondersteunde identificatiegedeelten van deze documentatie is acceptabel voor een typewaarde. Dus op zijn eenvoudigst zou een geldig verzoek er zo uit kunnen zien:
{ "primary": { "identifier": "DMPRC0P8H1MD" } }
Het additional woordenboek is ook volledig optioneel. Met deze waarden kan de API de resultaten echter beperken en zorgen voor een grotere nauwkeurigheid in de antwoorden. Het wordt ten zeerste aanbevolen om zoveel extra gegevens te verzenden als beschikbaar zijn voor een apparaat.
De API retourneert gegevens in een uniform formaat zoals beschreven in de ondersteunde identificatiegedeelte in haar antwoord.
Voorbeelden
{ "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" } }
Opzoeken
De API biedt functionaliteit voor het opzoeken van details voor een gegeven identifier. De opzoekaanroep is RESTful en heeft de volgende indeling:
https://di-api.reincubate.com/v1/*[IDENTIFIER-TYPE]*/*[IDENTIFIER-VALUE]*/
Raadpleeg de secties met ondersteunde ID's voor informatie over de ondersteunde ID-indelingen.
Voorbeelden
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" }
Identificatie
De API biedt functionaliteit om een onbekende identifier te identificeren. De opzoekaanroep is RESTful en heeft de volgende indeling:
https://di-api.reincubate.com/v1/identify-identifier/*[IDENTIFIER-VALUE]*/
Raadpleeg de secties met ondersteunde ID's voor informatie over de ondersteunde ID-indelingen.
Voorbeelden
https://di-api.reincubate.com/v1/identify-identifier/iPhone5,3/
$ python -m deviceidentifier.cli.identify_identifier iPhone5,3
{ "iPhone5,3": [ "apple_identifier" ] }
