Recherche, identification et enrichissement

Mis à jour

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

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"
    ]
}
wzxhzdk: 70 Les appels à l'API via ce client deviennent alors faciles: wzxhzdk: 71 wzxhzdk: 72 ->

Comment pouvons nous aider?

Notre équipe de support est là pour vous aider!

Nos bureaux sont ouverts du lundi au vendredi, de 9 h à 17 h GMT. L’heure est actuellement 8:15 Matin GMT.

Notre objectif est de répondre à tous les messages en un jour ouvrable.

Aller à la section support › Contacter l'équipe de l'entreprise ›
Notre superbe équipe de support

Pouvons-nous améliorer cet article?

Nous aimons entendre les utilisateurs: pourquoi ne pas nous envoyer un email, laisser un commentaire ou tweet @reincubate?

© 2008 - 2019 Reincubate Ltd. Tous droits réservés. Enregistré en Angleterre et au Pays de Galles #5189175, VAT GB151788978. Reincubate® est une marque déposée. Confidentialité et modalités. Nous recommandons l'authentification multi-facteurs. Construit avec à Londres.