13 API連携

お客様

私は自作のPCソフトを販売をしています。
今までダウンロード販売を行っていましたが、月額課金に対応したいと思っています。
どんめるではソフトウェアのライセンス管理と課金が連動ができると聞いたのですが可能ですか?

田中

はい、可能です。
APIを通じて外部システムからどんめるの顧客データを参照する事が出来ます。
参照したデータによってそのソフトが起動できるかどうかを判断する事が出来ます。

こちらをご覧ください。
この図は利用者がツール(自作のPCソフト)等を起動したときにどんめる内のデータを参照してしかるべきソフトが起動する事を表しています。

ツール認証

お客様

参照できるデータにはどんなものがありますか?

田中

ソフト起動に関するデータを参照します。
主に有効期限、ステータスIDになります。
ステータスIDは「無料版」「有料版」等の起動判断をすることができます。

お客様

なるほど、ツール認証はあくまで、ツールを起動する時の情報のみをやり取りするのですね。それではその他の個人情報、お支払い手続きはどうなりますか?

田中

どんめるの会員マイページ内で行います。
利用者は会員マイページにて、ソフトの有効期限の確認、利用者情報の変更や、追加のお支払い、ソフトの使い方をサポートするサポート等がご利用いただけます。
2017-01-30_15h19_17

お客様

なるほど。私は自社ソフトの開発に集中し、会員の対応はどんめるで全部対応できるのですね。これだと自社ソフトの開発に集中できますね!

田中

はい!
実は、当社でも自社ソフトを効率よく販売するために、ライセンス管理が必須だったんです。
法人様のように、1人のお客様に複数のライセンスを提供する場合や、種類の違ったソフトを販売したい場合に、ライセンス管理が複雑になってくるのですが、これをどうにか解決したかったんですね。

お客様

確かに、現在私もそのような状況で正確にライセンス管理ができていない所があります。

田中

そうなると機会損失になりますので、API通信で正確にライセンス管理をすれば、取りこぼしが防げますね。

お客様

いいですね。ぜひAPIを利用したいと思っていますが導入は簡単ですか?

田中

まずはどんめる無料版を導入してください。
無料版のままご試用いただき、テスト環境とすることができます。

その以下のAPI仕様書を参考にテスト開発いただくことができます。
また、無料版にご登録いただけれより詳細な仕様、フロー図等をお渡しできます。

利用シーン

業務量のPCソフトや自作のWEBサービス等の利用料の管理
連携可能な外部ツール PCソフト
WEBアプリ
課金タイプ 無料
1回決済
月額課金(月額課金のパターンはこちら

API仕様書

GETメソッドでエンドポイントにアクセスし、TXT形式、またはXML形式で認証結果を返します。

エンドポイント 詳しくは詳細仕様書に記載
HTTP Method(s) GET
送信パラメータ
ログインID 必須 どんめるのログインID
認証キー 認証キーは、初回起動時にツール側で作成し送信してください。
作成した認証キーは、何らかの方法で保存しておいてください。
初ログイン時にデータベースに記録し、2度目以降は、一致しない場合には、エラーを返します。
会員ページのライセンス情報画面にて、ユーザー自身で、認証キーのリセットが出来ます。
(これにより、PC買い替え、設置サーバー移転などが可能になります。)
設置URLなど 認証キーと同じく、初ログイン時にデータベースに記録し、2度目以降は、一致しない場合には、エラーを返します。
サーバー設置型の場合は、複数設置できないようにするのに役立ちます。
サーバー設置型以外は、第2認証キーとして利用することも出来ます。
その場合は、認証キーと同様にご使用ください。 こちらは空欄でもかまいません。
ライセンスコード ダウンロードセンターのライセンス詳細ページにて取得可能です。
出力形式 xml,txt
出力パラメータ(レスポンス)
エラーID 999 エラーなし(認証OK)
100 ログインIDが存在しない場合
101 認証キーが一致しない場合
102 設置URLが一致しない場合
103 ステータスが退会となっている場合
104 有効期限が切れている場合
ステータスID どんめるのステータスID
有効期限 yyyy-mm-dd 形式
備考 その他ユーザー個別に何らかの情報を受け渡したい場合は、備考をご利用ください。 備考は、管理ページの会員情報詳細ページにて入力可能です。
秘密のページID 該当ユーザーに開放されている秘密のページのページIDを「,」区切りで返します。

レスポンスサンプル

詳しくは詳細仕様書に記載

サンプルコード

詳しくは詳細仕様書に記載

利用開始方法

まずはどんめる無料版を導入してください。
無料版のままご試用いただき、テスト環境とすることができます。
ご登録いただき利用の旨をご連絡ください。
折り返しAPI仕様書・認証システムのフローを送付します。

■ご利用料金
アドバンス版サーバー&サポート(月9800円)ご契約の方
この機能はご利用可能になりますが、利用の開始には別途サポートからご連絡が必要です。

アドバンス版(月3240円)ご契約の方
ご提供はございませんので、サーバー&サポートにアップグレードする必要がございます。

お客様の声