文档
测试

传入文档下载地址添加水印

GET
http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007&url=http://10.132.166.110/test.png

接口描述

传入一个文档的下载地址添加水印,默认直接返回文件二进制流,query中添加参数cb=url将只返回fileId,使用下载接口单独下载

请求头

参数名
类型
描述
必填
Authorization
string
示例:Bearer a4ej3APoltdSZYiE
必填

Query

参数名
类型
描述
必填
watermark
string
需要添加的水印文字(目前仅支持字母和数字)。示例: 007
必填
url
string
文档的下载地址(地址需要能够在集团内网访问)。示例: http://10.132.166.110/test.png
必填
cb
string
请求的回调结果类型,默认直接返回文件流,如果cb=url将只返回fileId,使用下载接口单独下载。示例: url
可选

Response

<文件二进制>

Response(cb=url)

``` { "fileId": "ZjAyZTc1NDItNWU5Zi00MDg4LWI5U4LnBu" } ```

说明 / 示例

#### 错误列表 |httpCode|error|message| |-|-|-| |401|AccessTokenNoExist|必须有 accessToken| |401|AccessTokenIsInvalid|无效的 accessToken| |401|AccessTokenHasExpired|accessToken 已过期| |403|SecretIsInvalid|无效的 secret| |403|SecretHasDisabled|secret 已被禁用| |403|SecretError|secret 状态异常| |403|LimitExceeded|已超出用量限制| |400|AddWatermarkNoWatermark|缺少watermark参数| |400|AddWatermarkNoFile|缺少文件| |400|AddWatermarkFormatError|文件格式不支持| |400|AddWatermarkNoUrl|query中没有文档下载地址| #### 示例代码 ##### C#访问示例代码: ~~~CSharp var client = new RestClient("http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007&url=https://upload-images.jianshu.io/upload_images/9824247-4c1b8345dccd0827.jpg"); client.Timeout = -1; var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer a5hmcP2AnRQyBDgv"); IRestResponse response = client.Execute(request); Console.WriteLine(response.Content); ~~~ # ##### Java访问示例代码: ~~~ java OkHttpClient client = new OkHttpClient().newBuilder() .build(); Request request = new Request.Builder() .url("http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007&url=https://upload-images.jianshu.io/upload_images/9824247-4c1b8345dccd0827.jpg") .method("GET", null) .addHeader("Authorization", "Bearer a5hmcP2AnRQyBDgv") .build(); Response response = client.newCall(request).execute(); ~~~ # #### Nodejs访问示例代码 ~~~javascript var axios = require('axios'); var config = { method: 'get', url: 'http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007&url=https://upload-images.jianshu.io/upload_images/9824247-4c1b8345dccd0827.jpg', headers: { 'Authorization': 'Bearer a5hmcP2AnRQyBDgv' } }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); }); ~~~