Day01 - 一切从试着了解开始

前言

话说，看了历年这麽多iThome铁人赛的文章，觉得这是一个相当好的活动，曾经从历年铁人大大们的文章中受惠，在昨天收到iThome的电子报看到最後一天报名，想说要不要也参加一下精实自己的生活，也说不定有机会可以留下一些技术资源文件，希望总会有一天也能够帮到有需要的人。

这是我第一次参加iThome铁人赛，主题挑选了永丰金融APIs串接，聊一下原因。目前在职场工作和智慧零售领域有些相关，在公司内部单位转换了跑道，过去十多年的资讯系统开发背景，所以一阵子没有机会可以好好写程序有些怀念，想藉此可以重温一下曾经码农的手感外，那麽巧的自己本身就是永丰银行与永丰证券的用户，选择这个永丰金APIs主题完全就是一拍即合。

谈谈主题

由於前面说的，其实是很仓促的情况下才突然在最後一天报名截止前选择主题与按下报名键，对於到底这30天的马拉松要做些什麽还不算很了解。

先从永丰金APIs的两个子主题来谈起。

永丰银行消费支付API

永丰金控期下当然有相当多的子公司，这次列在里面的一个是永丰银行，一个是永丰证券。永丰银行的APIs里面完整看来应该是涵盖四个主题，分别是：消费支付、生活缴费、身分认证与开放银行。

在永丰银的Developer网站上其实没有太多公开的API资讯，多人需要再与专人联系取得进一步的手册或sample code，其中有一个「API试验」的页面只有提供片段的沙盒测试data，登入後点选右上角的「API目录」会看到一个MockService的API，提供了四个功能是和银行外币、分行资讯、汇率、ATM资讯相关，看起来范围也不是完整的四大主题的内容。

因此看起来相要一探究竟，是需要和专人联系或像这次与iThome铁人赛合作，所以填写相关资讯才能取得这次设定的消费支付主题服务完整的API文件，在平台即使注册成为永丰Developer是无法直接在网站看到完整讯息。

在和永丰申请了铁人赛参赛的资讯後，会在email收到开发新手村大礼包，里面会给参赛者相关的开发用资讯以及使用手册和Sample Code (有附上C#和PHP)。

目前看一下手册的理解，这个永丰银行金流的API的行销名称叫丰收款，主要是提供店家可作线上收款的服务给客户。其中包含可建立订单以及後续的信用卡交易服务。

银行的金流服务中不可避免的，应该会有较多的安全流程需要逐一设定与交握，因此看了一下API文件的大纲，有一大部份是会需要先搞定一些进行消费支费的前置作业。

目前对这一块理解是这样，至於需要用什麽语言来串接与撰写，倒是不需要受限语言方式，虽然官方给了C#以及PHP Sample。

永丰证券 Shioaji API

另一个主题则是和股票期货交易有关的证券API - Shioaji，他有一个特殊的名称与很有设计感的Logo，让我感觉到蛮新鲜的。这是一个日语，塩味(しおあじ / Shioaji)，至於名称的由来是什麽我倒是没在官网上看到解释，而是在丰云学堂的一位钟荣达讲师那看到的解释是「结晶」的意思。

3. 何谓 Shioaji
   Shioaji 是永丰金证券开发的 API 介面，提供了报价、下单和帐户查询等功能，官方也有详细的技术文件，而 Shioaji 本身是日文代表结晶的意思，主要是期待使用此套件的开发者能在股市中收获珍贵的成果结晶
   https://www.sinotrade.com.tw/richclub/PythonAPI/video/01-%E7%94%A8-Python-%E4%B8%B2%E6%8E%A5%E5%88%B8%E5%95%86-API---%E5%8F%96%E5%BE%97%E6%AD%B7%E5%8F%B2-Tick-%E8%B3%87%E6%96%99%E8%88%87-K-%E6%A3%92-5fe06055f8acb91ca4fc04f3

Shioaji主要可让经申请授权的客户，可自由撰写程序针对其自身的证券帐户，依据所取得之公开资讯进行分析，加上自由弹性的个人投资策略，进行自动化的交易，更进一步是可透过这样的方式分析过去资料，在数据资料的支持下去达成有纪律的投资，称之为量化交易。

主题确认後

在主题大约确认後，就是要看接下来30天要写些什麽了。在我看来铁人赛是一个自由奔放的技术经验分享方式，因此确立主题与范围後，倒也不想设限应该怎麽样的进行方式。但可以知道的是，Shioaji的主题，股市开盘时间等於上班时间，这一点是有一点困难执行一些API的即时验证或测试工作。所以目前决定先放飞自我，两边主题都先浅尝看看，然後随时调整。

在工作忙碌之余还没事逼自己参加铁人赛，我想这件事本身就已经足够有趣了，接下来每一篇写的多还是少，整体的撰文配速需要依工作与休假日随机而定罗。

期待能从这个过程中学到一些东西。