jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的云短信发送国际/港澳台短信

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 发送国际/港澳台短信

#  发送国际/港澳台短信

最近更新时间: 2022-10-10 11:18:33

# 发送国际/港澳台短信 (POST Oversea Message)

## 请求定义

    
    
    POST /v1/message/oversea HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求数据

> 该接口定义以下请求数据:
    
    
    {
        "template_id": string,
        "mobiles": []string,
        "parameters": map[string]string|number,
        "sender_id": string
    }
    

参数名称 | 类型 | 必填 | 说明  
---|---|---|---  
template_id | string | 是 | 模板 ID  
mobiles | []string | 是 | 手机号列表，例如：["+17245678901", “+17245678902”]  
parameters | map[string]string | 否 | 自定义魔法变量，变量设置在创建模板时，参数template指定  
sender_id | string | 否 | SenderID，用于在国际短信中标识发送者  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "message_id": string
    }
    

# 全文发送国际/港澳台短信 (POST Oversea Fulltext Message)

## 请求定义

    
    
    POST /v1/message/oversea_fulltext HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/json
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求数据

> 该接口定义以下请求数据:
    
    
    {
        "content": string,
        "mobiles": []string,
        "template_type": string,
        "sender_id": string
    }
    

参数名称 | 类型 | 必填 | 说明  
---|---|---|---  
content | string | 是 | 消息内容  
mobiles | []string | 是 | 手机号列表，例如：["+17245678901", “+17245678901”]  
template_type | string | 否 | 短信类型，支持的值：notification(通知类)、verification(验证码类)、marketing(营销推广类)、voice(语音类)  
sender_id | string | 否 | SenderID，用于在国际短信中标识发送者  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "message_id": string
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信查询发送记录

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 查询发送记录

#  查询发送记录

最近更新时间: 2020-08-25 10:35:28

# 查询短信发送记录

## 请求定义

    
    
    GET /v1/messages HTTP/1.1
    Host: sms.qiniuapi.com
    Authorization: <QiniuToken>
    Content-Type: application/x-www-form-urlencoded
    

### 请求头

> 请参考 [请求认证](https://developer.qiniu.com/sms/api/5842/sms-api-authentication)

### 请求参数

该接口定义以下请求参数:

名称 | 必填 | 描述  
---|---|---  
job_id | 否 | 发送任务返回的 id   
message_id | 否 | 单条短信发送接口返回的 id  
mobile | 否 | 接收短信的手机号码  
status | 否 | 短信的状态，sending: 发送中，success: 发送成功，failed: 发送失败，waiting: 等待发送  
template_id | 否 | 模版 id   
type | 否 | 短信类型，marketing: 营销短信，notification: 通知短信，verification: 验证码类短信，voice: 语音短信  
start | 否 | 开始时间，timestamp，例如: 1563280448  
end | 否 | 结束时间，timestamp，例如: 1563280471  
page | 否 | 页码，默认为 1  
page_size | 否 | 每页返回的数据条数，默认20，最大200  
  
## 响应定义

### 该接口正确处理请求时返回如下 JSON 数据

    
    
    {
        "page": int,
        "page_size": int,
        "items":[{
            "message_id": string,
            "job_id": string,
            "mobile": string,
            "content": string,
            "status": string,
            "type": string,
            "error": string, // 短信发送失败详细状态信息
            "count": int, // 发送的短信条数
            "created_at": timestamp,  // 短信发送时间
            "delivrd_at": timestamp // 如果短信发送失败，那么不会返回这个字段
        }...]
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信消息推送

gpt: [云短信](https://developer.qiniu.com/sms) > API 文档 > 消息推送

#  消息推送

最近更新时间: 2023-05-24 17:28:36

# 状态回调

### 功能描述

短信发送给用户后，将会通过回调业务 URL 的方式，通知业务方用户发送短信的状态。

### 回调方法

HTTP POST

### 回调的内容

    
    
    {
        "items":[{
            "mobile": "<string>",
            "message_id": "<string>", // 单条发送的时候返回的 message_id
            "status": "<string>", // DELIVRD 送达， FAILED 发送失败
            "delivrd_at": <timestamp>,
            "error": "<string>", // 当 status 为 FAILED 的时候，会有这个字段，
            "job_id": "<string>", // 批量发送的时候返回的 job_id
            "seq": "<string>" // 发送时携带的 seq
        }]
    }
    

#### 状态回调内容示例

    
    
    POST https://example.com/sms/status/callback
    Content-Type: application/json
    
    {"items":[{"mobile":"13812345678","message_id":"34114035","status":"DELIVRD","delivrd_at":1558692400,"seq":"qiniuseq"}]}
    

### 返回

业务返回 HTTP 状态码 200

如果返回不是 200，会在10分钟内自动重试

# 上行回调

### 功能描述

用户收到短信后，回复短信，七牛云短信服务可以通过回调业务 url 的方式，通知业务方用户回复了短信。

### 回调方法

HTTP POST

### 回调内容

    
    
    {
    	"items": [{
                    "dest_code":"<string>", //用户发送短信的目的号码
    		"mobile": "<string>",   //用户手机号码
    		"content": "<string>",  //短信内容
    		"time": <timestamp>     //用户发送短信时间
    	}]
    }
    

#### 上行回调内容示例

    
    
    POST https://example.com/sms/reply/callback
    Content-Type: application/json
    
    {"items":[{"mobile":"13812345678","content":"TD","time":1558692400, "dest_code":"10692012345678"}]}
    

### 返回

业务返回 HTTP 状态码 200

如果返回不是 200，会在10分钟内自动重试

# 如何设置

打开 Portal 控制台：https://portal.qiniu.com/sms/settings 即可设置

以上内容是否对您有帮助？
human: 如何处理七牛云的云短信SDK

gpt: [云短信](https://developer.qiniu.com/sms) > SDK 下载 > SDK

#  SDK

最近更新时间: 2024-03-08 16:48:04

> 说明：  
>  SDK名称：云短信SDK  
>  开发者：上海七牛信息技术有限公司  
>  云短信 SDK 合规使用说明请参考[七牛 SDK 合规使用说明
> __](https://developer.qiniu.com/pili/12616/sdk-compliance-
> instructions)；隐私政策说明请参考[七牛 SDK 隐私策略
> __](https://developer.qiniu.com/pili/8027/sdk-privacy-policy)

开发语言 | 下载地址 | 导入路径  
---|---|---  
Java | [java-sdk-v7.15.0 __](https://github.com/qiniu/java-sdk/releases/tag/v7.15.0)|  src/main/java/com/qiniu/sms  
Golang | [go-sdk-v7.19.0 __](https://github.com/qiniu/go-sdk/releases/tag/v7.19.0)|  sms  
PHP | [php-sdk-v7.12.0 __](https://github.com/qiniu/php-sdk/releases/tag/v7.12.0)|  src/Qiniu/Sms  
Python | [python-sdk-v7.13.0 __](https://github.com/qiniu/python-sdk/releases/tag/v7.13.0)|  qiniu/services/sms  
nodejs | [nodejs-sdk-v7.11.0 __](https://github.com/qiniu/nodejs-sdk/releases/tag/v7.11.0)|  qiniu/sms  
Ruby | [ruby-sdk-v1.0.0 __](https://developer.qiniu.com/sms/sdk/5994/ruby-sdk)|   
  
以上内容是否对您有帮助？
human: 如何处理七牛云的边缘加速产品概述

gpt: [边缘加速](https://developer.qiniu.com/PCDN) > 使用文档 > 产品简介 >产品概述

#  产品概述

最近更新时间: 2022-01-12 18:43:40

# 产品简介

边缘加速是基于 P2P 技术的内容分发网络产品。相比 CDN 而言，边缘加速单价较低，更适用于大流量内容分发。边缘加速产品是与传统 CDN
互补协作的关系，以 P2P 技术为核心的分布式边缘加速系统可与传统 CDN 集成，形成互补协作，边缘加速相对于 CDN 进行了相应的扩容、提速、降费。

# 产品架构

  
![](https://dn-odum9helk.qbox.me/Fnq4d1ksjCiWkb9g-jr9crEb0zjZ)

以上内容是否对您有帮助？
human: 如何处理七牛云的边缘加速功能特性

gpt: [边缘加速](https://developer.qiniu.com/PCDN) > 使用文档 > 产品简介 >功能特性

#  功能特性

最近更新时间: 2022-01-12 18:42:28

# 降低带宽成本

与普通 CDN 相比，使用 P2P 协议可使热点内容分发成本优化 50%，显著降低综合带宽成本。

# 提升服务体验

全网卡顿率降低 25%、卡顿时长降低 50%；有网播放失败率降低 80%；全网平均下载速度提升 50%。

# 百万级在线设备稳定可靠

500 万潜在供给设备提升内容分发系统的可靠性，消除性能瓶颈和单点故障，服务失败率为传统 CDN 的 10%。

# 多种接入方式快速集成

提供 SDK、Cname 多种接入方式，满足多种使用场景。非侵入式对接，不改变客户现有技术体系。

以上内容是否对您有帮助？
human: 如何处理七牛云的边缘加速服务保障协议 (SLA)

gpt: [边缘加速](https://developer.qiniu.com/PCDN) > 使用文档 > 产品简介 >服务保障协议 (SLA)

#  服务保障协议 (SLA)

最近更新时间: 2022-01-12 18:42:45

# 服务内容

七牛边缘加速将 P2P 协议融入传统 CDN
服务，通过挖掘海量闲置资源的上行带宽，将节点进一步下沉至边缘。使用边缘加速可以极大地降低热点内容的分发成本，同时消除了来自于服务器的性能瓶颈和单点故障问题，提升终端用户的使用体验。

本服务等级协议（Service Level Agreement，简称 “SLA”）规定了七牛云向客户提供的边缘加速的服务可用性等级指标及赔偿方案。

# 定义

  * 服务：指七牛云边缘加速根据本协议向开发者提供的付费服务。
  * 下载内容：指用户使用七牛云边缘加速服务的域名下所有供用户下载的文件。
  * 点播流媒体内容：指目前互联网常用的流媒体格式文件
  * 服务周期：一个服务周期为一个自然月。若客户使用七牛云边缘加速服务不满一个月，则不计算为一个服务周期。
  * 月度服务费用：一个自然月中，客户所支付的边缘加速服务费用总额。
  * 单位时间内请求本地地址次数：单位时间内，对通过边缘加速 SDK 地址转换函数得到的本地地址（127.0.0.1）的请求次数。
  * 单位时间内请求本地地址返回5xx错误次数：单位时间内，对通过边缘加速 SDK地址转换函数得到的本地地址（127.0.0.1）发起请求，并返回5xx错误的次数。
  * 不可用率计算公式：不可用率 = (单位时间内请求本地地址返回5xx错误次数 / 单位时间内请求本地地址次数) * 100% 。
  * SDK崩溃率计算公式：SDK崩溃率 = (单位时间内发生SDK崩溃的客户端数量 / 单位时间内活跃的客户端数量) * 100% 。
  * 不可用时间：单位时间内（以5分钟为一个统计粒度）不可用率大于0.1%，或SDK崩溃率大于0.1%，若两者中满足任意一项，则视为边缘加速服务在该单位时间内不可用；边缘加速所提供的服务在连续的10分钟或更长时间不可使用（也即至少有连续两个不可用点）则计为不可用时间。

以下情况不在统计范围内：

  * 直接访问原CDN地址而非本地地址（127.0.0.1）的请求。
  * 由于源站问题而导致的5xx错误。
  * 与CDN拆分售卖情况下，由CDN导致的5xx错误。
  * 内容违规或其它原因而导致域名被封禁而产生的错误。
  * 单位时间（每5分钟）内活跃客户端数量不足10000。
  * 单位时间（每5分钟）内总请求数不足10000。

# 服务可用性

  * 服务可用性计算公式：[（服务周期内应服务总时间 – 服务周期内不可用时间）/ 服务周期内应服务总时间 ] * 100% 。
  * 服务可用性承诺：边缘加速服务可用性不低于99.9% 。如未达到此可用性承诺，客户可以根据本协议中赔偿方案的约定获得赔偿。赔偿范围不包括以下原因所导致的服务不可用时间： 
    1. 七牛云预先通知客户后进行系统维护所引起的，包括割接、维修、升级和模拟故障演练；
    2. 任何七牛云所控制或所属设备以外的网络、设备故障或配置调整引起的；
    3. 客户的应用程序受到黑客攻击而引起的；
    4. 客户维护不当或保密不当致使数据、口令、密码等丢失或泄漏所引起的；
    5. 客户的疏忽或由客户授权的操作所引起的；
    6. 客户未遵循七牛云产品使用文档或使用建议引起的；
    7. 不可抗力引起的；
    8. 其他非七牛云原因所造成的不可用，包括但不限于第三方CDN或源站问题导致的不可用。

# 赔偿方案

## 赔偿标准

七牛云对用户存在故障的每个域名按不可用时间进行 10 倍赔偿，赔付金额 = 发生故障的域名故障前 24 小时平均每分钟费用 × 故障不可用时间 × 10
倍。

  * 赔偿只针对使用边缘加速服务已产生费用的用户，以代金券的形式赔偿，不折算现金返还。
  * 故障不可用时间 = 故障解决时间 - 故障开始时间，不可用时间按分钟计算。
  * 如果用户没有使用到 24 小时，按实际使用时长计算平均每分钟费用。
  * 赔付金额不超过客户对该故障域名所消费的费用平均值（故障当月前12个月费用折算平均值）或故障当月客户消费的月度服务费用的25%（服务不满12个月，不包含本月）。

## 赔偿申请时限

客户可以在每月第 5 个工作日后对上个月没有达到可用性的边缘加速服务提出赔偿申请。赔偿申请必须限于在边缘加速没有达到可用性的相关月份结束后 2
个月内提出。超出申请时限的赔偿申请将不被受理。

# 其他

七牛云有权对本SLA条款作出修改。如本SLA条款有任何修改，七牛云将提前30天以网站公示或发送邮件的方式通知您。如您不同意七牛云对SLA所做的修改，您有权停止使用边缘加速服务，如您继续使用边缘加速服务，则视为您接受修改后的SLA。

以上内容是否对您有帮助？
human: 如何处理七牛云的边缘加速产品服务公告-增加合规性校验的通知

gpt: [边缘加速](https://developer.qiniu.com/PCDN) > 产品动态 > 产品服务公告-增加合规性校验的通知

#  产品服务公告-增加合规性校验的通知

最近更新时间: 2023-04-19 16:52:36

尊敬的客户：  
您好！边缘加速产品服务将于本周进行产品升级——增加合规性校验。服务时将会验证访问域名与请求Token是否关联，以及验证域名是否具备ICP备案。不符合以上规则的域名将不再提供服务调度。Portal将于近期上线添加域名的能力，并支持绑定Token。Token暂不支持自助生成，我方会在后台提前帮您进行录入，并绑定历史域名。  
如您在使用过程中有任何问题，请随时与我们 [联系 __](https://www.qiniu.com/contact)。谢谢。

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯IM服务接入指南

gpt: [即时通讯](https://developer.qiniu.com/IM) > 使用指南 > IM服务接入指南

#  IM服务接入指南

最近更新时间: 2021-10-14 17:06:15

# 一、接入流程

> 即时通讯IM产品，目前暂时只支持中国大陆区域使用。支持iOS、Android、Web平台互通。

**1、注册账号**  
七牛云官网，前往[注册页面 __](https://portal.qiniu.com/signup)

**2、实名认证**  
前往七牛实名认证页面，进行[实名认证 __](https://portal.qiniu.com/identity/choice)

**3、创建RTC应用**  
在实时音视频业务板块中[创建应用 __](https://portal.qiniu.com/rtn/app/create)  
![2.png](https://dn-odum9helk.qbox.me/Fta6jTuzVrOC18f7QAyC4Lc15TMf)

**4、开通IM服务**  
创建RTC应用完成，查看应用详情页面，找到即时通讯服务模块，点击开启，如下图所示  
![开启IM服务.png](https://dn-odum9helk.qbox.me/FuWNvxZamfdTU13iOONVNlxhWF2r)

**5、升级到商业版**

注意：  
（1）免费版仅用于开发测试阶段，正式使用请升级到商业版。  
（2）商业版开通当天会立即开始计费，最低为 30 元/日。  
（3）商业版支持某些高级功能和增值服务，详见下文免费版与商业版的区别

为保证服务质量，避免误操作，开通商业版需通过工单进行申请。

# 二、免费版与商业版

**1、免费版只有100个注册用户，所以只用于测试阶段。正式使用请开通商业版。**

**2、商业版一旦开通，每天都会计费，最低为30元/天。若不再使用IM服务，请将商业版降级到免费版。**

**3、商业版允许使用高级功能，且允许进一步购买增值功能**

**4、免费版和商业版的功能区域对比如下表，商业版才会有高级功能区域**

功能区 | 免费版 | 商业版  
---|---|---  
基础设置 | 有 | 有  
套餐设置 | 有 | 有  
高级功能 | 没有 | 有  
管理员Token | 有 | 有  
  
**5、免费版和商业版的 基础设置 及 管理员Token 没有区别，套餐设置对比如下表**

项 | 免费版 | 商业版  
---|---|---  
注册用户限制 | 100 | 不限  
群规模 | 200 人群 | 2000 人群  
群数量 | 500 个群/用户 | 1000 个群/用户  
离线消息数 | 500 条（单群上限100条） | 1000 条（单群上限200条）  
每日下行消息数 | 2 万条 | 1000 万条  
历史消息云存储 | 7 天 | 30 天  
接口限流QPS | 10 次/秒 | 30 次/秒  
每用户支持设备数 | 3 | 5个  
  
> 注意：聊天室 和 群
> 的区别是：聊天室在用户退出聊天后，用户就退出了聊天室成员列表。但群里面的用户退出聊天后，用户还是在群成员列表中的。群有群规模限制，而聊天室是不限制人数规模的。所以聊天室较多用于大型直播间场景。

# 三、增值服务

开通商业版后，在**高级功能** 和**套餐设置** 中，共有9个增值服务项目。  
每一项增值服务单独计费，增值服务在开通当日就会立即收费，且开通后每日都会产生费用。  
所以若不继续使用，请将其恢复到商业版初始设置（将套餐设置为最小值、将高级功能的开关关闭）。  
增值服务计费项如下表

序号 | 9个计费项名称 | 日单价（元）  
---|---|---  
1 | IM-高级API | 50  
2 | IM-信息订阅定制 | 100  
3 | IM-内容安全加强 | 50  
4 | IM-群人数上限5000人 | 50  
5 | IM-每日下行消息数1500万条 | 500  
6 | IM-每日下行消息数2000万条 | 1000  
7 | IM-历史消息云存储90天 | 50  
8 | IM-历史消息云存储180天 | 100  
9 | IM-支持设备数10个 | 100  
  
> 注意：高级功能中的**用户消息回调地址** 和**默认服务** ，可在开通商业版后直接设置使用。

# 四、管理员Token

Token 主要用于服务端 API 鉴权，只在生成时显示一次。  
![管理员token.png](https://dn-odum9helk.qbox.me/FqTAhljCV5Z82t2R6qyZ_q_CP8cz)

# 五、获取支持

商务支持：若有商务或价格方面的问题，可联系 400-808-9176 转 1 获取商务支持。  
技术支持：若在集成开发过程中，需要技术支持，可通过工单系统提交工单。

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯服务端API

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > 服务端API

#  服务端API

最近更新时间: 2021-06-28 11:05:15

调用IM服务端API前，请先从控制台获取参数api_endpoint、app_id、access-token。  
api_endpoint是服务地址，app_id，access-token在请求Header中使用。未特殊说明的请求Content-
Type类型为application/json。

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯状态回调

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 >
[服务端API](https://developer.qiniu.com/IM/api/8094/im-server-api-reference) >
状态回调

#  状态回调

最近更新时间: 2022-01-19 18:37:32

# 用户状态回调

通过注册用户在线状态回调，系统会将应用内用户的在线状态变更事件，实时抄送到设定的服务器。

开通IM 商业版后，可以在Portal 后台，IM管理页面的【高级功能】部分，开启【信息订阅定制】服务。并设置用户在线状态回调地址。

用户系统可以根据该事件，作为一些自己业务的触发。

## 回调的方法

系统通过HTTP POST 方法，调用所设置的HTTP 接口。

## 回调的消息格式

回调消息，通过JSON 字符串的形式，在Body 中传递。使用UTF-8 编码。消息样例如下：

    
    
    {
      "timestamp": "1621838541791",  //事件时间戳（毫秒）  
      "node": "fireplace@10.244.1.69", //事件产生的节点
      "xid": {
        "uid": "6597439728320",   // 用户ID
        "deviceSN": 125171        // 用户设备序号
      },
      "status": "ONLINE",         // ONLINE表示上线，OFFLINE表示下线
      "reason": "",               // 原因： replaced 表示设备被其它设备踢下线
      "ip": "10.244.1.1:65167",   // 客户端IP
      "version": "3.0.2",         // 客户端SDK版本号
      "appId": "eajzxtgmgets"     // APPID
    }
    

## 回调接口返回

收到，并成功处理消息回调后，接口应该返回 HTTP 状态码 200。

# 消息回调

通过注册系统回调，实时订阅用户消息。系统将会将应用内用户发送的消息实时抄送到设定的服务器。

此功能可被用来作为应用消息的转存，或者作为其他业务的触发机制。

开通商业版后，可以在Portal 管理后台，IM管理页面的【信息订阅定制】部分，配置【用户消息回调地址】来接收消息回调。

请确保接收服务器的可用性，如果指定服务不可用或者网络原因中断，系统会尝试推送三次，如果仍然不可推送，会将消息存入失败队列，失败队列内消息默认存放三天，可以通过接口轮询获取。

## 回调的方法

系统通过HTTP POST 方法，调用所设置的HTTP 接口。

## 回调的消息格式

回调消息，通过JSON 字符串的形式，在Body 中传递。使用UTF-8 编码。消息样例如下：

    
    
    { 
      "timestamp": "1583290166510", // 时间戳字符串类型 
      "node": "fireplace@10.244.0.112", // 消息发送节点
      "from": { // 消息发送者
        "deviceSN": 393585 
        "uid": "6597271396128", 
      }, 
        "to": {  // 消息接收者
        "uid": "6597321892992" 
      }, 
      "type": "CHAT", // 消息类型, 单聊: CHAT; 群聊: GROUPCHAT
      "msgId": "711785029071536147", // 消息ID
      "innerFrom": { // 消息实际发送者, TYPE为GROUPCHAT
        "uid": "6597271396128", 
        "deviceSN": 393585 
      }, 
      "innerTo": { 
        "uid": "6597321892992" 
      }, 
      "content": "hello, callback!", // 消息内容
      "metaTimestamp": "1583290166473", 
      "appId": "welovemaxim" // 消息appId
    }
    

## 回调接口返回

收到，并成功处理消息回调后，接口应该返回 HTTP 状态码 200。

# 内容安全加强回调

使用内容安全加强回调，对接第三方内容安全服务，高效过滤色情、广告、涉政、暴恐等多类垃圾文字及敏感词、违禁变种。实现协同过滤的目的。

内容安全加强回调功能，可以在开通商业版后开通。在Portal
后台,IM管理页面的【高级功能】部分，开启【内容安全加强】功能，并配置内容安全的回调地址，账号信息。

系统默认可以使用阿里云的内容安全服务。

如果应用希望定制自己的过滤关键词，或者使用已经调校过的第三方内容安全服务，可以在第三方服务注册后在此配置开通。

## 自定义安全接口实现规范

如果用户设置自己的内容安全服务，需要实现一个服务兼容阿里云盾的接口即可。具体可以参考：

  * [文本垃圾内容检测 __](https://help.aliyun.com/document_detail/70439.html)
  * [图片同步检测 __](https://help.aliyun.com/document_detail/70292.html)
  * [公共参数 __](https://help.aliyun.com/document_detail/53413.html)
  * [签名机制 __](https://help.aliyun.com/document_detail/53415.html)

该回调，在系统收到用户发送的消息，实际投递之前进行回调。当接口返回的Suggestion 是 “block”，则系统将不会最终发送改消息。

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯iOS API 参考

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > iOS API 参考

#  iOS API 参考

最近更新时间: 2021-07-16 09:25:06

IM iOS API 参考。

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯Protocol List 协议列表

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > [iOS API
参考](https://developer.qiniu.com/IM/api/8104/im-ios-api-hierarchy) > Protocol
List 协议列表

#  Protocol List 协议列表

最近更新时间: 2021-07-16 09:26:56

协议列表

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯QNIMPushServiceProtocol推送监听

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > [iOS API
参考](https://developer.qiniu.com/IM/api/8104/im-ios-api-hierarchy) > [Protocol
List 协议列表](https://developer.qiniu.com/IM/api/8189/protocol-list) >
QNIMPushServiceProtocol推送监听

#  QNIMPushServiceProtocol推送监听

最近更新时间: 2021-07-15 18:57:50

# QNIMPushServiceProtocol Protocol Reference

Conforms to | NSObject  
---|---  
Declared in | QNIMPushServiceProtocol.h  
  
### `- pushStartDidFinished:`

Push初始化完成通知。

`- (void)pushStartDidFinished:(NSString *) _QNIMToken_`

#### Parameters

QNIMToken | QNIMToken  
---|---  
|  
  
#### Discussion

Push初始化完成通知。

#### Declared In

`QNIMPushServiceProtocol.h`

### `- pushStartDidStopped`

Push功能停止通知。

`- (void)pushStartDidStopped`

#### Discussion

Push功能停止通知。

#### Declared In

`QNIMPushServiceProtocol.h`

### `- certRetrieved:`

Push初始化完成后获取推送证书。

`- (void)certRetrieved:(NSString *) _certification_`

#### Parameters

certification | 推送证书  
---|---  
|  
  
#### Discussion

Push初始化完成后获取推送证书。

#### Declared In

`QNIMPushServiceProtocol.h`

### `- setTagsDidFinished:`

设置用户推送标签成功回调。

`- (void)setTagsDidFinished:(NSString *) _operationId_`

#### Parameters

operationId | 操作id  
---|---  
|  
  
#### Discussion

设置用户推送标签成功回调。

#### Declared In

`QNIMPushServiceProtocol.h`

### `- getTagsDidFinished:`

获取用户推送标签成功回调。

`- (void)getTagsDidFinished:(NSString *) _operationId_`

#### Parameters

operationId | 操作id  
---|---  
|  
  
#### Discussion

获取用户推送标签成功回调。

#### Declared In

`QNIMPushServiceProtocol.h`

### `- deleteTagsDidFinished:`

删除用户推送标签成功回调

`- (void)deleteTagsDidFinished:(NSString *) _operationId_`

#### Parameters

operationId | 操作id  
---|---  
|  
  
#### Discussion

删除用户推送标签成功回调

#### Declared In

`QNIMPushServiceProtocol.h`

### `- clearedTags:`

清空用户推送成功回调。

`- (void)clearedTags:(NSString *) _operationId_`

#### Parameters

operationId | 操作id  
---|---  
|  
  
#### Discussion

清空用户推送成功回调。

#### Declared In

`QNIMPushServiceProtocol.h`

### `- receivedPush:`

接收到新的Push通知

`- (void)receivedPush:(NSArray<QNIMMessageObject*> *) _messages_`

#### Parameters

messages | Push通知列表  
---|---  
|  
  
#### Discussion

接收到新的Push通知

#### Declared In

`QNIMPushServiceProtocol.h`

### `- pushMessageStatusChanged:error:`

发送Push上行消息状态变化通知。

`- (void)pushMessageStatusChanged:(QNIMMessageObject *) _message_
error:(QNIMError *) _error_`

#### Parameters

message | 发生状态变化的上行消息  
---|---  
error | 状态错误码  
  
#### Discussion

发送Push上行消息状态变化通知。

#### Declared In

`QNIMPushServiceProtocol.h`

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯QNIMUserServiceProtocol用户监听

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > [iOS API
参考](https://developer.qiniu.com/IM/api/8104/im-ios-api-hierarchy) > [Protocol
List 协议列表](https://developer.qiniu.com/IM/api/8189/protocol-list) >
QNIMUserServiceProtocol用户监听

#  QNIMUserServiceProtocol用户监听

最近更新时间: 2021-07-15 19:01:21

# QNIMUserServiceProtocol Protocol Reference

Conforms to | NSObject  
---|---  
Declared in | QNIMUserServiceProtocol.h  
  
### `- connectStatusDidChanged:`

链接状态发生变化

`- (void)connectStatusDidChanged:(QNIMConnectStatus) _status_`

#### Parameters

status | 网络状态  
---|---  
|  
  
#### Discussion

链接状态发生变化

#### Declared In

`QNIMUserServiceProtocol.h`

### `- userSignIn:`

用户登陆

`- (void)userSignIn:(QNIMUserProfile *) _userProflie_`

#### Parameters

userProflie | 用户信息  
---|---  
|  
  
#### Discussion

用户登陆

#### Declared In

`QNIMUserServiceProtocol.h`

### `- userSignOut:userId:`

用户登出

`- (void)userSignOut:(QNIMError *) _error_ userId:(long long) _userId_`

#### Parameters

error | 错误码  
---|---  
|  
  
#### Discussion

用户登出

#### Declared In

`QNIMUserServiceProtocol.h`

### `- userInfoDidUpdated:`

同步用户信息更新（其他设备操作发生用户信息变更）

`- (void)userInfoDidUpdated:(QNIMUserProfile *) _userProflie_`

#### Discussion

同步用户信息更新（其他设备操作发生用户信息变更）

#### Declared In

`QNIMUserServiceProtocol.h`

### `- userOtherDeviceDidSignIn:`

用户在其他设备上登陆

`- (void)userOtherDeviceDidSignIn:(NSInteger) _deviceSN_`

#### Discussion

用户在其他设备上登陆

#### Declared In

`QNIMUserServiceProtocol.h`

### `- userOtherDeviceDidSignOut:`

用户在其他设备上登出

`- (void)userOtherDeviceDidSignOut:(NSInteger) _deviceSN_`

#### Discussion

用户在其他设备上登出

#### Declared In

`QNIMUserServiceProtocol.h`

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯Class List 类列表

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > [iOS API
参考](https://developer.qiniu.com/IM/api/8104/im-ios-api-hierarchy) > Class List
类列表

#  Class List 类列表

最近更新时间: 2021-07-16 09:25:14

类列表

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯QNIMRoster好友

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > [iOS API
参考](https://developer.qiniu.com/IM/api/8104/im-ios-api-hierarchy) > [Class
List 类列表](https://developer.qiniu.com/IM/api/8190/class-list) > QNIMRoster好友

#  QNIMRoster好友

最近更新时间: 2021-07-16 09:25:21

# QNIMRoster Class Reference

Inherits from | NSObject  
---|---  
Declared in | QNIMRoster.h  
  
### ` rosterId`

好友Id

`@property (nonatomic, assign, readonly) long long rosterId`

#### Discussion

好友Id

#### Declared In

`QNIMRoster.h`

### ` userName`

好友名

`@property (nonatomic, copy, readonly) NSString *userName`

#### Discussion

好友名

#### Declared In

`QNIMRoster.h`

### ` nickName`

好友昵称

`@property (nonatomic, copy, readonly) NSString *nickName`

#### Discussion

好友昵称

#### Declared In

`QNIMRoster.h`

### ` avatarUrl`

好友头像

`@property (nonatomic, copy, readonly) NSString *avatarUrl`

#### Discussion

好友头像

#### Declared In

`QNIMRoster.h`

### ` avatarPath`

好友头像本地存储路径

`@property (nonatomic, copy, readonly) NSString *avatarPath`

#### Discussion

好友头像本地存储路径

#### Declared In

`QNIMRoster.h`

### ` avatarThumbnailPath`

好友头像缩略图本地存储路径

`@property (nonatomic, copy, readonly) NSString *avatarThumbnailPath`

#### Discussion

好友头像缩略图本地存储路径

#### Declared In

`QNIMRoster.h`

### ` json_PublicInfo`

扩展信息，用户设置的好友可以看到的信息，比如地址，个性签名等

`@property (nonatomic, copy, readonly) NSString *json_PublicInfo`

#### Discussion

扩展信息，用户设置的好友可以看到的信息，比如地址，个性签名等

#### Declared In

`QNIMRoster.h`

### ` json_alias`

用户对好友添加的备注等信息

`@property (nonatomic, copy, readonly) NSString *json_alias`

#### Discussion

用户对好友添加的备注等信息

#### Declared In

`QNIMRoster.h`

### ` json_ext`

用户的服务器扩展信息

`@property (nonatomic, copy, readonly) NSString *json_ext`

#### Discussion

用户的服务器扩展信息

#### Declared In

`QNIMRoster.h`

### ` json_localExt`

用户的本地扩展信息

`@property (nonatomic, copy, readonly) NSString *json_localExt`

#### Discussion

用户的本地扩展信息

#### Declared In

`QNIMRoster.h`

### ` isMuteNotification`

是否提醒用户消息

`@property (nonatomic, assign, readonly) BOOL isMuteNotification`

#### Discussion

是否提醒用户消息

#### Declared In

`QNIMRoster.h`

### ` rosterRelation`

联系人关系

`@property (nonatomic, assign, readonly) QNIMRosterRelation rosterRelation`

#### Discussion

联系人关系

#### Declared In

`QNIMRoster.h`

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯QNIMPushUserProfile推送用户

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > [iOS API
参考](https://developer.qiniu.com/IM/api/8104/im-ios-api-hierarchy) > [Class
List 类列表](https://developer.qiniu.com/IM/api/8190/class-list) >
QNIMPushUserProfile推送用户

#  QNIMPushUserProfile推送用户

最近更新时间: 2021-07-16 09:25:36

# QNIMPushUserProfile Class Reference

Inherits from | NSObject  
---|---  
Declared in | QNIMPushUserProfile.h  
  
### ` userId`

用户ID（唯一）

`@property (nonatomic, assign, readonly) NSInteger userId`

#### Discussion

用户ID（唯一）

#### Declared In

`QNIMPushUserProfile.h`

### ` pushAlias`

推送用户别名

`@property (nonatomic, copy, readonly) NSString *pushAlias`

#### Discussion

推送用户别名

#### Declared In

`QNIMPushUserProfile.h`

### ` pushToken`

推送用户token

`@property (nonatomic, copy, readonly) NSString *pushToken`

#### Discussion

推送用户token

#### Declared In

`QNIMPushUserProfile.h`

### ` setting`

推送用户消息设定

`@property (nonatomic, strong) QNIMMessagePushSetting *setting`

#### Discussion

推送用户消息设定

#### Declared In

`QNIMPushUserProfile.h`

以上内容是否对您有帮助？
human: 如何处理七牛云的即时通讯QNIMSDKConfig设置

gpt: [即时通讯](https://developer.qiniu.com/IM) > API 文档 > [iOS API
参考](https://developer.qiniu.com/IM/api/8104/im-ios-api-hierarchy) > [Class
List 类列表](https://developer.qiniu.com/IM/api/8190/class-list) >
QNIMSDKConfig设置

#  QNIMSDKConfig设置

最近更新时间: 2021-07-16 09:25:43

# QNIMSDKConfig Class Reference

Inherits from | NSObject  
---|---  
Declared in | QNIMSDKConfig.h  
  
### ` deviceUUID`

获取设备的唯一识别码,如果使用数据库

`@property (nonatomic, copy) NSString *deviceUUID`

#### Discussion

获取设备的唯一识别码,如果使用数据库

#### Declared In

`QNIMSDKConfig.h`

### ` enableDNS`

获取是否启用dns功能,设置是否启用dns功能，默认是开启的。

`@property (nonatomic, assign) BOOL enableDNS`

#### Discussion

获取是否启用dns功能,设置是否启用dns功能，默认是开启的。

#### Declared In

`QNIMSDKConfig.h`

### ` userDNSAddress`

获取用户自定义dns服务器地址,设置用户自定义dns服务器地址，在用户设置了dns服务器的情况下优先使用用户dns。

`@property (nonatomic, copy) NSString *userDNSAddress`

#### Discussion

获取用户自定义dns服务器地址,设置用户自定义dns服务器地址，在用户设置了dns服务器的情况下优先使用用户dns。

#### Declared In

`QNIMSDKConfig.h`

### ` appID`

获取用户的appId, 设置用户的appId。

`@property (nonatomic, copy) NSString *appID`

#### Discussion

获取用户的appId, 设置用户的appId。

#### Declared In

`QNIMSDKConfig.h`

### ` debugLogRecevierID`

设置调试log接收账号(仅用于SDK调试，接收客户端log日志使用)

`@property (nonatomic, copy) NSString *debugLogRecevierID`

#### Discussion

设置调试log接收账号(仅用于SDK调试，接收客户端log日志使用)

#### Declared In

`QNIMSDKConfig.h`

以上内容是否对您有帮助？