接口调用

在参数说明的上方,还提供了调用说明以及功能说明等API的基本服务信息,供用户浏览查看。

其中,接口地址为该API接口的URL地址。公共请求参数PAGENUM表示接口调用后返回的连续数据样本数量,参数START代表返回的第一个数据样本的索引。

点击在线接口调用按钮,进入在线接口调用页面。在上面的接口参数文本框中输入公共请求参数,点击接口调用按钮,用户可在下方的接口参数窗口中得到JSON格式的返回参数。如下图:

在该示例的返回内容中,冒号前面的内容为字段,并按照层级进行了缩进。

用户返回接口的描述界面,在下方参数说明中这时就会出现该接口返回参数。该示例接口的请求参数与返回参数详细信息如下图所示:

公共数据开放网站服务调用支持三种方式:

用户点击个人中心在我的令牌选项中可以查看令牌,令牌分为签名认证令牌、简单认证令牌。

网站支持重新生成令牌,以备在令牌泄露后禁用原有令牌,并重新生成新的令牌。

其中签名认证令牌由ClientID和ClientSecret两部分组成:

我的令牌页面如下图所示:

用户要查看ClientSecret需点击后面的查看链接,系统会向账号绑定的手机号发送验证码,在下方出现的文本框中输入验证码后,即可查看ClientSecret的具体值。

调用过程

```javaimportorg.apache.commons.codec.binary.Base64;

importjavax.crypto.Mac;importjavax.crypto.spec.SecretKeySpec;

importjava.security.InvalidKeyException;importjava.security.NoSuchAlgorithmException;importjava.time.Instant;importjava.util.UUID;

StringserviceUrl="SERVICE_URL";//具体服务的调用地址inttimeout=500;//服务调用延时StringclientId="YOUR_CLIENT_ID";//替换为用户的client_idStringtimestamp=String.valueOf(Instant.now().toEpochMilli());Stringnonce=UUID.randomUUID().toString();Stringsecret="YOUR_CLIENT_SECRET";//替换为用户的client_secretStringstringToSign=clientId+timestramp+nonce;

Stringsign=null;try{MachmacSha256=Mac.getInstance("HmacSHA256");byte[]keyBytes=secret.getBytes("UTF-8");hmacSha256.init(newSecretKeySpec(keyBytes,0,keyBytes.length,"HmacSHA256"));sign=Base64.encodeBase64String(hmacSha256.doFinal(stringToSign.getBytes("UTF-8")));}catch(NoSuchAlgorithmExceptione){}catch(UnsupportedEncodingExceptione){}catch(InvalidKeyExceptione){}

HttpPostrequestMethod=newHttpPost();//根据服务的具体请求方法构造合适的请求方法对象,此处以POST方法为例说明requestMethod.setURI(serviceUrl);RequestConfigconfig=RequestConfig.custom().setConnectTimeout(timeout).build();requestMethod.setConfig(config);

requestMethod.addHeader("X-Client-Id",clientId);requestMethod.addHeader("X-Timestamp",timestamp);requestMethod.addHeader("X-Nonce",nonce);requestMethod.addHeader("X-Signature",sign);

//处理返回结果```

```javascriptvarurl="";varclientId="";varclientSecret="";

vartimestamp=newDate().getTime();varnonce=createUuid();

vartextToSign=appKey+timestamp+nonce;varhash=CryptoJS.HmacSHA256(textToSign,clientSecret);varsignature=hash.toString(CryptoJS.enc.Base64);

$.ajax({url:url,type:"POST",beforeSend:function(request){request.setRequestHeader("X-Client-Id",clientId);request.setRequestHeader("X-Timestamp",timestamp);request.setRequestHeader("X-Nonce",nonce);request.setRequestHeader("X-Signature",signature);},success:function(result){console.log(result);}});

functioncreateUuid(){return'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g,function?{varr=Math.random()*16|0,v=c=='x'r:(r&0x3|0x8);returnv.toString(16);});}```

调用说明

以上调用接口的过程信息用户可以在该接口的描述页面中的调用说明一栏中查看,如下图:

用户点击个人中心后,在我的令牌选项中可以查看简单认证令牌,如下图:

如页面中提示所说,简单认证令牌通过明文传递,安全性较弱,只适合服务在线调用,不建议在开发的应用中使用。用户点击AppKey的查看链接后,即可显示简单认证令牌的具体值。基于简单认证的接口调用的URL地址格式以及调用方式与签名认证调用接口的一致,但在代码调用时不需要实现API网关的签名认证。

StringserviceUrl="SERVICE_URL";//具体服务的调用地址inttimeout=500;//服务调用延时StringappKey="YOURAPPKEY";//替换为用户的AppKey

requestMethod.addHeader("AppKey",appKey);

用户点击个人中心后,在我的令牌选项中可以查看在老平台申请的所有令牌,如果没有则表示不存在这样的令牌。原有的服务调用令牌如下图所示:

如页面中的提示所说,平台在升级后,为确保原来的服务申请可以正常使用,保留了原来的服务调用令牌。平台将逐步禁用该令牌,并替换为最新的服务令牌。

THE END
1.Swagger中的xnullable是什么意思?Swagger 中的 x-nullable 是什么意思? Swagger 中的 “x-nullable”是一个扩展关键词,用于在 Swagger 或 OpenAPI 规范中标明某个属性是否可以为 null。这个扩展在 API 请求和响应中明确属性可空性,从而增强了 API 文档的表达力与可读性。 什么是 Swagger x-nullable? https://www.jianshu.com/p/1ffdaf76f7e5
2.OpenAPI设计与安全实践Open API是什么? Open API即开放API,也称开放平台。 所谓的开放API(OpenAPI)是服务型网站常见的一种应用,网站的服务商将自己的网站服务封装成一系列API(Application Programming Interface,应用编程接口)开放出去,供第三方开发者使用,这种行为就叫做开放网站的API,所开放的API就被称作OpenAPI(开放API)。https://blog.csdn.net/sheep8521/article/details/88551542
3.OpenAPI它利用了craigslist和Google Maps的openAPI,把它们巧妙的组合起来,让租房的信息有机的组织和直观的显示在google maps提供的地图之上;twittervision是把twitter和google maps的openapi进行mashup而形成的一个非常有趣的应用。进入twittervision网站,你会看到一个世界地图,地图上会不断冒出一些消息气泡,气泡里的内容就是某https://baike.sogou.com/v466313.htm
4.open美[?o?p?n] 英[?p?n] v.打开;开放;开启;张开 adj.开放;营业;坦诚;开放的 n.公开;户外;野外;旷野 网络打开文件;开路;开着的 第三人称单数:opens现在分词:opening过去式:opened 搭配 同义词 反义词 adj.+n. open door,open mouth,open space,discussion open,open sea http://s1.cn.bing.net/dict/search?q=open&FORM=BDVSP6&cc=cn
5.支付宝支付宝,全球领先的独立第三方支付平台,致力于为广大用户提供安全快速的电子支付/网上支付/安全支付/手机支付体验,及转账收款/水电煤缴费/信用卡还款/AA收款等生活服务应用。https://www.alipay.com/
6.OpenAPI是什么意思OpenAPI的用法翻译读音海词词典,最权威的学习词典,专业出版OpenAPI是什么意思,OpenAPI的用法,OpenAPI翻译和读音等详细讲解。海词词典:学习变容易,记忆很深刻。http://m.dict.cn/msearch.php?q=OpenAPI
7.openapi是什么意思openapi的中文翻译音标读音用法例句openapi是什么意思、openapi怎么读 读音:美英 英汉翻译近义词典英英词典发音词典 openapi中文翻译 开放应用程序接口 openapi是什么意思 网络开放平台;开放接口;开放应用接口 词组短语 单词专题https://danci.gei6.com/Openapi.html
8.阿里云OpenAPI这个错误码是什么意思?问答这个错误码表示在Python脚本调用阿里云OpenAPI时,由于网络连接问题导致请求失败。具体来说,错误码10054表示https://developer.aliyun.com/ask/557334
9.什么是openAPI问答OpenAPI(开放应用程序接口)是一种允许不同软件应用之间进行交互的技术规范。它定义了软件应用之间如何通信、相互传递数据以及使用其他应用的功能。OpenAPI可以使开发者更容易地集成不同的应用、服务和功能,从而提高开发效率和灵活性。通过使用OpenAPI,开发者可以创建自己的应用程序,并与其他开放的应用程序进行交互,实现更多https://www.yisu.com/ask/76108187.html
10.openapi的翻译是:openapi中文翻译英文意思,翻译英语[translate] ashake music 震动音乐[translate] arecbiz recbiz[translate] aAware of what 明白什么[translate] aI hear that the prices and the services are very good 我听见价格和服务是非常好[translate] aopenapi openapi[translate]http://eyu.zaixian-fanyi.com/fan_yi_12955847
11.ChatGPT开发实战:专业领域问答系统构建指南小雪的技术博客Given 用户提问"不可抗力是什么意思" When 插件处理请求 Then 返回内容应包含术语解释 And 应提供相关法条引用 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 六、性能优化方案 1. 缓存策略实现 @lru_cache(maxsize=1000) def get_embedding(text): https://blog.51cto.com/u_17353607/13807411