Opzoeken, identificeren en verrijken

bijgewerkt

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"
    ]
}
wzxhzdk: 10 Oproepen naar de API via deze client worden dan gemakkelijk: wzxhzdk: 11 wzxhzdk: 12 ->

Hoe kunnen we helpen?

Ons ondersteuningsteam is er om u te helpen!

Onze kantooruren zijn van maandag tot vrijdag van 09.00 tot 17.00 uur GMT. De tijd is momenteel 6:39 PM GMT.

We streven ernaar om alle berichten binnen één werkdag te beantwoorden.

Ga naar het ondersteuningsgedeelte › Neem contact op met het Enterprise-team ›
Ons geweldige ondersteuningsteam

Kunnen we dit artikel verbeteren?

We horen graag van gebruikers: Stuur ons een e-mail, laat een reactie achter of stuur een tweet @reincubate?

© 2008 - 2020 Reincubate Ltd. Alle rechten voorbehouden. Geregistreerd in Engeland en Wales #5189175, VAT GB151788978. Reincubate® is een geregistreerd handelsmerk. Privacybeleid & termen. Wij bevelen 2FA aan. Gebouwd met in Londen.