コンテンツにスキップ

Adder OpenAPI Goクライアント

AdderのOpenAPI GoクライアントをGoプロジェクトに追加するには、次のモジュールパスを使用します。

import openapi "github.com/blinklabs-io/adder/openapi"

以前のモジュールパス github.com/blinklabs-io/cardano-node-api/openapi を使用するプロジェクトは、github.com/blinklabs-io/adder/openapi へ移行します。openapi/go.mod では、モジュール名として github.com/blinklabs-io/adder/openapi を指定します。

Adder API は、次のルートを提供します。/ping と /healthcheck、および /v1 配下のルートは、末尾のスラッシュを付けた形式にも対応します。

区分メソッドとパス動作
ルートGET /pingサーバーが到達可能な場合に pong を返します。
ルートGET /healthcheckヘルスチェック結果を JSON で返します。すべてのチェックが成功すると 200、いずれかが失敗すると 503 を返します。
ルートGET /events(通常のSSE要求)SSEでイベント配信を開始します。
ルートGET /events(WebSocketへのアップグレード要求)WebSocketへアップグレードします。アップグレードできない場合はWebSocketエラーを返し、SSEへ暗黙にフォールバックしません。
/v1POST /v1/fcmJSON の fcmToken を保存します。fcmToken が空の場合、または JSON が不正な場合は JSON 形式の 400 エラーを返します。
/v1GET /v1/fcm/{token}指定した FCM トークンを返します。トークンが存在しない場合は 404 を返します。
/v1DELETE /v1/fcm/{token}指定した FCM トークンを削除します。削除できた場合は 204、トークンが存在しない場合は 404 を返します。
/v1GET /v1/qrcodeAdder Mobile の接続に使用する QR コードを含む HTML ページを返します。
SwaggerGET /swagger/Swagger UI を表示します。URL には末尾の / を付けます。

通常の要求では、サーバーはSSEストリームでイベントを配信します。WebSocketへのアップグレードを要求するヘッダーを含む要求を受けた場合、サーバーはアップグレードに失敗するとWebSocketエラーを返します。サーバーはその要求をSSEとして処理せず、暗黙にフォールバックしません。HTTP サーバーは書き込みタイムアウトを設定していないため、書き込みタイムアウトでストリームを終了しません。サーバーは構造化アクセスログを記録し、ハンドラーで panic が発生しても処理を回復して異常終了を防ぎます。


Doc Holiday logo

Docs authored by Doc Holiday