Поиск, идентификация и обогащение

обновленный
Cover image for: Поиск, идентификация и обогащение

обогащение

Лучший способ получить данные на устройстве Apple - воспользоваться lookup вызовом для обогащения данных. Это особенно эффективно для поиска по последовательным и IMEI-данным и может возвращать много связанных данных об устройстве. Если вам просто нужно получить свойства для данного идентификатора, см. Классический раздел « Поиск » ниже.

Это его формат запроса: https://di-api.reincubate.com/v2/lookup/

Есть два способа получить доступ к этой функции.

Сводные запросы с использованием GET

Поиск может быть выполнен с запросом в формате, подобном https://di-api.reincubate.com/v2/lookup/[IDENTIFIER-VALUE]/

Это обеспечивает простой способ доступа к данным DeviceIdentifier. Однако это зависит от автоматической идентификации типов значений и не всегда предоставляет столько данных, сколько более полный запрос POST .

Полные запросы с использованием POST

Чтобы использовать их, API должен получить POST-запрос данных JSON, подобный следующему:

{
  "primary": {
    "identifier": "iPhone5,2",
    "type": "apple_identifier"
  },
  "additional": [{
    "identifier": "F2TK4TZ7DTWF",
    "type": "apple_serial"
  },{
    "identifier": "013554006297015",
    "type": "gsma_imei"
  },{
    "identifier": "8965880812100011146",
    "type": "gsma_iccid"
  }]
}

В этой структуре JSON значение основного identifier является обязательным и должно представлять собой серийный номер Apple, IMEI или модель.

Передача значений type является необязательной, но она защищает от возможных коллизий. Любое значение type задокументированное в разделах поддерживаемых идентификаторов этой документации, является приемлемым для значения типа. Таким образом, в самом простом случае действительный запрос может выглядеть так:

{
  "primary": {
      "identifier": "DMPRC0P8H1MD"
  }
}

additional словарь также совершенно необязателен. Однако эти значения позволяют API сузить результаты и обеспечить большую точность его ответов. Настоятельно рекомендуется отправить столько дополнительных данных, сколько доступно для устройства.

API будет возвращать данные в едином формате, как описано в разделе поддерживаемых идентификаторов в своем ответе.

Примеры

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

Уважать

API предоставляет функциональность для поиска деталей для данного идентификатора. Вызов поиска RESTful и имеет следующий формат:

https://di-api.reincubate.com/v1/*[IDENTIFIER-TYPE]*/*[IDENTIFIER-VALUE]*/

См. Разделы поддерживаемых идентификаторов для получения информации о поддерживаемых форматах идентификаторов.

Примеры

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

Удостоверение личности

API предоставляет функциональность для идентификации неизвестного идентификатора. Вызов поиска RESTful и имеет следующий формат:

https://di-api.reincubate.com/v1/identify-identifier/*[IDENTIFIER-VALUE]*/

См. Разделы поддерживаемых идентификаторов для получения информации о поддерживаемых форматах идентификаторов.

Примеры

https://di-api.reincubate.com/v1/identify-identifier/iPhone5,3/

$ python -m deviceidentifier.cli.identify_identifier iPhone5,3
{
    "iPhone5,3": [
        "apple_identifier"
    ]
}

Как мы можем помочь?

Наша служба поддержки здесь, чтобы помочь!

Наш офис работает с понедельника по пятницу с 9:00 до 17:00 по Гринвичу. Время в настоящее время 1:02 ДП с GMT.

Мы стремимся отвечать на все сообщения в течение одного рабочего дня.

Наша отличная команда поддержки

Можем ли мы улучшить эту статью?

Нам нравится слышать от пользователей: почему бы не написать нам электронное письмо, оставить комментарий или написать в Твиттере @reincubate?

© 2008 - 2024 Reincubate Ltd. Все права защищены. Зарегистрировано в Англии и Уэльсе #5189175, VAT GB151788978. Reincubate® и Camo® являются зарегистрированными товарными знаками. Политика конфиденциальности & условия.