조회, 식별 및 농축
농축
Apple 장치에서 데이터를 얻는 가장 좋은 방법은 lookup 호출을 사용하여 데이터를 보강하는 것입니다. 이것은 직렬 및 IMEI 데이터를 조회 할 때 특히 효과적이며 많은 관련 장치 데이터를 반환 할 수 있습니다. 주어진 식별자에 대한 속성을 가져와야하는 경우 아래의 클래식 조회 섹션을 참조하십시오.
요청 형식은 https://di-api.reincubate.com/v2/lookup/
이 기능에 액세스하는 방법에는 두 가지가 있습니다.
GET 사용한 요약 요청
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" ] }
