検索、識別、および強化

更新しました

濃縮

Appleデバイスでデータを取得する最良の方法は、 lookup呼び出しを使用してデータを充実させることです。これは、シリアルおよびIMEIデータのルックアップに特に効果的であり、多くの関連デバイスデータを返すことができます。特定の識別子のプロパティを取得する必要がある場合は、以下の従来の検索セクションをご覧ください。

これはリクエスト形式です: https://di-api.reincubate.com/v2/lookup/ : https://di-api.reincubate.com/v2/lookup/

この機能にアクセスするには2つの方法があります。

GETを使用した要約リクエスト

ルックアップは、 https://di-api.reincubate.com/v2/lookup/[IDENTIFIER-VALUE]/ような形式のリクエストで実行できますhttps://di-api.reincubate.com/v2/lookup/[IDENTIFIER-VALUE]/

これにより、DeviceIdentifierデータにアクセスする簡単な方法が提供されます。ただし、これは値のタイプの自動識別に依存しており、常に完全なPOSTリクエストほど多くのデータを提供するわけではありません。

POSTを使用した完全なリクエスト

これらを使用するには、APIは次のようなJSONデータのPOSTリクエストを受信する必要があります。

{
  "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時から午後5時(GMT)です。 時間は現在 5:25 AM GMTです。

1営業日以内に、お返事を差し上げます。メールアドレスはこちら。

私たちの素晴らしいサポートチーム

この記事を改善できますか?

ユーザーからの連絡をお待ちしています。電子メールを送信したり、コメントを残したり、ツイートしたりしないでください。 @reincubate?

© 2008 - 2024 Reincubate Ltd. 無断複写・転載を禁じます。 イングランドとウェールズに登録 #5189175, VAT GB151788978. Reincubate®およびCamo®は登録商標です。 個人情報保護方針 & 条項.