Q&A ｜立花証券ｅ支店

Q: APIの動作を大まかに教えてください。また、簡単に説明した資料はありませんか？

A: 大まかな動作は、クライアント側でテキストを作成し、httpでAPIサーバーに投げ（指定URLのこと）、返信の文字列を取得するです。
　　　　　　　　
プログラム開発前にとりあえずｅ支店・ＡＰＩをブラウザで試して見たい方のために以下の資料を用意しています。表計算の「基本」シートをご参照ください。
　　　　　　　　
立花証券・ｅ支店・ＡＰＩ専用ページ
５．マニュアル
１．共通説明
３）ブラウザからの利用方法
「ｅ支店・ＡＰＩ、ブラウザからの利用方法」
「基本」シート

Q: APIに設定する項目がわかりません

A: 以下の資料のp5以降に具体的なパラメータ例を記載させて頂いていますのでご参照ください。

立花証券・ｅ支店・ＡＰＩ専用ページ
５．マニュアル
※１．
「立花証券・ｅ支店・ＡＰＩ（ｖ４）、REQUEST I/F、注文入力機能引数項目仕様」

また、pythonのサンプルプログラム中にもコメントで、そのコマンドの資料の該当箇所を表記させていただいていますのでご参照ください。

Q: 仮想URLの有効期限はいつまでですか？

A: ログインで返される sUrlRequestとsUrlEventの有効期限は、通常時の場合
1）ログアウト
2）同じユーザーIDでのログイン
3）API用サーバーの閉局（03:30）
のいずれかが最初に行われた時までになります。

仮想URLにつきましては
立花証券・ｅ支店・ＡＰＩ専用ページ
３．ご利用方法
５．仮想ＵＲＬについて
をご参照ください。

またAPIの運用につきましては、
立花証券・ｅ支店・ＡＰＩ専用ページ
５．マニュアル
「立花証券・ｅ支店・ＡＰＩ、REQUEST I/F、マスタデータ利用方法」
p15/43 ２－４－１．資料_株式タイムテーブル
等をご参照ください。

Q: APIは時刻チェックをしていますか？

A: APIは、p_sd_dateでクライアントからの時刻チェックをしています。
クライアントのシステム時刻をNTP等で合わせて頂き、APIに電文を投げる直前の時刻を設定してください。

APIの時刻のチェックにつきましては、
立花証券・ｅ支店・ＡＰＩ専用ページ
５．マニュアル
「立花証券・ｅ支店・ＡＰＩ（ｖ４ｒ２）、REQUEST I/F、利用方法、データ仕様」
p1/6
2. 利用方法
「※本番バージョン(v4r1)よりクライアントからの要求.p_sd_dateによる遅延等チェック機能を追加。要求.p_sd_date < e支店・APIのサーバ時刻(ntp により同期)30秒(ネットワーク経路上での遅延検出)の場合はエラー応答(p_errno=8)を返す。上記機能追加により、本APIを利用する場合は該当機器の時刻を ntp などで正確に合わせる必要がある。」
の部分をご参照ください。

p_sd_dateの書式は上記資料p1/6にありますように、2022.02.28-11:04:41.997 のようなYYYY.MM.DD-HH:MM:SS.TTTの形式（秒の小数点以下は3桁）となります。

Q: sJsonOfmtによる動作の違いについて教えてください

A: クライアントからの送信は、引数項目番号、引数項目名共に可能です。APIからの返信は、sJsonOfmtで指定した形式になります。
”sJsonOfmt”:”0”の場合、APIからの返信は、引数項目番号で改行のない連続した文字列になります。
“sJsonOfmt”:“1”の場合APIからの返信は、引数項目番号で改行とインデントの入った文字列になります。
“sJsonOfmt”:“2”の場合APIからの返信は、引数項目番号で改行のない連続した文字列になります。
“sJsonOfmt”:“3”の場合APIからの返信は、引数項目番号で改行とインデントの入った文字列になります。
“sJsonOfmt”:“4”の場合APIからの返信は、引数項目名で改行のない連続した文字列になります。
“sJsonOfmt”:“5”の場合APIからの返信は、引数項目名で改行とインデントの入った文字列になります。

返信例

“sJsonOfmt”:“0”の場合の返信例
{"177":"2022.04.07-12:38:03.755","175":"11","176":"2022.04.07-12:38:03.718","174":"0","173":"","192":"CLMZanKaiKanougaku","328":"","576":"","534":"0","535":"","692":"0","693":"","591":"202204071238","588":"1904527","589":"0","306":"0"}

“sJsonOfmt”:“5”の場合の返信例
{
"p_sd_date":"2022.04.07-12:48:16.751",
"p_no":"11",
"p_rv_date":"2022.04.07-12:48:16.712",
"p_errno":"0",
"p_err":"",
"sCLMID":"CLMZanKaiKanougaku",
"sIssueCode":"",
"sSizyouC":"",
"sResultCode":"0",
"sResultText":"",
"sWarningCode":"0",
"sWarningText":"",
"sSummaryUpdate":"202204071248",
"sSummaryGenkabuKaituke":"1904527",
"sSummaryNisaKaitukeKanougaku":"0",
"sHusokukinHasseiFlg":"0"
}

Q: p_no はどのように設定しますか

A: p_noは、ログイン時の指定値で初期化します。ログイン後は、p_no > p_no（前回）となるようにインクリメントする必要が有ります。

立花証券・ｅ支店・ＡＰＩ専用ページ
５．マニュアル
２．各機能Ｉ／Ｆ説明
「立花証券・ｅ支店・ＡＰＩ（ｖ４ｒ２）、REQUEST I/F、利用方法、データ仕様」
p1/6に「※要求．p_no は認証要求の該当値を初期値とし、それ以降クライアントは要求送信時に＋１（以上）し送信する。」と記載させていただいておりますのでご参照ください。

Q: パスワードを変更したら、APIでログインできなくなりました。他の標準Web等ではログインできます。

A: 第一暗証番号、第二暗証番号で記号を使った場合、APIでは記号をURLエンコーディングを行って使う必要が有ります。
「APIへ入力したい記号」→「APIへの実際の入力」
「#」→「%23」
「+」→「%2B」
「/」→「%2F」
「:」→「%3A」
「=」→「%3D」

APIのお知らせ「サンプルプログラムでのurlエンコードについて」をご参照ください。

記号を使っていない場合は、APIでのパスワードの入力内容を再度ご確認ください。

Q: プロバイダを変更したのですが、APIで株価の取得（CLMMfdsGetMarketPrice）を240回行うとAPIが反応しなくなります。バグですか。

A: お客様がご利用されているプロバイダーの技術的仕様による制約だと考えられます。

対策としては、制約のないプロバイダーに変更頂くか、APIのアクセス頻度を下げてお使い頂くかになります。
なお制約のあるプロバイダーをご利用の場合、プロバイダーにより反応しなくなるまでの回数は異なります。
「大規模NAT web 見られない」等で検索いただくと、この症状の解説が見つけられます。

弊社ｅ支店のホームページに記載の商品等にご投資いただく際には、各商品等に所定の手数料や諸経費等をご負担いただく場合があります。また、各商品等には価格の変動等による損失を生じるおそれがあります。商品によっては、投資元本を超える損失が発生することがあります。各ページに掲載された各商品等へのご投資にかかる手数料等およびリスクについては、弊社ｅ支店のホームページの当該商品等の取引ルール、契約締結前交付書面またはお客様向け資料などが掲載されたページに記載されておりますので、当該ページより内容をご確認ください。

ＡＰＩ