OneSpan Sign Developer：RESTを使用して複数のドキュメントをアップロードする

RESTを使用してOneSpan Signでアプリケーションを開発している場合、Post / Putリクエストを送信するときにエラーメッセージが発生する可能性があります。トラブルシューティングの目的で、次のようなHTTP監視ツールを使用することをお勧めしますバイオリン弾きまたはチャールズ OneSpan Signへのネットワークトラフィックをキャプチャします。これにより、何が起こっているかをよりよく理解できます。

今週のブログでは、既存のトランザクションに複数のドキュメントを例としてアップロードして、HTTPリクエストがどのように見えるか、Fiddlerで何を探すか、C＃でRESTを使用してこの例を実現する方法について説明します。

始めましょう！

フィドラートレースの外観

これがFiddlerから取得したスナップショットです。

問題をより詳しく調査するために、次の4つのポイントを使用してこのリクエストを分析します。

ドキュメントのアップロードポイント1：

ドキュメントを既存のパッケージにアップロードする場合は、コードまたは郵便配達員のテストで以下のAPI URLおよびリクエストヘッダー設定を使用できます。

HTTPリクエスト

POST / api / packages / {packageId} / documents

HTTPヘッダー

受け入れる：text / html

Content-Type：multipart / form-data

承認：基本的なapi_key

「Accept」属性は「application / json」ではなく「text / html」に設定する必要があることに注意してください。

ドキュメントのアップロードポイント2：

スクリーンショットから、各Content-Dispositionが実際には「-」+境界で区切られていることがわかります。

PDFをバイトストリームに転送する場合、Content-typeを「application / pdf」に設定する必要があります。または、テスト目的でContent-typeを「text / plain」にプレーンテキストで設定できます。

ドキュメントの内容の前に改行があるはずです。

複数のドキュメントをアップロードする必要がある場合、Content-Dispositionの名前は「ファイル」と同じです。

ドキュメントのアップロードポイント3：

ドキュメントの最小ペイロードには、スクリーンショットに示すように、「name」属性を含める必要があります。ただし、アップロード後にドキュメントを更新するのではなく、1回の呼び出しでリクエストJSONにすべての承認と属性を追加することを常にお勧めします。

複数のドキュメントをアップロードするには、ペイロードを次のように編成する必要があります。

_{^{[
   {
    "名前"： "ドキュメント1"、
     ....
   }、
  {
     "名前"： "ドキュメント2"、
     ....
  }
]}}

ドキュメントのアップロードポイント4：

最後に、「-」+ boundary + "-"を使用してリクエストを完了する必要があります。特に、最後に2つの追加のベースがあります。

複数のドキュメントのアップロード

上記は、複数のドキュメントをアップロードするためのC＃サンプル関数です。コードを読み取ることで、Webリクエストがコードからどのように変換され、独自のビジネスロジックに応じて、開発プログラミング言語内に独自の関数を作成するかを確認できます。完全なコードについては、このスレッドを参照してください。このブログや、OneSpan Signをアプリケーションに統合することに関するその他の質問がある場合は、開発者コミュニティフォーラム 。