接口采用标准的HyperText Transfer Protocol(HTTP)协议。
金山云直播黑名单服务为客户提供了管理RTMP推流的功能，主要包括列入某个流或者频道到黑名单中，或者从黑名单中删除。
需要接入金山云直播黑名单服务的客户,需要先拥有金山云ks3颁发的AccessKey和SecretKey。AccessKey用于标示客户的身份，SecretKey作为私钥形式存放于客户服务器不在网络中传递。
金山云直播黑名单服务的请求中必须携带method和app参数，可选携带stream参数，可将某个app下的某个stream列入黑名单并拒绝其推流，直到从黑名单中删除。method可选值为add/del，用于标示请求加入/剔除黑名单。需要注意的是，当携带stream参数时，必须同时携带app参数，用于标示此stream属于某个特定的app。此接口调用成功后立即生效，请求必须携带鉴权参数，以验证是否是合法用户。
请求示例1 (将live下的test流加入黑名单)
GET /blacklist?signature=Wq4VjoEnqbldJe6HfRyTkRavcRg=&accesskey=8oN7siZgTOSFHft0cXTg&expire=1710333224&method=add&app=live&name=test HTTP/1.1
Host: user.dashboard.ks-cdn.com
Date: Wed, 28 Oct 2009 22:32:00 GMT请求示例2 (将live下的test流从黑名单中剔除)
GET /blacklist?signature=Wq4VjoEnqbldJe6HfRyTkRavcRg=&accesskey=8oN7siZgTOSFHft0cXTg&expire=1710333224&method=del&app=live&name=test HTTP/1.1
Host: user.dashboard.ks-cdn.com
Date: Wed, 28 Oct 2009 22:32:00 GMT请求示例3 (将live下的所有流加入黑名单)
GET /blacklist?signature=Wq4VjoEnqbldJe6HfRyTkRavcRg=&accesskey=8oN7siZgTOSFHft0cXTg&expire=1710333224&method=add&app=live HTTP/1.1
Host: user.dashboard.ks-cdn.com
Date: Wed, 28 Oct 2009 22:32:00 GMT请求示例4 (将live下的所有流从黑名单中剔除)
GET /blacklist?signature=Wq4VjoEnqbldJe6HfRyTkRavcRg=&accesskey=8oN7siZgTOSFHft0cXTg&expire=1710333224&method=del&app=live HTTP/1.1
Host: user.dashboard.ks-cdn.com
Date: Wed, 28 Oct 2009 22:32:00 GMT成功响应示例
HTTP/1.1 200 OK
Content-Length: length
Content-Type: text/plain
Date: Wed, 28 Oct 2009 22:32:00 GMT
Server: Nginx