OneSpan Signハウツー：PythonでのOneSpan SignのAPIへのREST呼び出し

Pythonは、利用可能な最も一般的な汎用プログラミング言語の1つです。Webアプリケーション、ソフトウェア開発、デスクトップGUIなど、多くのアプリケーションドメインで使用されています。開発者の間で人気があるのは、3つの理由があります。

• 読みやすさ
• 図書館
• コミュニティ

Pythonは、ユーザーがコードを簡単に理解して記述できることを強調しています。その結果、その構文により、開発者はJavaまたはC ++よりも少ないコード行で同等の概念を記述できます。さらに、Pythonは20年以上前から存在しています。したがって、多くのアプリケーションに適したツールを証明する大規模な標準ライブラリがあります。最後に重要なことですが、Pythonには広大なコミュニティもあり、サポートを簡単に見つけることができます。このブログでは、PythonでOneSpan SignのAPIへのREST呼び出しを行う方法を紹介します。

コード

このブログでは、Python 2.7を使用します。まだインストールしていない場合は、公式Webサイトからダウンロードできます。ここに 。開発者コミュニティから完全なサンプルコードを入手することもできますコードシェア 。最初にしたいことは、「リクエスト」モジュールをインストールすることです。これにより、OneSpan SignのAPIにHTTPリクエストを行うことができます。コマンドプロンプトを開き、次の行を入力します。

$ pipインストールリクエスト

次に、お気に入りのテキストエディターで、「createAndSendPackage.py」という名前の新しいファイルを作成し、任意の場所に保存します。次のコードをコピーしてください。さらに詳しく説明します。

インポート要求
jsonをインポートする

url = "https://sandbox.esignlive.com/api/packages"

payload = json.dumps（{"documents"：[{"id"： "sample-contract"、"name"： "テストドキュメント"}]、"status"： "SENT"、"type"： "PACKAGE"、"ロール"：[{"タイプ"： "SIGNER"、"id"： "Signer1"、"signers"：[{"email"： "signer @example .com "、" firstName "：" John "、" lastName "：" Smith "、" id "：" Signer1 "}]、" name "：" Signer1 "}]、" name "："サンプルパッケージ "}）

ファイル= open（ 'doc1.pdf'、'rb'）

ファイル= {
     「ペイロード」：ペイロード、
     'ファイル'：ファイル
}

ヘッダー= {
    '承認'： "基本的なyour_api_key"、
    '受け入れる'： "application / json"
    }

response = requests.post（url、files = files、headers = headers）
print（response.text）

それでは、コードをさらに詳しく見ていきましょう。最初の数行は、REST呼び出しを行うために必要なモジュールをインポートします。

インポート要求
jsonをインポートする

次の行は、POSTリクエストを送信するエンドポイントのURLです。

url = https://sandbox.esignlive.com/api/packages

次に、パッケージを定義するJSON文字列が作成されます。通常は、JSON文字列を動的に作成するのに対し、以下のような大きな文字列を作成します。私は簡単にするためにそうすることにしました。

payload = json.dumps（{"documents"：[{"id"： "sample-contract"、"name"： "テストドキュメント"}]、"status"： "DRAFT"、"type"： "PACKAGE"、"ロール"：[{"タイプ"： "SIGNER"、"id"： "Signer1"、"signers"：[{"email"： "signer @example .com "、" firstName "：" John "、" lastName "：" Smith "、" id "：" Signer1 "}]、" name "：" Signer1 "}]、" name "："サンプルパッケージ "}）

次に、ドキュメントバイナリが読み取られ、適切なリクエストペイロードが構築されます。

ファイル= open（ 'doc1.pdf'、'rb'）

ファイル= {
     「ペイロード」：ペイロード、
     'ファイル'：ファイル
}

最後に、ヘッダーが定義され、パッケージを作成して送信するためにPOSTリクエストが行われます。必ず、apiキーのプレースホルダーを独自の値に置き換えてください。

ヘッダー= {
    '承認'： "基本的なyour_api_key"、
    '受け入れる'： "application / json"
    }

response = requests.post（url、files = files、headers = headers）
print（response.text）

コードを実行する

コマンドプロンプトを開き、現在のディレクトリを「createAndSendPackage.py」ファイルを保存した場所に変更します。次に、次の行を入力します。

python createAndSendPackage.py

OneSpan Signは、コマンドプロンプトウィンドウに出力される応答としてパッケージIDを返します。

このブログや、OneSpan Signをアプリケーションに統合することに関するその他の質問がある場合は、開発者コミュニティフォーラムにアクセスしてください。 https://community.onespan.com 。それは私からです。読んでくれてありがとう！この投稿が役に立った場合は、Facebook、Twitter、またはLinkedInで共有してください。

ハリスハイダリー
ジュニアテクニカルエバンジェリスト
LinkedIn | ツイッター