【188】取云文件链接
<p>[TOC]</p>
<h5>接口状态</h5>
<ul>
<li><code>正常</code></li>
</ul>
<h5>框架版本</h5>
<ul>
<li><code>≥ 2.2.5.0</code></li>
</ul>
<h5>更新时间</h5>
<ul>
<li><code>2025/05/01</code></li>
</ul>
<h5>调用额度</h5>
<ul>
<li><code>免额度</code></li>
</ul>
<h5>简要描述</h5>
<ul>
<li>取云文件链接，用于将“文件消息”中的云端文件转为下载链接。</li>
</ul>
<h5>DLL调用例子</h5>
<pre><code>Api_GetCloudFilesLink(&quot;$userNick$&quot;,“file”,“2925200005”,“2449346590”,“新建文本文档.txt”,9, “c9b8d5a626dfc631dc1337f4e2601acd”)</code></pre>
<h5>易语言模块调用例子</h5>
<pre><code>SaiNiu.Api.取云文件链接(&quot;$userNick$&quot;,“file”,“2925200005”,“2449346590”,“新建文本文档.txt”,9, “c9b8d5a626dfc631dc1337f4e2601acd”)</code></pre>
<h5>POST调用例子</h5>
<pre><code>http://127.0.0.1:3030/SaiNiuApi/Api</code></pre>
<pre><code>&amp;post=GetCloudFilesLink&amp;data={&quot;userNick&quot;:&quot;$userNick$&quot;,&quot;nodeType&quot;:&quot;file&quot;,&quot;id&quot;:&quot;2925200005&quot;,&quot;parentId&quot;:&quot;2449346590&quot;,&quot;nodeName&quot;:&quot;新建文本文档.txt&quot;,&quot;nodeSize&quot;:9,&quot;md5&quot;:&quot;c9b8d5a626dfc631dc1337f4e2601acd&quot;}</code></pre>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">是否必填</th>
<th style="text-align: left;">说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">userNick</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">千牛账号,为方便测试$userNick$表示取随机队列账号</td>
<td>tb123456</td>
</tr>
<tr>
<td style="text-align: left;">nodeType</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">通过“文件消息”nodeType参数获取</td>
<td>file</td>
</tr>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">通过“文件消息”id参数获取</td>
<td>2925200005</td>
</tr>
<tr>
<td style="text-align: left;">parentId</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">通过“文件消息”parentId参数获取</td>
<td>2449346590</td>
</tr>
<tr>
<td style="text-align: left;">nodeName</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">文件名，通过“文件消息”nodeName参数获取</td>
<td>新建文本文档.txt</td>
</tr>
<tr>
<td style="text-align: left;">nodeSize</td>
<td style="text-align: left;">整数型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">文件大小，通过“文件消息”nodeSize参数获取</td>
<td>9</td>
</tr>
<tr>
<td style="text-align: left;">md5</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">文件md5，通过“文件消息”md5参数获取</td>
<td>c9b8d5a626dfc631dc1337f4e2601acd</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{&quot;code&quot;:200,&quot;data&quot;:{&quot;msg&quot;:&quot;成功&quot;,&quot;code&quot;:0,&quot;result&quot;:{&quot;scanResult&quot;:&quot;safe&quot;,&quot;url&quot;:&quot;https:\/\/wwimfile.oss-cn-shanghai.aliyuncs.com\/online%7Cc9b8d5a626dfc631dc1337f4e2601acd?Expires=1747128472&amp;OSSAccessKeyId=LTAI5tFyhm5sF2xBEbuxAePK&amp;Signature=bqJioQncvkSlnAnYFeSNXnkEr%2FU%3D&amp;response-content-disposition=filename%3D%22%E6%96%B0%E5%BB%BA%20%E6%96%87%E6%9C%AC%E6%96%87%E6%A1%A3%20%285%29.txt%22&quot;}},&quot;ret&quot;:[&quot;SUCCESS::调用成功&quot;]}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">整数型</td>
<td>返回结果，成功=200，失败≠200</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">文本型</td>
<td>调用结果</td>
</tr>
<tr>
<td style="text-align: left;">reg</td>
<td style="text-align: left;">文本型</td>
<td>结果说明，调用成功或失败原因</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>