# 注意：本文檔后期不在跟新，新文檔遷移到：[http://www.openkit.cc/docs/openkit/#/](http://www.openkit.cc/docs/openkit/#/)
# 首先感謝使用OpenKit工具包
## 反饋交流QQ群：696279396
|更新時間|版本|作者|
|:--:|:--:|:--:|
|2018-1-25 19:32|V1.1.12|賁海龍|
- 首先我們需要 new 一個 JPushModel 對象
| 內容 | 數據類型 | 是否必傳 | 說明 |
| :---: | :---: | :---: | :---: |
| appkey | String | 是 | 極光推動的 appkey|
| mastersecret | String | 是 | 極光推動的 mastersecret|
| con | String | 是 | 極光推動的 內容|
| userid | String[] | 否 | 如果是推送給一個人，或者一類人的時候，必傳|
| extras | Map<String, String> | 否 | 推送的附加參數的map集合|
| sound | String | 是 | 聲音 默認已經設置成 happy|
```java
// 不傳參數，后期用set傳參
JPushModel j = new JPushModel()
// 如果你是推送全部（透傳一樣）
JPushModel j = new JPushModel(String appkey,String mastersecret,String con)
// 如果你是推送給一類人（透傳一樣）
JPushModel j = new JPushModel(String appkey,String mastersecret,String con,String[] userid)
```
- 如果你有其他需求，你可以用對應的 SET 方法，把你的數據進行封裝
```java
// 比如我想重新設置透傳的聲音
j.setSound = "err";
```
- 下面就是調用方法了
|調用|說明|備注|
|:--:|--|--|
|tuiAll(JPushModel j)|推送給所有||
|tuiGroup(JPushModel j)|推送給一類人（包括一個人）|對象中的userid必須傳，如果只有一個，也需要用數組，并且同時最多傳1000個|
|touAll(JPushModel j)|透傳給所有||
|touGroup(JPushModel j)|透傳給一類人（包括一個人）|對象中的userid必須傳，如果只有一個，也需要用數組，并且同時最多傳1000個|
- 返回
> 我們會返回PushResult對象，同時可以通過：pushResult.getResponseCode() 查看狀態，如果是200，說明成功，否則可以自己查看對應的錯誤
|Code | 描述 | 詳細解釋 | HTTP Status Code|
|:---:|:---:|:---|:---:|
|1000 | 系統內部錯誤 | 服務器端內部邏輯錯誤，請稍后重試。| 500|
|1001 | 只支持 HTTP |Post 方法 不支持 Get 方法。 | 405|
|1002 | 缺少了必須的參數 | 必須改正 | 400
|1003 | 參數值不合法| 必須改正。參數不合法的情況如：Audience參數中tag，alias，registration_id有空值；單發指定的 registration_id 非法或者格式錯誤。| 400|
|1004 | 驗證失敗 |必須改正。|詳情請看：調用驗證 401|
|1005 |消息體太大 | 必須改正。 Android平臺Notification+Message長度限制為4000字節； iOS Notification 中 “iOS”:{ } 及大括號內的總體長度不超過：2000個字節（包括自定義參數和符號），iOS 的 Message部分長度不超過 4000 字節； WinPhone平臺Notification長度限制為1000字節 | 400|
|1008 | app_key參數非法 | 必須改正 | 400|
|1009 | 推送對象中有不支持的key | 必須改正 | 400|
|1011 | 沒有滿足條件的推送目標 | 請檢查audience | 400|
|1020 | 只支持 HTTPS 請求 | 必須改正 | 404|
|1030 | 內部服務超時 | 稍后重試 | 503|
|2002 |API調用頻率超出該應用的限制 | 聯系極光商務或技術支持開通更高的 API 調用頻率 | 429|
|2003| 該應用appkey已被限制調用 API | 聯系技術支持查明限制原因和尋求幫助 | 403|
|2004 | 無權限執行當前操作 | 必須改正。當前調用 API 的源 ip 地址不在該應用的 ip 白名單中。 | 403|
|2005 | 信息發送量超出合理范圍。 | 檢測到目標用戶累計發送消息量過大，超過合理的使用范圍，需要檢查業務邏輯或者聯系技術支持。| 403|
- DEMO
```java
/**
* 極光推送demo
*/
@RequestMapping(value = "/jiguang")
@ResponseBody
public Object jiguang(HttpServletRequest request) throws Exception{
String[] a = {"5a8c59265135427ab58ec0a40624851d","ad2c1ca4dfb146e5992c4be56e1848f2"};
Map<String, String> map = new HashMap<String, String>();
map.put("code","200");
map.put("msg","備注");
JPushModel jPushModel = new JPushModel("********","********","推送內容",a);
jPushModel.setExtras( map);
// PushResult pushResult = tuiAll(jPushModel);
// PushResult pushResult = tuiGroup(jPushModel);
// PushResult pushResult = touAll(jPushModel);
PushResult pushResult = touGroup(jPushModel);
System.out.println(pushResult.getResponseCode());
return JSONObject.toJSON(pushResult);
}
```
- 返回結果
## 反饋交流QQ群：696279396
## 贊助
