# smsClient **Repository Path**: zhaoicat/smsClient ## Basic Information - **Project Name**: smsClient - **Description**: cmpp协议转http rest例子 - **Primary Language**: Java - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 11 - **Forks**: 3 - **Created**: 2021-12-08 - **Last Updated**: 2025-06-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: cmpp ## README # 说明 本程序是cmpp协议使用springboot的http包装，采用全异步回调方式，对接前请先熟悉cmpp协议 # 安装使用 git或者下载本项目 ```shell #编译 mvn install #运行 java -jar smsClient-0.0.1-SNAPSHOT.jar ``` # API调用 ## 发送消息 发送消息 POST http://localhost:8080/sendMsg Content-Type: application/json;charset=UTF-8 ```json { //发送号码 "phone": "1824XXXX799", //发送内容 "context":"【博罗政务】您有一份新的公文 公文标题：关于核对《博罗县机关电话号码簿》（送审稿）的通知（全县单位均需反馈意 见，没有意见的请注明“无意见”，并于12月28日上午前报送） 发送者：林静玲 (商贸资产经营公司OA)" } ``` ## submit_req 同步返回 参考cmpp协议submit_req协议包 ```json {"success":true,"code":200,"message":"请求成功","data":{"registeredDelivery":0,"msglevel":9,"serviceId":"922001","feeUserType":2,"feeterminalId":"","feeterminaltype":0,"msgsrc":"","feeType":"01","feeCode":"000000","valIdTime":"","atTime":"","srcId":"922001","destterminalId":"18688383818","destterminaltype":0,"linkID":"0000","reserve":"","msg":{"text_":"【博罗政务】您有一份新的公文 公文标题：关于核对《博罗县机关电话号码簿》（送审稿）的通知（全县单位均需反馈意见，没有意见的请注明“无意见”，并于12月28日上午前报送） 发送者：林静玲 (商贸资产经营公司OA)","dcs_":{"dcs_":8}},"pktotal":2,"pknumber":1,"tppid":0,"tpudhi":0,"msgfmt":{"dcs_":0},"msgLength":140,"packetType":"CMPPSUBMITREQUEST","timestamp":1640662592918,"lifeTime":0,"msgid":"1128113632001015021756","msgContent":"【博罗政务】您有一份新的公文 公文标题：关于核对《博罗县机关电话号码簿》（送审稿）的通知（全县单位均需反馈意见，没有意见的请注明“无意见”，并于12月28日上午前报送） 发送者：林静玲 (商贸资产经营公司OA)","commandId":4,"sequenceId":325276923}} ``` ## submit_resp 异步返回 根据submit_req提交短信内容拆分包，例如上包，返回2条 匹配规则： submit_req和submit_resp msgid+srcId+destterminalId "pktotal":2 //本次提交分2个包提交，计费也是按2条计费 ```json {"result":0,"packetType":"CMPPSUBMITRESPONSE","timestamp":1640662592918,"lifeTime":0,"request":{"registeredDelivery":0,"msglevel":9,"serviceId":"922001","feeUserType":2,"feeterminalId":"","feeterminaltype":0,"msgsrc":"922001","feeType":"01","feeCode":"000000","valIdTime":"","atTime":"","srcId":"922001","destterminalId":["18688383818"],"destterminaltype":0,"linkID":"0000","reserve":"","pktotal":2,"pknumber":1,"tppid":0,"tpudhi":1,"msgfmt":{"dcs_":8},"msgLength":140,"packetType":"CMPPSUBMITREQUEST","timestamp":1640662592918,"lifeTime":0,"msgId":"1128113632001015021756","msgContent":"【博罗政务】您有一份新的公文 公文标题：关于核对《博罗县机关电话号码簿》（送审稿）的通知（全县单位均需反馈意见，没有意见的请注明“无"},"msgId":"1228113632000003130178","commandId":2147483652,"sequenceId":325276923} {"result":0,"packetType":"CMPPSUBMITRESPONSE","timestamp":1640662592918,"lifeTime":0,"request":{"registeredDelivery":0,"msglevel":9,"serviceId":"922001","feeUserType":2,"feeterminalId":"","feeterminaltype":0,"msgsrc":"922001","feeType":"01","feeCode":"000000","valIdTime":"","atTime":"","srcId":"922001","destterminalId":["18688383818"],"destterminaltype":0,"linkID":"0000","reserve":"","pktotal":2,"pknumber":2,"tppid":0,"tpudhi":1,"msgfmt":{"dcs_":8},"msgLength":84,"packetType":"CMPPSUBMITREQUEST","timestamp":1640662592918,"lifeTime":0,"msgId":"1128113632001015021756","msgContent":"意见”，并于12月28日上午前报送） 发送者：林静玲 (商贸资产经营公司OA)"},"msgId":"1228113632000003130179","commandId":2147483652,"sequenceId":325276925} ``` ## deliver_req 参考cmpp协议deliver_req协议包 异步返回 收到deliver_req协议包后可以以回调方式回送到某个http接口 对应submit_resp条数返回deliver_req条数 匹配规则 deliver_req和submit_resp deliver_req->reportRequestMessage->msgId == submit_resp->msgId "stat":"DELIVRD" 为用户已经收到，其他状态可以查手册 ```json {"destId":"10690202104101","serviceid":"","srcterminalId":"18688383818","srcterminalType":0,"registeredDelivery":1,"reportRequestMessage":{"msgId":"1228113632000003130178","stat":"DELIVRD","submitTime":"2112281136","doneTime":"2112281136","destterminalId":"18688383818","smscSequence":4280062170,"timestamp":1640662602954,"lifeTime":0},"linkid":"","reserved":"","tppid":0,"tpudhi":0,"msgfmt":{"dcs_":0},"msgLength":140,"packetType":"CMPPDELIVERREQUEST","timestamp":1640662602954,"lifeTime":0,"msgId":"1228113642000003130215","commandId":5,"sequenceId":223320403} {"destId":"10690202104101","serviceid":"","srcterminalId":"18688383818","srcterminalType":0,"registeredDelivery":1,"reportRequestMessage":{"msgId":"1228113632000003130179","stat":"DELIVRD","submitTime":"2112281136","doneTime":"2112281136","destterminalId":"18688383818","smscSequence":4280062173,"timestamp":1640662602954,"lifeTime":0},"linkid":"","reserved":"","tppid":0,"tpudhi":0,"msgfmt":{"dcs_":0},"msgLength":140,"packetType":"CMPPDELIVERREQUEST","timestamp":1640662602954,"lifeTime":0,"msgId":"1228113642000003130216","commandId":5,"sequenceId":223320404} ```