代码样例 import static java.nio.charset.StandardCharsets.UTF_8; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import java.util.logging.Level; import java.util.logging.Logger; /** * 功能描述 */ public class FileDownload { /** * 正确码 * */ public static final int SUCCESS_VALUE = 200; /** * 错误码 * */ public static final int ERR_VALUE = 204; private FileDownload() { } /** * 文件下载功能 * * @param args * @throws IOException * */ public static void main(String[] args) throws IOException { Logger logger = Logger.getLogger(FileDownload.class.getName()); logger.setLevel(Level.WARNING); InputStream is; String url = "http://127.0.0.1:8323/openchatbot/v2/" + "sip:chatbotid32test1@botplatform.rcs.chinamobile.com/files"; URL realUrl = new URL(url); HttpURLConnection connection = (HttpURLConnection) realUrl.openConnection(); // 设置请求方式 connection.setRequestMethod("GET"); connection.setRequestProperty("Authorization", "Username=\"appId32test1\",Password=\"******\""); connection.setRequestProperty("X-WSSE", "UsernameToken Username=\"appId32test1\""); connection.setRequestProperty("File-Location", "http://10.134.204.203:8087/Content111"); connection.connect(); int status = connection.getResponseCode(); if (status != SUCCESS_VALUE) { if (status == ERR_VALUE) { logger.warning("No Content,sucess，nobody。"); is = connection.getInputStream(); } else { // 400/401 logger.warning("err"); is = connection.getErrorStream(); } } else { // 200 logger.warning("OK,DELETE"); is = connection.getInputStream(); } BufferedReader br; br = new BufferedReader(new InputStreamReader(is, UTF_8)); String line; StringBuilder result = new StringBuilder(); // 读取数据 while ((line = br.readLine()) != null) { result.append(line); } // 关流操作，这个很重要 is.close(); br.close(); // 关闭连接 connection.disconnect(); logger.warning("mabye is null" + result.toString()); } }

数据准备 序号 字段 数据类型 可选属性 描述 1 serverRoot string M 服务器基础URL: hostname(或ip)+port+base path Port和base path可选 例: ip:port/openchatbot 2 apiVersion string M 客户端想使用的API版本号. 例: “v2”. 3 chatbotAddress string M 行业消息的统一服务地址，客户端可根据此地址将所有通知集合展现。 chatbotAddress是5G云服务平台分配给购买者的chatbotID。如果您已经购买了5G消息应用资产，则可以登录消费者门户，选择”应用管理”查看chatbotID。

消息样例 这个是传入的请求 urlhttp://10.120.207.128:8323/openchatbot/v2/sip:chatbotid32test1@botplatform.rcs.chinamobile.com/files 以下是请求参数信息--- {"File":{"fileId":"12341234","fileSize":20,"status":"OK","fileUrl":"src/1.txt","validity":""}} 以上是请求参数信息--- 以下是获取响应信息=== conn.getResponseCode():200 conn.getURL():http://10.120.207.128:8323/openchatbot/v2/sip:chatbotid32test1@botplatform.rcs.chinamobile.com/files conn.getRequestMethod():POST conn.getContentType():application/xml conn.getReadTimeout():0 conn.getResponseMessage():OK url.getDefaultPort():80 url.getFile():/openchatbot/v2/sip:chatbotid32test1@botplatform.rcs.chinamobile.com/files url.getHost():10.120.207.128 url.getPath():/openchatbot/v2/sip:chatbotid32test1@botplatform.rcs.chinamobile.com/files url.getPort():8323 url.getProtocol():http url.getQuery():null url.getRef():null url.getUserInfo():null 以上是获取响应信息===DDD= status:200

消息样例 resultMsg.toString(){"senderAddress":"******","senderName":"Default Name","address":"******","destinationAddress":"******","clientCorrelator":"567895","outboundIMMessage":{"contributionID":"c67771cf-bd31-483e-8f8a-479df74db92e","storeSupported":"true","bodyText":"******","reportRequest":["Delivered","Displayed","Failed"],"conversationID":"fSFDSFDR$%#$%$%$%","subject":"Default Subject","shortMessageSupported":"false","contentEncoding":"utf8","contentType":"multipart/mixed; boundary=\"next\"","serviceCapability":[{"capabilityId":"ChatbotSA","version":"+g.gsma.rcs.botversion=\"#=1\""},{"capabilityId":"ChatbotSA222","version":"+g.gsma.rcs.botversion=\"#=1\""}]}}

消息样例 resultMsg.toString(){"senderAddress":"******","senderName":"Default Name","address":"******","destinationAddress":"******","clientCorrelator":"567895","outboundIMMessage":{"contributionID":"c67771cf-bd31-483e-8f8a-479df74db92e","storeSupported":"true","bodyText":"******","reportRequest":["Delivered","Displayed","Failed"],"conversationID":"fSFDSFDR$%#$%$%$%","subject":"Default Subject","shortMessageSupported":"false","contentEncoding":"utf8","contentType":"multipart/mixed; boundary=\"next\"","serviceCapability":[{"capabilityId":"ChatbotSA","version":"+g.gsma.rcs.botversion=\"#=1\""},{"capabilityId":"ChatbotSA222","version":"+g.gsma.rcs.botversion=\"#=1\""}]}}

消息样例 resultMsg.toString(){"senderAddress":"******","senderName":"Default Name","address":"******","destinationAddress":"******","clientCorrelator":"567895","outboundIMMessage":{"contributionID":"c67771cf-bd31-483e-8f8a-479df74db92e","storeSupported":"true","bodyText":"******","reportRequest":["Delivered","Displayed","Failed","SMS"],"conversationID":"fSFDSFDR$%#$%$%$%","subject":"Default Subject","shortMessageSupported":"false","contentEncoding":"utf8","contentType":"multipart/mixed; boundary=\"next\"","serviceCapability":[{"capabilityId":"ChatbotSA","version":"+g.gsma.rcs.botversion=\"#=1\""},{"capabilityId":"ChatbotSA222","version":"+g.gsma.rcs.botversion=\"#=1\""}]}}

Network API错误码 序号 HTTP错误码 Network API错误码 描述 1 200 SVC1000 Success -成功 2 403 SVC4001 query user info fail -查询用户信息失败 3 400 SVC0002 msg decode fail -解码失败 4 500 SVC4001 require apurce fail -申请资源失败 5 501 SVC4001 query file status fail -查询文件状态失败 6 500 SVC4001 encode fail -编码失败 7 500 SVC4001 base64 decode fail -Base64解码失败 8 500 SVC4001 generate file path fail -生成文件路径失败 9 500 SVC4001 get file info fail -获取文件信息失败 10 500 SVC4001 get file domain index fail -获取域索引失败 11 500 SVC4001 insert databases fail -写入数据库失败 12 500 SVC4001 get httpserver node fail -查询文件服务器节点失败 13 500 SVC4001 internal communication fail -内部通信失败 14 500 SVC4001 file transfer fail -文件传输失败 15 500 SVC4001 illegal platform identity -非法的平台标识 16 403 POL0009 Maximum number of requests exceeded -消息流控 17 400 SVC0002 AO msg service capability invalid -应用发起消息所带业务标识校验失败 18 603 SVC4001 file size overlimit -文件大小超过平台限制 19 500 SVC4001 query session infomatrion timeout -从查询会话信息超时 20 500 SVC4001 insert session infomatrion timeout -记录会话信息超时 21 500 SVC4001 query report relationship timeout -查询回执对应关系超时 22 403 SVC5201 service is shutdown -用户已停机 23 500 SVC4001 when get shorturl, msg expire -获取短链时，消息已经过期 24 400 SVC4001 a2p message allow fallback sms, but sms port number not exist -MaaP消息允许回落短信，但短信端口号不存在 25 400 SVC4001 a2p message allow fallback sms, but sms content not exist -MaaP消息允许回落短信，但短信内容不存在 26 500 SVC4001 query report relationship failed -查询回执对应关系失败 27 400 SVC4001 Msg Recived has expired -接收到的消息已过期 28 400 SVC4001 A2P message can not fall back to mms or sms -消息无法回落 29 403 SVC4001 query user np info fail -查询用户NP信息失败 30 500 SVC4001 msg expired -消息过期 31 404 SVC5001 dest user account not exist -被叫用户信息不存在 32 500 SVC4001 query dest userinfo failed -被叫用户信息查询失败 33 480 SVC4001 dest user offline -被叫用户离线 34 500 SVC4001 get remote file failed -获取远端文件响应失败 35 500 SVC4001 query original message failed -从数据库查询原始消息失败 36 400 SVC0002 invalid method or url -Maap请求method/url非法 37 400 SVC0002 invalid AS request -AS请求非法 38 400 SVC0002 parse xml fail -xml解析失败 39 500 SVC0001 bulid xml fail -xml构造失败 40 400 SVC0003 missing necessary field -缺少必填字段 41 403 POL0009 flow control interception -流控拦截 42 500 SVC0001 set to db fail -写库失败 43 500 SVC0001 get from db fail -读库失败 44 500 SVC0001 set to db timeout -写库超时 45 500 SVC0001 get from db timeout -读库超时 46 404 SVC0004 send request to as fail -发送至AS失败 47 408 SVC0001 AS response timeout -AS响应超时 48 503 SVC2001 alloc memory fail -资源分配失败 49 500 SVC2001 put into hash fail -会话信息保存失败 50 500 SVC2001 get from hash fail -会话信息读取失败 51 500 SVC2001 invalid http link -http链路异常 52 500 SVC0001 interface inner error -接口内部错误 53 404 SVC0004 send request to ap fail -发送至Maap失败 54 408 SVC0001 Maap response timeout -Maap响应超时 55 400 SVC0002 Http response xml parse fail -Http响应xml解析失败 56 400 SVC0002 Maap response invalid -Maap响应非法 57 400 SVC0002 request field invalid -请求字段非法 58 NA SVC6001 peer node unreachable or no usable node -对端节点不可及/无可用节点（SMS） 59 NA SVC6001 send message to peer ndoe failed -向短信中心节点投递失败 60 NA SVC6001 routing failed -路由失败（SMS） 61 NA SVC6001 VMSC:limited due to MS roaming -用户漫游，无法接收 62 NA SVC6001 service barred 或 operation barred -用户停机 63 NA SMS sms success report -回落短信成功 64 NA SVC6001 Unknown Subscriber -短信下发返回未知用户错误。 65 NA SVC6001 Unmarked Subscriber -短信下发返回未定义用户错误。 66 NA SVC6001 HLR:illegal subscriber -短信下发返回非法用户错误。 67 NA SVC6001 teleservice not supported -短信下发返回电信业务不支持错误。 68 NA SVC6001 call forbidden -短信下发返回呼叫被禁止错误。 69 NA SVC6001 VMSC:subscriber absent -短信下发返回用户不在服务区错误。 70 NA SVC6001 HLR:resource not available due to congestion -短信下发返回HLR消息等待队列满错误。 71 NA SVC6001 HLR:data lacked -短信下发返回数据丢失错误。 72 NA SVC6001 HLR:unexpected data -短信下发返回意外数据错误。 73 NA SVC6001 MS error -短信下发返回MS端错误。 74 NA SVC6001 SMS not supported by MS -短信push回执-下发返回MS未装备错误。 75 NA SVC6001 MS store is full -短信下发返回手机内存满错误。 76 NA SVC6001 illegal device -短信下发返回非法设备错误。 77 NA SVC6001 failure because the subscriber is busy -短信下发返回用户忙错误。 78 NA SVC6001 VMSC:the called MS poweroff -短信下发返回用户关机错误。 79 NA SVC6001 VMSC:no response -短信下发后， MSC无应答。 80 NA SVC6001 HLR:no response -短信下发后， HLR无应答。 81 NA SVC6001 VMSC:the service not supported by the peer -短信下发后，MSC拒绝。 82 NA SVC6001 HLR:the service not supported by the peer -短信下发后，HLR拒绝。 83 NA SVC6001 HLR:service not complete -短信下发返回HLR系统错误。 84 NA SVC6001 VMSC:service not complete -短信下发返回MSC系统错误. 85 NA SVC6001 HLR:illegal destionation SCCP address -短信下发后，由于目的信令点或信令转接点SCCP无法传送该消息。 86 NA SVC6001 sms report-peer node unreachable or no usable node -短信回执对端节点不可及/无可用节点（SMS） 87 NA SVC6001 sms report-send message to peer ndoe failed -短信回执向短信中心节点投递失败 88 NA SVC6001 sms report-message routing failed -短信回执路由失败（SMS） 89 NA SVC6001 sms report-VMSC:limited due to MS roaming -短信回执用户漫游，无法接收 90 NA SVC6001 sms report-service barred 或 sms report-operation barred -短信回执用户停机 91 NA SVC6001 Unknown Subscriber 或 sms report-Unknown Subscriber -短信回执返回未知用户错误。 92 NA SVC6001 sms report-Unmarked Subscriber -短信回执返回未定义用户错误。 93 NA SVC6001 sms report-HLR:illegal subscriber -短信回执返回非法用户错误。 94 NA SVC6001 sms report-teleservice not supported -短信回执返回电信业务不支持错误。 95 NA SVC6001 sms report-call forbidden -短信回执返回呼叫被禁止错误。 96 NA SVC6001 sms report-VMSC:subscriber absent -短信回执返回用户不在服务区错误。 97 NA SVC6001 sms report-HLR:resource not available due to congestion -短信回执返回HLR消息等待队列满错误。 98 NA SVC6001 sms report-HLR:data lacked -短信回执返回数据丢失错误。 99 NA SVC6001 sms report-HLR:unexpected data -短信回执返回意外数据错误。 100 NA SVC6001 sms report-MS error -短信回执返回MS端错误。 101 NA SVC6001 sms report-SMS not supported by MS -短信回执-下发返回MS未装备错误。 102 NA SVC6001 sms report-MS store is full -短信回执返回手机内存满错误。 103 NA SVC6001 sms report-illegal device -短信回执返回非法设备错误。 104 NA SVC6001 sms report-failure because the subscriber is busy -短信回执返回用户忙错误。 105 NA SVC6001 sms report-VMSC:the called MS poweroff -短信回执返回用户关机错误。 106 NA SVC6001 sms report-VMSC:no response -短信回执， MSC无应答。 107 NA SVC6001 sms report-HLR:no response -短信回执， HLR无应答。 108 NA SVC6001 sms report-VMSC:the service not supported by the peer -短信回执，MSC拒绝。 109 NA SVC6001 sms report-HLR:the service not supported by the peer -短信回执，HLR拒绝。 110 NA SVC6001 sms report-HLR:service not complete -短信回执返回HLR系统错误。 111 NA SVC6001 sms report-VMSC:service not complete -短信回执返回MSC系统错误. 112 NA SVC6001 sms report-HLR:illegal destionation SCCP address -短信回执， 113 400 SVC0003 invalid maap platform id -因在AO接口产生发送方鉴权失败 114 400 SVC4001 receiver not local area user in application platform send process -在AO接口产生接收方鉴权失败 115 400 SVC0002 AO msg service capability invalid -因在AO接口产生5G消息系统拒绝服务 116 400 SVC4001 a2p msg can not fallback xms -在AO接口，接收方为系统黑名单用户 117 NA SVC1501 no capability -无能力 118 403 POL0003 dest address out of bounds -由于SP群发地址过多，超过系统设置从而导致失败

HTTP错误码 序号 错误码 描述 1 200 OK,GET请求成功，响应消息有消息体。 2 201 Created，POST/PUT请求成功，响应消息有消息体。 3 204 No Content,成功，响应消息没有消息体。 4 206 OK,GET请求成功，Partial Content 5 400 Bad Request ，客户端请求的语法错误，服务器无法理解 6 403 Forbidden，服务器拒绝执行 7 404 Not Found，服务器无法根据客户端的请求找到资源 8 406 Not Acceptable，服务器无法根据客户端请求的内容特性完成请求 9 408 Request Timeout ，请求超时 10 503 Server Unavailable，服务器没有准备好处理请求

JAVA 本文档所述Demo在提供服务的过程中，可能会涉及个人数据的使用，建议您遵从国家的相关法律采取足够的措施，以确保用户的个人数据受到充分的保护。 本文档所述Demo仅用于功能演示，不允许客户直接进行商业使用。 本文档信息仅供参考，不构成任何要约或承诺。 多媒体文件上传 多媒体文件下载 媒体文件删除 单卡片5G消息发送 带建议回复消息的多卡片5G消息 码流转成json的多卡片+悬浮菜单 父主题： API代码样例

5G消息使用流程 任务 操作步骤 01 入驻华为云 注册华为账号并开通华为云：点击注册页面，详细操作请参考注册华为账号并开通华为云。 企业实名认证：点击进行实名认证。 02 申请5G消息公测体验 企业用户申请5G消息公测体验 03 线上用户开通5G消息业务 企业用户线上注册开通5G消息业务：5G消息开通备案管理 04 发送5G消息 企业用户5G消息应用开发。 企业用户上行地址URL固定菜单配置申请。 05 5G消息增强版支持回落视频短信场景 视频短信套餐购买路径：iTA官网-产品服务-消息-视频短信。 企业用户在ITA官网购买视频短信套餐时，需要勾选H5 chatbot能力。 利用5G消息降级接口，同时兼容5G消息增强版以及5G消息标准版下发。

申请5G消息公测体验 根据企业需求，用户可以通过华为云官网，申请5G消息业务公测体验。 进入5G消息产品首页，点击“公测体验”。 点击“立即申请”，填写申请公测信息。 填写完所有信息后，勾选“同意《公测试用服务协议》”，点击“申请公测”。 企业用户申请华为公测体验通过后，将同时收到公测申请已经审核通过邮件和服务号接入信息通知邮件，其中服务号接入信息通知邮件包含服务号信息和连接器信息。 5G消息公测申请咨询接口人：邱涛，电话：18061610855 邮箱：qiutao7@h-partners.com

5G消息开通备案管理 进入5G消息控制台后，如果已开通了5G业务，则会直接进入应用管理页面，如果未开通，则弹出“开通5G消息业务”提示窗口。 按照需求开通视频短信回落或短信回落功能，单击我已阅读《5G消息服务声明》、《视频短信服务协议》和《短信服务协议》。 单击“下一步”后，进入“5G消息开通备案管理”页面，可以新增5G消息开通备案。 新增5G消息开通备案。 单击“新增”，进入“5G消息开通备案管理-新增”页面。 参考页面提示，填写5G消息开通备案相关信息。 单击“提交”，完成新增备案。 在“5G消息开通备案管理”页面，输入“企业名称”，可以查询到对应企业的开通备案记录。 已经审核通过的记录，只能新增视频短信签名和短信签名的备案记录。 如果业务报备已经审核通过，但视频短信签名或短信签名报备不通过时，可以修改被驳回的视频短信签名或者短信签名报备记录，再重新提交备案申请。 如果5G业务报备记录未审核通过，则不允许新增和修改视频短信签名和短信签名报备记录（即使已经驳回也不允许修改和新增）。 操作列操作列中单击“5G消息业务开通详情”，可以查看5G消息业务的开通详情。 、 单击“短信审核详情”，进入短信审核详情页面。 单击“视频短信审核详情”，进入视频短信审核详情页面。

5G消息开通备案管理 5G消息开通备案管理 进入5G消息控制台后，如果已开通了5G业务，则会直接进入应用管理页面，如果未开通，则弹出“开通5G消息业务”提示窗口。 按照需求开通视频短信回落或短信回落功能，单击我已阅读《5G消息服务声明》、《视频短信服务协议》和《短信服务协议》。 单击“下一步”后，进入“5G消息开通备案管理”页面，可以新增5G消息开通备案。 新增5G消息开通备案。 单击“新增”，进入“5G消息开通备案管理-新增”页面。 参考页面提示，填写5G消息开通备案相关信息。 单击“提交”，完成新增备案。 在“5G消息开通备案管理”页面，输入“企业名称”，可以查询到对应企业的开通备案记录。 已经审核通过的记录，只能新增视频短信签名和短信签名的备案记录。 如果业务报备已经审核通过，但视频短信签名或短信签名报备不通过时，可以修改被驳回的视频短信签名或者短信签名报备记录，再重新提交备案申请。 如果5G业务报备记录未审核通过，则不允许新增和修改视频短信签名和短信签名报备记录（即使已经驳回也不允许修改和新增）。 操作列操作列中单击“5G消息业务开通详情”，可以查看5G消息业务的开通详情。 、 单击“短信审核详情”，进入短信审核详情页面。 单击“视频短信审核详情”，进入视频短信审核详情页面。

5G消息开通备案管理 5G消息开通备案管理 进入5G消息控制台后，如果已开通了5G业务，则会直接进入应用管理页面，如果未开通，则弹出“开通5G消息业务”提示窗口。 按照需求开通视频短信回落或短信回落功能，单击我已阅读《5G消息服务声明》、《视频短信服务协议》和《短信服务协议》。 单击“下一步”后，进入“5G消息开通备案管理”页面，可以新增5G消息开通备案。 新增5G消息开通备案。 单击“新增”，进入“5G消息开通备案管理-新增”页面。 参考页面提示，填写5G消息开户信息栏的内容。 在签名报备信息栏，单击“新增”，进入新增签名报备信息页面。 填写签名报备信息，单击“确定”后，返回“5G消息开通备案管理-新增”页面。 单击“提交”，完成新增备案。 在“5G消息开通备案管理”页面，输入“企业名称”，可以查询到对应企业的开通备案记录。 已经审核通过的记录，只能新增视频短信签名和短信签名的备案记录。 如果业务报备已经审核通过，但视频短信签名或短信签名报备不通过时，可以修改被驳回的视频短信签名或者短信签名报备记录，再重新提交备案申请。 如果5G业务报备记录未审核通过，则不允许新增和修改视频短信签名和短信签名报备记录（即使已经驳回也不允许修改和新增）。 操作列操作列中单击“5G消息业务开通详情”，可以查看5G消息业务的开通详情。 、 单击“短信审核详情”，进入短信审核详情页面。 单击“视频短信审核详情”，进入视频短信审核详情页面。

发送状态报告通知请求示例 POST /openchatbot/v2/DeliveryInfoNotification HTTP/1.1 Authorization: Username="chatbottest12swt70",Password="******" Content-Type: application/json Date: Sun, 28 Jun 2020 06:23:33 GMT Accept: */* Accept-Encoding: gzip, deflate, br Cookie: JSESSIONID=A4F1AE0967E87AD57CF106D295505CA4 traceUniqueID: 504021504652012181433190002002 Host: 10.179.126.105:8451 Connection: close Content-Length: 358 { "deliveryInfo": { "address": "tel:+8612345678911", "messageId": "2827c3a6-ee61-11ea-a172-fa163e6a8a4e", "deliveryStatus": "DeliveredToTerminal", "description": "SVC5001" }, "link": [ { "rel": "OutboundMessageRequest", "href": "http://example.com/exampleAPI/messaging/v1/outbound/sip%3A12599%40botplatform.rcs.chinamobile.com/requests/27437fcf-aa6e-4656-bdb1-695477cdddd9" } ] }