ワイヤー・メッセージの取得
get
/ic/api/b2b/v1/monitoring/wiremessages
メッセージ・タイプ、状態、方向、プロトコル、取引先などの情報を含むワイヤー・メッセージのリストを取得します。 ワイヤー・メッセージは、ホスト会社と取引先間のメッセージの技術交換を表します。 これらのメッセージは、暗号化してAS2に署名できます。
ノート:
トラッキング情報は非同期に保持され、システム・スループットが向上するため、B2BモニタリングAPIは一貫性のない結果を断続的に返す可能性があります。 ビジネス・ユース・ケースで一貫したモニタリング結果が必要な場合は、APIが一貫した結果を返すまで、再試行メカニズムを使用するソフトウェア設計を実装できます。
リクエスト
問合せパラメータ
- limit: integer(int32)
返される結果をページングするには、limitパラメータを使用します。 オフセットは、レコードを返す開始ポイントです。 たとえば、offset=3&limit=16は、4番目のアイテムから始まるワイヤー・メッセージを一覧表示し、リストには16個のアイテムが含まれます。
- offset: integer(int32)
返される結果のページ区切りには、オフセット・パラメータを使用します。 デフォルト値は0です。 この制限は、一度に返品するアイテムの最大数です。 たとえば、offset=3&limit=16は、4番目のアイテムから始まるワイヤー・メッセージを一覧表示し、リストには16個のアイテムが含まれます。
- q: string
フィルタ・パラメータ
- timewindow: 1h, 6h, 1d, 2d, 3d, RETENTIONPERIOD. デフォルト値は1hです。
- direction: メッセージの方向。 有効な値はINBOUNDおよびOUTBOUNDです。
- id: ワイヤー・メッセージ識別子。
- startdate: メッセージのフィルタリング用のUTC形式のカスタム時間範囲開始日時。
- enddate: メッセージのフィルタリング用のUTC形式のカスタム時間範囲終了日時。
- status: メッセージ・ステータス。
- transportprotocol: メッセージ・トランスポート・プロトコル。 有効な値は、AS2およびFTPです。
- instanceId: 統合インスタンス識別子。
- errorcode: b2bエラー・コードの値。
- 取引区分: 取引先識別子。
- messagetype: メッセージ・タイプ。 有効な値はWIREおよびMDNです。
- userdefinedid: トランスポート・タイプにメッセージ識別子が定義されている場合、ワイヤー・プロトコル・レベルのメッセージ識別子。 AS2トランスポートの場合、これはAS2メッセージ識別子に設定されます。 FTPトランスポートの場合、このフィールドは使用できません。
- parentmessageid: ワイヤー・メッセージ識別子の値。 これは、特定のワイヤー・メッセージ識別子に関連するすべての確認をフェッチするのに役立ちます。
例:
{startdate:'2020-07-09 07:00:00', enddate:'2020-07-09 21:25:00', id:'0AC415941776251CB5E0000026D27C45', direction:'INBOUND', messagetype:'WIRE'}
この操作のリクエスト本文がありません。
トップに戻るレスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
操作の成功
ネストされたスキーマ : WireMessageBasicRs-allOf[2]
型:
ソースを表示
object-
ackState: string
-
comments: string
-
createdBy: string
-
creationDate: string
-
direction: string
-
errorCode: string
-
errorDetail: string
-
errorSummary: string
-
instanceId: string
-
messageType: string
-
packedPayloadId: string
-
packedPayloadSize: string
-
payloadName: string
-
projectCode: string
-
protocolMessageId: string
-
referenceToId: string
-
resubmitCount: integer (int32)
-
resubmitErrorCode: string
-
resubmitParentId: string
-
resubmitStatus: string
-
resubmitSystemNotation: string
-
resubmittable: boolean
-
resubmitType: string
-
source: string
-
state: string
-
tradingPartner: string
-
transportName: string
-
transportProtocol: string
-
unpackedPayloadId: string
-
unpackedPayloadSize: string
-
updatedBy: string
-
updatedDate: string
-
url: string
-
userDefinedId: string
400レスポンス
パラメータの形式が正しくありません
412レスポンス
前提条件が失敗しました
500レスポンス
サーバー・エラー