<p><strong>公共请求参数</strong></p> <p>公共请求参数是指每个接口都需要使用到的请求参数。</p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>名称</strong></p> </td> <td> <p><strong>类型</strong></p> </td> <td> <p><strong>是否必须</strong></p> </td> <td> <p><strong>描述</strong></p> </td> </tr> <tr> <td> <p>version</p> </td> <td> <p>String</p> </td> <td> <p>是</p> </td> <td> <p>API 版本号，为日期形式：YYYY-MM-DD，本版本对应为 2017-01-01</p> </td> </tr> <tr> <td> <p>accessKeyId</p> </td> <td> <p>String</p> </td> <td> <p>是</p> </td> <td> <p>平安金融云颁发给用户的访问服务所用的密钥 ID。</p> </td> </tr> <tr> <td> <p>signature</p> </td> <td> <p>String</p> </td> <td> <p>是</p> </td> <td> <p>签名结果串。关于签名的计算方法，请参见签名机制</p> </td> </tr> <tr> <td> <p>signatureMethod</p> </td> <td> <p>String</p> </td> <td> <p>是</p> </td> <td> <p>签名方式，目前支持HMAC-SHA1</p> </td> </tr> <tr> <td> <p>signatureVersion</p> </td> <td> <p>String</p> </td> <td> <p>是</p> </td> <td> <p>签名算法版本，目前版本是 1.0。</p> </td> </tr> <tr> <td> <p>signatureNonce</p> </td> <td> <p>Long</p> </td> <td> <p>是</p> </td> <td> <p>签名随机数，一个随机的Long值</p> </td> </tr> <tr> <td> <p>timestamp</p> </td> <td> <p>String</p> </td> <td> <p>是</p> </td> <td> <p>当前时间的毫秒时间戳转成String</p> </td> </tr> </tbody> </table> <p>示例：</p> <pre> <code>https://kms-cn-shanghai.ocftcloud.com/?version=2017-01-01 &amp;accessKeyId=testid &amp;signature=YlrFhyqDZQ1ThNYARrv3Ptaxqfc%3D &amp;signatureMethod=HMAC-SHA1 &amp;signatureNonce= 1542160932207 &amp;timestamp= 1542160932207 &amp;signatureVersion=1.0</code></pre> <p><img src="data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==" /><strong>公共返回参数</strong></p> <p>用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码requestId给用户。</p> <p>示例：</p> <pre> <code>{    "requestId":"53912b71-3435-409e-ad05-1882ced04f1f" }</code></pre> <p><img src="data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==" />接口请求的url参数由以下几个部分组成：</p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>名称</strong></p> </td> <td> <p><strong>参数是否参与计算签名</strong></p> </td> </tr> <tr> <td> <p>accessKeyId</p> </td> <td> <p>是</p> </td> </tr> <tr> <td> <p>signature</p> </td> <td> <p>否</p> </td> </tr> <tr> <td> <p>signatureMethod</p> </td> <td> <p>是</p> </td> </tr> <tr> <td> <p>signatureVersion</p> </td> <td> <p>是</p> </td> </tr> <tr> <td> <p>signatureNonce</p> </td> <td> <p>是</p> </td> </tr> <tr> <td> <p>timestamp</p> </td> <td> <p>是</p> </td> </tr> <tr> <td> <p>version</p> </td> <td> <p>是</p> </td> </tr> <tr> <td> <p>具体业务接口参数</p> </td> <td> <p>是</p> </td> </tr> </tbody> </table>