文档
测试

上传文档添加水印

POST
http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007&cb=url

接口描述

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

请求头

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

Query

参数名
类型
描述
必填
watermark
string
需要添加的水印文字(目前仅支持字母和数字)。示例: 007
必填
cb
string
请求的回调结果类型,默认直接返回文件流,如果cb=url将只返回fileId,使用下载接口单独下载。示例: url
可选

body(form-data)

参数名
类型
描述
必填
file
file
需要添加水印的文件(支持图片和PDF)。示例: test.png
必填

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|文件格式不支持| #### 示例代码 ##### C#访问示例代码: ~~~CSharp var client = new RestClient("http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007"); client.Timeout = -1; var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer a5hmcP2AnRQyBDgv"); request.AddFile("file", "test.png"); IRestResponse response = client.Execute(request); Console.WriteLine(response.Content); ~~~ # ##### Java访问示例代码: ~~~ java OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM) .addFormDataPart("file","test.png", RequestBody.create(MediaType.parse("application/octet-stream"), new File("test.png"))) .build(); Request request = new Request.Builder() .url("http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007") .method("POST", body) .addHeader("Authorization", "Bearer a5hmcP2AnRQyBDgv") .build(); Response response = client.newCall(request).execute(); ~~~ # #### Nodejs访问示例代码 ~~~javascript var axios = require('axios'); var FormData = require('form-data'); var fs = require('fs'); var data = new FormData(); data.append('file', fs.createReadStream('test.png')); var config = { method: 'post', url: 'http://foxconn.gateway.api.liyueyun.com/api/watermark/addWatermark?watermark=007', headers: { 'Authorization': 'Bearer a5hmcP2AnRQyBDgv', ...data.getHeaders() }, data : data }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); }); ~~~