ESCode - KEALIN API :: 荒城接口 - 晴翠荒城 - BlackBerry 10 原生应用开发，BlackBerry World™ Vendor : KEALIN.ORG & KEALIN.NET

BlackBerry ESCode API 文档说明

    本 API 用于调用以及返回对不同的 BlackBerry Device PIN 及其相应的 BlackBerry OS 版本、BlackBerry Device 开机时间而生成的不同的 BlackBerry Engineering Screen Unlock Code，可用于 BlackBerry Device 的工程模式解锁。

    由于适用于 BlackBerry OS 的 ESCode 应用要求 BlackBerry OS 版本必须在 4.3 以及以上；适用于 BlackBerry 10 的 ESCode v3.0 NDK 应用则要求 BlackBerry OS 版本必须在 BlackBerry 10.2 以及以上，因此对于 BlackBerry OS 4.2 以及以下、BlackBerry 10.2 以下的 BlackBerry Device 无法使用该二款应用。为弥补该问题，本站之前已经推出基于 WEB 的 ESCode 生成页面，可完美解决该问题。

    本次，本站推出 BlackBerry ESCode API，则进一步提供给了需要提供该功能的 BlackBerry 类网站接入使用的方法。

    使用工程模式有一定风险，请必须阅读“常见问题”内的介绍，或确保自己的操作不会导致不良问题。

请求 URL 地址

http://www.kealin.net/bb/api/escode/

请求参数

采用 HTTP 协议，支持 POST 方法。
1. 系统级参数：无
2. 应用级参数：

参数名称	类型	示例值	必须	描述
pin	String	2100000a	√	BlackBerry Device PIN。大小写不敏感。
ver	String	6.0.0.461 (1965)	√	BlackBerry OS 版本号。
upt	Long	37616	√	BlackBerry Device 开机时间。如是负数，则必须传入负数，如：“-5484185”。
codeType	Integer	0	×	ESCode 有效期限类型。0 为 1 天；1 为 3 天；2 为 7 天；3 为 15 天； 4 为 30 天。其余任何传入数值均按传入数值为 0 处理。

补充说明：BlackBerry OS 7.1 以及以下版本号传递时需将其进行 UrlEncode 操作。编码为 UTF-8。

返回参数

返回参数为 JSON 格式。
1. 系统级参数：无
2. 应用级参数：

参数名称	类型	示例值	描述
error	Integer	0	检验传入数据是否正确。无错误则返回 0，其他返回 1。
errorMsg	String	请检查输入内容.	如 error 返回值为 0，则该项返回值为 ""。
escode	String	22378596	ESCode 值。如 error 返回值为 0，则该项返回值为 ""。
daysExpire	Integer	1	ESCode 有效期限天数。如 error 返回值为 0，则该项返回值为 0。

传递参数 URL 示例

http://www.kealin.net/bb/api/escode/?pin=2100000a&ver=6.0.0.461%20(1965)&upt=37616&codeType=0

返回参数代码示例

{
    'error':0,
    'errorMsg':'',
    'escode':'22378596',
    'daysExpire':1
}

ESCode

ESCode 是指 BlackBerry Device Engineering Screen Unlock Code（黑莓设备工程模式界面解锁码），用于在黑莓设备 Help me 界面解锁进入工程模式使用。

pin :: BlackBerry PIN

BlackBerry PIN，简称 PIN，是指 BlackBerry Device 的 Personal Identification Number。黑莓设备的 PIN 码格式为长度为 8 位的十六进制字符串。一般常见有 2x 开头与 3x 开头的黑莓 PIN。一般能见到的 5x 等开头的黑莓 PIN，多是用于其他 OS（如 Android 或 iOS）的 BBM PIN，而并非黑莓设备 PIN 码。使用本 API，需要传入该字符串。

ver :: BlackBerry OS Version

BlackBerry OS Version，亦写作 BlackBerry App Version，指的是 BlackBerry OS 的版本。BlackBerry OS 7.1 以及以下版本，常见格式为“6.0.0.461 (1965)”。该字符串中含有一个半角空格。空格前面的字符串是 BlackBerry OS Version，后面的包含在半角括号中的部分则是当前 BlackBerry OS Version 的 Bundle Number （捆绑包号码）。使用本 API，且使用 BlackBerry OS 7.1 以及以下版本的，需要传入完整的版本号信息（即：如常见格式所言），且需要对空格进行 UrlEncode 操作转为 UTF-8 字符。对于 BlackBerry 10 以上的版本，则不再有捆绑包号码，格式如“10.3.2.2639”，可以在设置 - 关于 - 操作系统中查看（请注意，是操作系统版本，而非软件版本。如 10.3.2.2639 对应的软件版本为 10.3.2.2474，但如果使用 10.3.2.2474 则无法获得有效的 ESCode）。

upt :: Uptime

BlackBerry 设备开机时间。单位为秒。部分可见开机时间会显示为负数，目前并未知晓具体原因，猜测与 Java 中对于 Integer 的范围及其显示操作有关。传入参数时，如果是负数，请直接传入负数。

codeType :: ESCode 有效期限类型

ESCode 是有有效期限的，使用了 ESCode 解锁工程模式，则在有效期限内进入 Help me 界面会自动进入工程模式界面。而超过有效期限后，则自动关闭工程模式。ESCode 的有效期限分为 5 种，分别为 1 天、3 天、7 天、15 天、30 天。传入 codeType 参数时，使用 0 - 4 分别代表有效期限的天数类型。为免除不必要的麻烦，在获取 ESCode 时，请选择合适的有效期限。

* 如何进入工程模式？

    · BlackBerry OS 10 设备请使用自带浏览器访问 “EScreen://”；
    · BlackBerry OS 10 以下版本机型请参照：
    · 全键盘机型（QWERTY，如8700,8800，9600，9700），按 Alt + Shift + H；
    · 增强键盘机型（SureType，如8100,8120），按 Alt + R + A + C + E；
    · 触屏机型（如 9500,9800）主界面按住 EScape 并轻触屏幕两边 “左-右-左-右”。
    · 在进行完上述操作的界面输入工程模式解锁码（Engineering Screen Unlock Code），正确即可进入工程模式。
    · 输入时界面不会有任何反应，输入完毕才会进入工程模式。请注意大小写。
    · 如 BlackBerry Z10 等使用虚拟键盘的 BlackBerry 10 设备，在打开时不会出现键盘，此时需要双指按住屏幕下方上拉，即可调出。

* 使用工程模式有哪些需要注意的问题？

· 如果只是查看各项信息，可以随意浏览。
· 如果需要修改其中的某些设置，请必须确定操作是安全的且不会导致问题。否则，有些操作将可能导致 BlackBerry 设备损坏，最严重时可能导致 BlackBerry 设备报废。请一定注意。