Apple-identificaties

Algemene Apple-codes en -codes begrijpen

Apple gebruikt veel verschillende ID's bij hun producten. De onderstaande tabel illustreert de verschillen tussen enkele van de belangrijkste codes:

De API ondersteunt vele andere Apple-ID's, waarvan de meeste hieronder worden beschreven.

Houd er rekening mee dat we Apple GSX-servicegegevens voor sommige clients kunnen vrijgeven.

Apple serienummers

De API ondersteunt alle drie de gestructureerde serienummerformaten van Apple: legacy , 2000 en 2010 . Voorbeelden:

• F4412SAM0001 is een legacy indelingserie (voor de vroege 128k Mac)
• 84021NCV3NP is een serie uit het 2000 formaat
• C8QH6T96DPNG is een seriële vorm uit 2010

Het nieuwste formaat 2021 is samengesteld uit een willekeurige selectie van karakters en kan daarom niet worden gebruikt om aanvullende informatie over een apparaat af te leiden.

https://di-api.reincubate.com/v1/apple-serials/C8QH6T96DPNG/

$ python -m deviceidentifier.cli.apple_serial C8QH6T96DPNG

{
    "anonymised": "C8QH6•••DPNG",
    "configurationCode": {
        "code": "DPNG",
        "appleInternalNameClass": {
            "id": "N92"
        },
        "image": {
            "height": 120,
            "url": "https://di-api.reincubate.com/resource-159c9e87a3d6bbf5075bb030fa2925a0/",
            "width": 120
        },
        "skuHint": "iPhone 4 CDMA (8GB)"
    },
    "coverageUrl": "https://checkcoverage.apple.com/gb/en?sn=C8QH6T96DPNG",
    "id": "C8QH6T96DPNG",
    "manufacturing": {
        "city": "",
        "company": "",
        "country": "China",
        "date": "2012-02-05",
        "flag": "🇨🇳",
        "id": "C8Q"
    },
    "serialType": "2010",
    "uniqueId": {
        "productionNo": 31524,
        "value": "T96"
    }
}

Apple MLB-serienummers

De API ondersteunt de seriële bestandsindelingen van Apple's main logic board (MLB) voor zowel 13- als 17-cijferige codes.

https://di-api.reincubate.com/v1/apple-mlb-serials/C02443500KZG2QDA7/

$ python -m deviceidentifier.cli.apple_mlb_serial C02443500KZG2QDA7

{
    "anonymised": "C02443•••KZ••••••",
    "boardType": "500",
    "cc": "KZ",
    "eeeCode": "G2QD",
    "id": "C02443500KZG2QDA7",
    "kk": "A7",
    "productionPlant": {
        "city": "",
        "company": "Tech Com, Quanta Computer Susidiary",
        "country": "China",
        "date": "2014-10-22",
        "flag": "🇨🇳",
        "id": "C02"
    },
    "serialType": "2010",
    "uniqueId": {
        "id": null,
        "productionNo": null
    }
}

Apple modelnummers (MPN)

Ook bekend als: Marketing Part Number (MPN)

Een modelnummer van Apple identificeert een bepaalde hardwareconfiguratie van een Apple-product. Apple-modelnummers kunnen worden weergegeven met of zonder hun regionale of verkooptypecodering. Deze staan ook bekend als een marketingartikelnummer of MPN. MPN is een verkeerde benaming in de zin dat modelnummers geen echte cijfers zijn.

Modelnummers worden altijd voorafgegaan door een verkoopcode (vaak maar niet noodzakelijkerwijs M ) en volgen meestal met een letter en enkele cijfers. Ze eindigen met een optionele verkoopregio-indicator van variabele lengte.

Wat is er gecodeerd in een Apple-modelnummer?

Apple-modelcodes kunnen de verkoopregio van een apparaat bieden, evenals of het is verkocht in de detailhandel, opgeknapt of gepersonaliseerd, en de volgende gegevens bevatten:

• Apple Interne naamklasse. Dit kan worden gebruikt om het te verkleinen tot een reeks interne namen.
• Apple-identificatie .
• Verkoop regio. Het brede gebied waarvoor het apparaat bedoeld was om te worden verkocht. Dit wordt opgeslagen als een optioneel onderdeel van het nummer.
• Modelspecificatie. MPN's zijn betrouwbaar voor het aanduiden van de grootte, kleur, materiaal en opslag van de behuizing voor iPhones, iPads, Apple Watches en computers.
• OEM-vervoerder. MPN's worden meestal ter beschikking gesteld van een discreet bereik van dragers, en het draaggolfbereik kan worden geïdentificeerd door ze te onderzoeken.
• Verkoop type. d.w.z. of de eenheid werd verkocht als kleinhandel, opgeknapt, vervangen of gepersonaliseerd.

Voorbeeld Modelnummers

Werken met Apple-modelnummers

• Voorbeeld Apple Model Direct API-verzoek: MC605FD / A
• Voorbeeld Apple Model client bibliotheekverzoek:

$ python -m deviceidentifier.cli.apple_model MC605FD/A`

{
    "anonymised": "C605",
    "appleInternalNameClass": {
        "id": "N90"
    },
    "appleIdentifier": {
        "id": "iPhone3,1",
        "image": {
            "height": 330,
            "url": "https://di-api.reincubate.com/resource-26b007e1007180a28e272036775a48a0/",
            "width": 450
        },
        "product": {
            "line": "iPhone",
            "sku": "iPhone 4"
        },
        "specs_page": "https://support.apple.com/kb/SP587",
        "value": {},
        "variant": "GSM"
    },
    "id": "C605",
    "region": {
        "flags": "🇦🇹🇱🇮🇨🇭",
        "name": "Austria, Liechtenstein, Switzerland"
    },
    "specification": {
        "case_size": null,
        "colour": "Black",
        "material": null,
        "storage": "32 GB"
    },
    "distribution": null,
    "factory_lock": 0,
    "type": "Retail"
}

Apple-identificaties

Apple-ID's zijn hun iPhone9,3 hoogste niveau, zoals iPhone9,3 .

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

$ python -m deviceidentifier.cli.apple_identifier iPhone9,3

{
    "id": "iPhone9,3",
    "image": {
        "height": 330,
        "url": "https://di-api.reincubate.com/resource-d8c14fc2a4dfcf27d5a217fb5e4c0cc4/",
        "width": 450
    },
    "product": {
        "line": "iPhone",
        "sku": "iPhone 7"
    },
    "specs_page": "https://support.apple.com/kb/SP743",
    "value": {
        "official_tradein": {
            "url": "https://www.apple.com/shop/trade-in",
            "value": "$175.00"
        }
    },
    "variant": "GSM"
}

Interne namen van Apple

Interne namen zijn de interne modelnummers van Apple, zoals N90AP . Ze worden soms aangeduid als BoardConfig en ook - misleidend - als HardwareModel .

https://di-api.reincubate.com/v1/apple-internal-names/N92AP/

$ python -m deviceidentifier.cli.apple_internal_name N92AP

{
    "id": "N92AP",
    "anonymised": "N92AP",
    "revision": null,

    "appleInternalNameClass": {
        "id": "N92"
    },

    "platform": "s5l8930x",
    "bdid": 6,
    "cpid": 35120,

    "appleIdentifier": {
        "id": "iPhone3,3",
        "image": {
            "height": 330,
            "url": "https://di-api.reincubate.com/resource-1e7820cb714e3d477534f291c0f87e83/",
            "width": 450
        },
        "product": {
            "line": "iPhone",
            "sku": "iPhone 4"
        },
        "variant": "CDMA"
    },

    "firmware": [
        {
            "build": "11D257",
            "filesize": 165768907,
            "ota": true,
            "required_build": "11A465",
            "required_version": "7.0",
            "signed": true,
            "signing_started": "2018-11-01",
            "signing_stopped": null,
            "url": "http://appldnld.apple.com/iOS7.1/031-4897.20140627.JCWhk/d52a3e7a1a2c16c8c400c6829a6d6fe6d5e00760.zip",
            "version": "7.1.2"
        },
        ...
      ]
}

Apple IDFA / IDFV

identifierForAdvertiser (IDFA) and identifierForVendor (IDFV) values replaced the UDID after iOS 5. They are set per application, or per vendor.

Apple verklaart dit van de IDFA:

iOS 6 introduceert de Advertising Identifier, een niet-permanente, niet-persoonlijke apparaat-ID die advertentienetwerken gebruiken om u meer controle te geven over de mogelijkheid van adverteerders om traceermethoden te gebruiken. Als u ervoor kiest het bijhouden van advertenties te beperken, kunnen advertentienetwerken die gebruikmaken van de advertentie-ID mogelijk niet langer informatie verzamelen om u gerichte advertenties te leveren. In de toekomst moeten alle advertentienetwerken de advertentie-id gebruiken. Totdat advertentienetwerken overschakelen naar het gebruik van de advertentie-ID kunt u echter nog steeds getargete advertenties van andere netwerken ontvangen.

En dit voor de IDFV:

Een alfanumerieke reeks die een apparaat op unieke wijze identificeert aan de leverancier van de app. (alleen lezen)

De waarde van deze eigenschap is hetzelfde voor apps die afkomstig zijn van dezelfde leverancier die op hetzelfde apparaat wordt uitgevoerd. Een andere waarde wordt geretourneerd voor apps op hetzelfde apparaat die afkomstig zijn van verschillende leveranciers en voor apps op verschillende apparaten, ongeacht de leverancier.

Ole Begemann heeft meer geschreven over de migratie van UDID.

https://di-api.reincubate.com/v1/apple-idfas/002ebf12-a125-5ddf-a739-67c3c5d20177/

$ python -m deviceidentifier.cli.apple_idfa 002ebf12-a125-5ddf-a739-67c3c5d20177

{
    "anonymised": "••••••••-••••-••••-••••-••••••••••••",
    "formatted": "002ebf12-a125-5ddf-a739-67c3c5d20177"
}

Apple Unique Device Identifiers (UDID's)

Er zijn twee formaten UDID:

• 2007 : Dit formaat werd geïntroduceerd met de eerste iPhone en werd gebruikt op apparaten die tot 2018 werden geïntroduceerd. Het is een niet-omkeerbare samengestelde identificatiecode die is opgebouwd uit IMEI-, ECID- en MAC-waarden. Het wordt weergegeven als een hexadecimale waarde van 40 tekens.

• 2018 : Dit nieuwere formaat is geïntroduceerd voor apparaatmodellen die zijn vervaardigd in 2018 en later (bijv. IPhone XS, XS Max, XR en Apple Watch Series 4). Het is een hexadecimale hoofdletterwaarde van 8 tekens gekoppeld aan een hexadecimale waarde van 16 tekens met een streepje ( - ) in de notatie 00000000-0000000000000000 .

Apple gebruikt deze ID meestal om een apparaat aan een iCloud-ID te koppelen. Dit heeft ook de activeringsstatus van Zoek mijn iPhone. De UDID is verouderd voor gebruik in iOS-toepassingen met de introductie van iOS 5, maar heeft nog steeds een aantal andere toepassingen

https://di-api.reincubate.com/v1/apple-udids/00008020-00166D4A2130003B/

$ python -m deviceidentifier.cli.apple_udid 00008020-00166D4A2130003B

{
    "anonymised": "••••••••-••••••••••••••••",
    "compromised": false,
    "formatted": "00008020-00166D4A2130003B",
    "format": "2018",
    "ecid": 32800,
    "cpid": "00166d4a2130003b"
}

Apple Family-nummers / "A" -nummers

Apple beschrijft deze voor elke telefoon op hun " Identify your iPhone-model " -pagina.

https://di-api.reincubate.com/v1/apple-anumbers/A1784/

python -m deviceidentifier.cli.apple_anumber A1784

{
    "appleIdentifier": {
        "id": "iPhone9,4",
        "image": {
            "height": 330,
            "url": "https://di-api.reincubate.com/resource-d8c14fc2a4dfcf27d5a217fb5e4c0cc4/",
            "width": 450
        },
        "product": {
            "line": "iPhone",
            "sku": "iPhone 7 Plus"
        },
        "variant": "GSM"
    }
}