2.0.4 结构化数据样例文件上传服务
<p>[TOC]</p>
<h5>接口功能说明</h5>
<ul>
<li>数据资源-数据样例文件上传</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://ip:port/oidConfirm/oid-confirm-register-business/oidConfirmBusinessService</code></li>
</ul>
<h5>基本信息</h5>
<ul>
<li>POST</li>
<li>Content-Type： multipart/form-data</li>
</ul>
<h5>鉴权认证</h5>
<ul>
<li>需要 authCode、accessToken 鉴权认证</li>
</ul>
<h5>authInfo 请求参数说明</h5>
<table>
<thead>
<tr>
<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;">apiId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>服务编号（externalFileDataSample）</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">accessToken</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>统一用户中心token</td>
</tr>
<tr>
<td style="text-align: left;">timeStamp</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>当前时间戳</td>
</tr>
<tr>
<td style="text-align: left;">authCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>账号鉴权码 （通过<code>1.0.1数据要素登记平台登陆接口</code>获取）</td>
</tr>
<tr>
<td style="text-align: left;">file</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">File</td>
<td>结构化数据样例文件</td>
</tr>
</tbody>
</table>
<h5>使用 curl 发送请求示例</h5>
<pre><code>curl -X POST https://ip/oidConfirm/oid-confirm-register-business/oidConfirmBusinessService \
-H &quot;Content-Type: multipart/form-data&quot; \
-F &quot;apiId=externalFileDataSample&quot; \
-F &quot;appId=test1001&quot; \
-F &quot;accessToken=eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiIxYmQ2MWU1NDkxMWRkNDI0Y2YyMmU3ODJmYTQ2NjEwZSqnZ2VuZ2NuYWJjLDEiLCJpYXQiOjE3MzM4MTQwNTQsImV4cCI6MTczNDQxODg1NH0.lh6oPJVEFJH2123p6TF3p5fr0oKRUptcX3nNYTjj8dqzs3zI4EgGAuXVvteA7kDd5eC33OIZSpy_VukoZx0-GmvIg&quot; \
-F &quot;timeStamp=1733813592643&quot; \
-F &quot;authCode=5686956bf250447e93ef889465d90f57&quot; \
-F &quot;file=@/path/to/结构化数据样例文件.xlsx&quot;
</code></pre>
<h5>使用 API工具 发送请求示例</h5>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=05a06169e7b44ffec21f5caca9201a7c&amp;file=file.png" alt="" /></p>
<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;">bizData</td>
<td style="text-align: left;">Object</td>
<td>返回消息体</td>
</tr>
<tr>
<td style="text-align: left;">resultFlag</td>
<td style="text-align: left;">int</td>
<td>1：成功；-1：失败</td>
</tr>
</tbody>
</table>
<h5>bizData 参数说明</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;">data</td>
<td style="text-align: left;">Array</td>
<td>接口化数据列表</td>
</tr>
<tr>
<td style="text-align: left;">url</td>
<td style="text-align: left;">String</td>
<td>接口化数据样例文件存储url</td>
</tr>
</tbody>
</table>
<h5>data 参数说明</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;">columnDescription</td>
<td style="text-align: left;">Array</td>
<td>字段描述</td>
</tr>
<tr>
<td style="text-align: left;">columnName</td>
<td style="text-align: left;">String</td>
<td>字段名称</td>
</tr>
<tr>
<td style="text-align: left;">dataExample</td>
<td style="text-align: left;">String</td>
<td>数据样例</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;bizData&quot;: {
&quot;data&quot;: [
{
&quot;columnDescription&quot;: &quot;对应时间段指定地区的降水量&quot;,
&quot;columnName&quot;: &quot;降水量&quot;,
&quot;dataExample&quot;: &quot;35mm&quot;
},
{
&quot;columnDescription&quot;: &quot;对应时间段指定地区的气温&quot;,
&quot;columnName&quot;: &quot;气温&quot;,
&quot;dataExample&quot;: &quot;15℃&quot;
},
{
&quot;columnDescription&quot;: &quot;对应时间段指定地区的风向&quot;,
&quot;columnName&quot;: &quot;风向&quot;,
&quot;dataExample&quot;: &quot;265&quot;
},
{
&quot;columnDescription&quot;: &quot;对应时间段指定地区的风速&quot;,
&quot;columnName&quot;: &quot;风速&quot;,
&quot;dataExample&quot;: &quot;5m/s&quot;
},
{
&quot;columnDescription&quot;: &quot;对应时间段指定地区的气压&quot;,
&quot;columnName&quot;: &quot;气压&quot;,
&quot;dataExample&quot;: &quot;1006hPa&quot;
}
],
&quot;url&quot;: &quot;1867135261180424194|obsTest/DocumentTest/OIDRightsTestConfirmation/27eabb65c7fa4680855827190b2fb91a/结构化数据资源模板-1733994673478.xlsx&quot;
},
&quot;bizDataType&quot;: 0,
&quot;fail&quot;: false,
&quot;ok&quot;: true,
&quot;resultFlag&quot;: 1
}
</code></pre>