股票场内基金交易,没时间盯盘?
使用优财助手电脑客户端记录下您的股票买入卖出数据,能帮您时刻盯盘,会根据您记录的未售出买入价计算上涨或下跌幅度,及时弹框通知您。想知道如何使用?快点击左方视频观看了解吧~~下载地址:http://youcaizhushou.com
apiDoc指南系列(二)
在上一篇文章中我们介绍了apiDoc的安装与简单使用,这篇文章我们继续讲解apiDoc的其他用法
Header
在使用API的过程中,我们不可避免的要用到Header,下面的示例代码展示了如何在apiDoc中描述Header。为了方便,我使用了python来进行编写,以及只展现了主要的代码部分,完整的代码请到gitlab上进行查看。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
""" @api {get} /user/articles 个人文章列表 @apiName GetUserOwnArticle @apiVersion 0.1.0 @apiGroup Article @apiHeader {String} Authorization JWT登录认证 @apiHeaderExample {json} Header-Example: { "Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vY29vbGNvZGUuZGV2L2FwaS9sb2dpbi93ZWNoYXQiLCJpYXQiOjE0ODAyNDk0MzIsImV4cCI6MTQ4MzY1NzQzMiwibmJmIjoxNDgwMjQ5NDMyLCJqdGkiOiJLN3VDV05IeThmRFRBcVFXIiwic3ViIjo0fQ.W0ejklbilFdn--e4rZD5vlVczoryHLX1oNHYFKl07Ss" } @apiSuccess {Number} id 文章ID ...... @apiSuccess {Json} comments 评论 @apiSuccessExample Success-Response: ...... @apiUse TokenError """ |
在上面的代码中我们使用@apiHeader
来描述Header信息,通过@apiHeaderExample
来提供Header示例。这样我们就成功的把Header展示到apiDoc中了。
在apiDoc页面进行测试
一般我们在进行API调试的时候都是在postman插件中进行调试,但是apiDoc提供了一个能够直接在文档页面进行测试数据的方法。接下来我教给大家如何进行展示。
还记得项目根目录下的apidoc.json
文件么,打开它,将下面的信息添加进去。
1 2 |
"sampleUrl": "http://coolcodeapi.wodetiku.com" |
这行文字的作用是apiDoc将会通过这个url来进行API测试,这样所有的API都会以这个url为前缀创建测试链接,并且还包含我们上面所说的Header,如果API文档设置有参数的话,参数也会一并显示出来。
但是如果某些路由不想进行在线测试的话也很简单,只需在相应的文档文件中加入下面的代码就可以了。
1 2 |
@apiSampleRequest off |
这样我们可以直接在API文档页面进行测试,而不用使用postman了。当然postman是一个十分强大的插件,而apiDoc只提供了最基础的内容,如果满足不了需求的话可以打开postman继续进行调试。
想获得去掉 5 元限制的证券账户吗?

证券交易股票基金的佣金,不足 5 元会按照 5 元收取。比如交易 1000 元的股票,按照普遍的证券佣金手续费率万 2.5,其交易佣金为 0.25 元,小于 5 元,实际会收取佣金 5 元,买卖两次需要支付 10 元佣金成本,1% 的利润就这样没了。
如果您想去掉最低交易佣金 5 元限制,使用微信扫描左边小程序二维码,访问微信小程序「优财助手」,点击底部菜单「福利」,阅读文章「通过优财开证券账户无最低交易佣金 5 元限制」,按照文章步骤操作即可获得免 5 元证券账户,股票基金交易手续费率万 2.5。
请注意,一定要按照文章描述严格操作,如错误开户是无法获得免 5 元证券账户的。
如果您想去掉最低交易佣金 5 元限制,使用微信扫描左边小程序二维码,访问微信小程序「优财助手」,点击底部菜单「福利」,阅读文章「通过优财开证券账户无最低交易佣金 5 元限制」,按照文章步骤操作即可获得免 5 元证券账户,股票基金交易手续费率万 2.5。
请注意,一定要按照文章描述严格操作,如错误开户是无法获得免 5 元证券账户的。