【要約】GMOコインFX APIのERR-5010でハマった話 — 署名対象パスとAcceptヘッダの2つの罠 [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
PythonでGMOコインFXの自動売買システムを開発するエンジニアが、API疎通時にERR-5010に直面した。署名が正しいにもかかわらずエラーが解消されない、デバッグ困難な状況が発生している。この問題は、APIの仕様と実装の乖離に起因する。
- ・署名対象パスの不一致：リクエストURLのパスと、署名に使用すべきパスが異なる。
- ・Acceptヘッダの依存：署名が正しくても、特定のヘッダがないと署名エラーとして扱われる。
- ・エラー検知の遅れ：認証エラー時もHTTP 200 OKが返るため、レスポンスボディのstatusを確認する必要がある。
// Approach
開発者は、エラーの原因をヘッダの有無とパスの構成から切り分け、解決策を導き出した。標準ライブラリを使用する場合でも、エラーを回避できる堅牢な構成を検討した。
- ・パスの分離管理：リクエストURL用と署名用でパスを別々に扱い、署名側から /private を除去する。
- ・必須ヘッダの明示：Accept: */* を含め、標準ライブラリ利用時でもエラーを防ぐ。
- ・バリデーションの強化：署名生成時にパスの形式をチェックする関数を導入し、早期にエラーを検知する。
- ・レスポンス検証の徹底：HTTPステータスだけでなく、ボディ内の status フィールドを必ず検査する。
// Result
正しい署名生成ロジックとヘッダ構成を実装し、ERR-5010を完全に回避した。これにより、開発者は認証周りの不確実性を排除できた。
- ・デバッグ時間の削減：エラーの真因を特定し、迷宮入りを防いだ。
- ・堅牢なクライアント実装：ユニットテストで検知可能な、型安全に近いパス処理を実現した。
- ・エラー検知精度の向上：HTTP 200 OKに隠れたエラーを確実に捕捉する実装フローを確立した。
Senior Engineer Insight
> API設計における「非対称性」と「暗黙の依存」は、運用フェーズでの致命的なバグを招く。本件のように、リクエストパスと署名パスが異なる仕様は、開発者の直感に反し、実装ミスを誘発しやすい。また、ドキュメントに未記載のAcceptヘッダ依存は、標準ライブラリ利用時にのみ顕在化するエッジケースであり、極めて危険である。金融系システムを構築する際は、公式サンプルを鵜呑みにせず、低レイヤの挙動まで徹底的に検証する姿勢が求められる。