NK-RELAY / TECHNICAL PROTOTYPE
APIをつなぐ。
失敗した後まで、
設計する。
二重登録、取りこぼし、原因の分からない再送。連携処理の「正常時」だけでなく、「壊れたとき」をコードと自動テストで検証します。
事業者向け／技術検証の相談受付中。
本番稼働済みのSaaSや、即接続できる汎用コネクターではありません。
IMPLEMENTED CORE
- AUTH + DEDUP
- HMAC-SHA256 / 本文検証 / 一意制約
- DURABLE QUEUE
- SQLite / 原子的claim / 処理リース
- RECOVERY
- 指数バックオフ / DLQ / 監査履歴
55 / 55
コア29件＋ローカルHTTP26件・全件合格
合成データ・v0.2／2026.09.05
Failure Injection
わざと失敗させて、確かめたこと。
Pythonの信頼性コアに加え、同一コンピューター内で実際にHTTP通信する受信口と模擬下流を検証しました。合成イベント4件は成功3件・DLQ1件となり、下流DBを開き直しても保存結果3件を確認。保存後に応答が失われたイベントは2回送信され、保存は1件でした。実顧客データ・外部API・公開HTTPサーバーを使った試験ではありません。下表はコア試験とローカルHTTP試験の実測結果をまとめたものです。
| 起こしたこと | 確認結果 | 処理の意味 |
|---|---|---|
| 同じイベントを再送 | 初回202・再送200 | 新しいジョブを増やさず、再送履歴を記録 |
| 同じIDで本文を変更 | 409 / conflict | 別内容へのすり替えを検出して拒否 |
| 署名の偽造 | 401 / rejected | イベントを保存せず拒否 |
| 下流が1回だけ失敗 | 2回目で成功 | 待機時刻を進め、同じ冪等キーで再試行 |
| 下流保存後に応答だけ喪失 | 送信2回・保存1件 | ローカル下流DBの原子的な冪等処理で重複を防止 |
| 下流が失敗し続ける | 3回でDLQへ | 無限に再送せず、要確認の状態で保持 |
| ワーカーが停止 | リース回収 | 期限切れ処理を回収し、旧所有者の完了記録を拒否 |
並行処理と再起動も検証
16件の同時受信で初回登録は1件。20回の同時claimで8ジョブの所有重複なし。DB再オープン、保存途中のロールバック、下流成功直後の停止もテストしています。
保証の境界を明確に
再試行は at-least-once 型です。任意の外部APIへの exactly-once は保証しません。下流の副作用を重複させないためには、下流側の永続的な冪等処理または照合設計が必要です。
HTTP試験は127.0.0.1だけに限定。DNS・プロキシ・リダイレクトを使用せず、本文サイズ、通信期限、応答のイベントID・冪等キーを検査します。検証記録には実行日時とソースのハッシュを保存し、実行前後のソース一致も確認しています。
合格数はこの試作の自動テスト件数です。第三者認証、顧客導入実績、本番での性能・可用性を示すものではありません。署名形式は独自仕様で、GitHubやStripe等への互換性を意味しません。
Technical Validation
まず、1つの経路を
検証可能な仕様に。
EC、CRM、社内ツール間の連携を想定。対象APIの仕様と権限を確認してから、実装可能な範囲を見積ります。
料金・納期は個別見積り
対象が未確認の段階で、固定価格の本番実装を約束しません。初回の対応可否確認は無料です。
- 対象の絞り込み
- 入力1種類・出力1種類・イベント仕様1種類を基本に、重複・タイムアウト・再試行・復旧の受入条件を定めます。
- 検証成果物
- 合意範囲のソースコード、自動テスト、実行手順、障害再現結果、制約・本番化の残課題。模擬連携と実API連携を区別して記録します。
- 別途設計が必要
- 公開HTTP層、実サービス用アダプター、認証・権限分離、暗号化、監視、負荷試験、バックアップ、継続保守。試作に完成済みの機能としては含まれません。
- 扱わない操作
- 実決済・送金、顧客の本番データ変更、権限外のアクセス、無断のデータ取得。初期検証は合成データまたは明示的に利用許可された検証データに限ります。
- 受注前の合意
- 対象環境、業務範囲、税込総額、納期、検収条件、修正範囲、取消・返金、ソースコードの利用権、情報の扱いをメールまたは書面で確定します。相談だけで契約・課金は発生しません。
Contact Engineering
「どこから、どこへ」。
そこから相談できます。
仕様書がまだなくても、システム名・困っている現象・件数の目安から対応可否を確認します。APIキー、パスワード、個人情報入りのログは送らないでください。
AIを用いて実装・検証を行います。AI処理や外部ツールへの共有が許可されていないデータは受け付けません。第三者の本番運用実績や専任エンジニアの常駐を約束するサービスではありません。