<h2 id="h2acb1d3686">APIの利用方法</h2> 前回では特許庁APIの概要について紹介しました。今回は具体的にpythonでの利用方法を紹介します。 また利用方法を説明しながらAPIの詳細についても紹介します。 利用方法については説明の便宜のため、エラーやイレギュラーケース、汎用性は考えていません。 第三者にサービスとして提供する場合は考慮する必要はありますが、今回の趣旨とはことなるので割愛します。 <h3 id="h87d91bc5a4">まずは利用申請</h3>以下のページに記載の方法で申し込みます。ワードファイルでの利用申込書を作成し、 メールにて送って１週間程度で利用登録の通知が来ました。 <a href="https://www.jpo.go.jp/system/laws/sesaku/data/api-provision.html" target="_blank" rel="noopener noreferrer">https://www.jpo.go.jp/system/laws/sesaku/data/api-provision.html</a> <ul><li>登録通知ではアクセスするURLとユーザ名、パスワードを知らせてもらえます。</li><li>実際のアクセス方法、API仕様については以下を参照して実装することになります。</li></ul> <a href="https://ip-data.jpo.go.jp/pages/top.html" target="_blank" rel="noopener noreferrer">https://ip-data.jpo.go.jp/pages/top.html</a> <h3 id="h4310ef7bce">まずはアクセス用トークンを取得</h3><ul><li>HTTPのPOSTメソッドによりアクセス</li><li>以下のパラメータにより指定のトークン取得用URLにアクセス。※印の情報は前述の登録申し込み完了時に通知されます。</li></ul><pre><code>Host：指定されたURL　※
Content-Type：application/x-www-form-urlencoded
grant_type：password　（注：passwordという文字列です）
username：　特許庁から発行を受けた ID　※
password：特許庁から発行を受けたパスワード</code></pre> pythonの場合はrequestで取得できます。ライブラリがpython内にない場合はpipにてインストールしましょう。 <pre><code>&gt;pip install requests</code></pre> requestsについての説明は以下の公式サイトがわかりやすいと思います https://requests-docs-ja.readthedocs.io/en/latest/ トークン取得部分(python)<pre><code>import requests
import json

url = "https://ip-data.jpo.go.jp/(取得パス)"　#特許庁より通知あり
HOST = "ip-data.jpo.go.jp"

headers = {"Content-Type": "application/x-www-form-urlencoded", "Host": HOST}
payload = {'grant_type': 'password', 'username': '(ユーザー名)', 'password': '(パスワード)'}

r = requests.post(url, headers=headers, data=payload)

tokens&nbsp;= {"access_token": "", "refresh_token": ""}
if (r.status_code == 200):
&nbsp;&nbsp;tokens["access_token"] = r.json()['access_token']
&nbsp;&nbsp;tokens["refresh_token"] = r.json()['refresh_token']
else
		sys.exit()
end</code></pre> この処理後は１時間以内であればアクセストークンを使ってAPIからデータを取得可能となります。 また、それ以後８時間まではリフレッシュトークンを使えばユーザ認証なしで新たにトークン取得可能となります。 これについては「特許情報取得APIの利用の手引きv1.2.pdf」を参照すると良いでしょう。 <a href="https://ip-data.jpo.go.jp/pages/top.html" target="_blank" rel="noopener noreferrer">https://ip-data.jpo.go.jp/pages/top.html</a> <h3 id="hb98a25a44b">アクセストークンを使ったデータの取得</h3>実際にアクセストークンを使ってデータ取得をやってみましょう。 ここでは特許経過情報についてアクセスします。先ほどのコードの続きで実行してください。 この結果変数rに経過情報のjsonが返されます。 <pre><code># 特許経過情報取得
app_num = "2020008423". # 出願番号
url_app_progress = "https://ip-data.jpo.go.jp/api/patent/v1/app_progress/2020008423"
headers = {"Authorization": "Bearer " + tokens["access_token"], "Host": "ip-data.jpo.go.jp"}

r = requests.get(url_app_progress, headers=headers)</code></pre> <h2 id="h56a579c444">特許庁APIで取得できる情報</h2>先ほどは特許経過情報について取得している例を挙げましたが、特許庁APIでは以下の情報を取得することができます。 <img src="https://images.microcms-assets.io/assets/3e1420fe5ad546b488659d1241d9ff3d/41ce20aff7f7463cb36827dbb56d7e7c/apiinfo.png" alt=""> このうちほとんどはjplatpatや他の商用データベースでも知ることができる情報です。 APIの１回のアクセスで知ることができるのは１回の問合せで１つの出願番号についての以下のいずれかの情報です。<ul><li>審査経過情報</li><li>分割出願情報</li><li>優先権基礎出願情報</li><li>申請人氏名</li><li>特許番号</li><li>引用文献情報</li><li>登録情報</li></ul> jplatpatで検索するよりAPI経由で便利な情報としては以下があります<ul><li>特許申請書類取得（意見書、手続き補正書のダウンロード）</li><li>特許発送書類取得（拒絶理由通知書、特許査定、拒絶査定、補正の却下の決定のダウンロード）</li><li>拒絶理由通知書取得（拒絶理由通知書ダウンロード）</li></ul>ではこのうち拒絶理由通知書ダウンロードAPIを使ってみましょう <h3 id="h4d5cadc076">拒絶理由通知書ダウンロード</h3>先ほどのトークン取得した後の処理です<pre><code># 拒絶理由ダウンロード
app_num = "2007035937"
url = "https://ip-data.jpo.go.jp/api/patent/v1/app_doc_cont_refusal_reason/" + app_num
headers = {"Authorization": "Bearer " + tokens["access_token"], "Host": "ip-data.jpo.go.jp"}


r = requests.get(url, headers=headers)</code></pre> レスポンスで処理が正しく行ったときはzipファイルが返されるので保存する処理が必要となります。 <pre><code>filename = "refusal_reason_" + app_num + ".zip"
save_file_path = os.path.join("./", filename)
with open(save_file_path, 'wb') as f:
&nbsp; &nbsp; &nbsp; &nbsp; f.write(r.content)</code></pre> 上記では保存ディレクトリを現在(pythonを実行しているディレクトリ)にしていますが、環境に合わせて変えてください。 これでzipファイルが作成され、その中に拒絶理由通知書のxmlが含まれています。xmlの一部（ファイルの途中）を以下に示します。 <pre><code>&lt;jp:article-group&gt;
&lt;jp:article&gt;第２９条柱書&lt;/jp:article&gt;
&lt;jp:article&gt;第２９条第２項&lt;/jp:article&gt;
&lt;/jp:article-group&gt;
&lt;/jp:bibliog-in-ntc-pat-exam&gt;
&lt;jp:reconsideration-before-appeal jp:true-or-false="false"/&gt;
&lt;jp:conclusion-part-article&gt;
&lt;p num=""&gt;　この出願は、次の理由によって拒絶をすべきものです。これについて意見が&lt;br/&gt;
ありましたら、この通知書の発送の日から６０日以内に意見書を提出してくだ&lt;br/&gt;
さい。&lt;br/&gt;
&lt;br/&gt;
　　　　　　　　　　　　　　　　理　由&lt;br/&gt;
&lt;/p&gt;
&lt;/jp:conclusion-part-article&gt;
&lt;jp:drafting-body&gt;
&lt;p num=""&gt;
１．この出願の下記の請求項に記載されたものは、下記の点で特許法第２９条第１項柱書に規定する要件を満たしていないから、特許を受けることができない。&lt;br/&gt;
&lt;br/&gt;
　　　　　　　　　　　　　　　　　記&lt;br/&gt;
&lt;br/&gt;</code></pre> ダウンロード自体は便利ですが、xmlでの形式なのでその後の表示や処理のためのプログラムは別途必要になります。 利用の手引きによるとアクセス制限は１００なので自動で繰り返し処理すれば、１００文献分の拒絶理由通知書が１日で取れる計算になります。 <h3 id="hc93a7b1dea">各APIの利用制限数</h3>現状の１日のアクセス数は以下となっています。 表１ API の種類と日次の上限アクセス回数（回／日） １ 特許経過情報 400 ２ シンプル版特許経過情報 400 ３ 特許分割出願情報 30 ４ 特許優先基礎出願情報 30 ５ 特許申請人氏名･名称 200 ６ 特許申請人コード 200 ７ 特許番号参照 50 ８ 特許申請書類 100 ９ 特許発送書類 100 10 特許拒絶理由通知書 100 11 特許引用文献情報 50 12 特許登録情報 200 <h3 id="h7e703d4aaa">pythonモジュール今後の課題</h3>以上で一通りの流れを説明しました。実際に使えるものにするためには以下の実装が必要かと思います。今後の課題ですね。<ul><li>各処理をまとめてクラスにしてイニシャライズ時にusername, passwordを入力できるようにする</li><li>接続の管理　最初のアクセスから時間が経過しても途切れないようにする　→　接続時間の管理、リフレッシュトークンの利用、再ログイン</li><li>上記のクラスに出願番号とAPIの種類を選択させる汎用メソッドの実装</li><li>外部から利用できるライブラリ化</li><li>キャッシュの利用　１度アクセスした情報はキャッシュにより再アクセスしない（API利用では必須と指定されています)</li></ul> <h2 id="h15f56ee55c">特許庁APIの効果的な利用方法</h2><h3 id="h5edfea92e5">利用方法について</h3> <ul><li>リアルタイムの審査状況ウォッチングについては使える可能性あり</li></ul>○ 商用データベースよりも情報は早いのでは無いかと思うーリアルタイム性 × アクセス件数が１日３００件の制限あり<ul><li>審査経過情報のダウンロードツール</li></ul>○ 商用データベースでは取得できない情報をダウンロードできる × 取得情報がzip で、解凍後のテキストファイルがxmlなので取得後加工プログラム必要 <h2 id="h28b62bc2c0">今後の課題</h2>特許庁APIについては試行段階であることから、まだ十分に活用できるほどの機能が揃っておらず、制限も多いと思います。 特許庁情報室にこうした課題と要望を伝えて改善を図ってもらえるよう働きかけていきたいです。 具体的には私としては以下が課題と感じました。 <ul><li>分析に使いづらい</li></ul>アクセス件数が３００件程度のため、分析をするほどのデータが取れない（時間がかかりすぎ る）。jplatpatや商用データベースと取得できる情報が同じ部分が多いのでそちらを使って ダウンロードして処理したほうが効率的<ul><li>ブラウザ(javascript)からのアクセスができない</li></ul>インターフェースとしてブラウザを用いて気軽に使いたいところだが、アクセス制限のため不可<ul><li>問い合わせが出願番号1件であり、レスポンスも対応した情報のみで利用用途が制限される<ul><li>検索クエリを投げられるようにしてほしい</li><li>複数の出願番号一括問い合わせ</li><li>上記の問い合わせに回答を集計した情報でもらいたい</li></ul></li><li>特許検索には全く使えない<ul><li>上記と重複するが検索クエリを投げられるようにしてほしい</li></ul></li><li>利用できる公報情報に制限あり<ul><li>2003年７月以後の出願分のみ</li></ul></li></ul> <h2 id="h6e292c93a5">参考URL</h2>特許庁APIの利用方法については公式ページと合わせて以下を参考にさせていただきました。 非常に参考になります。情報共有いただきありがとうございます。 <h3 id="h48b63b8aac">python</h3>easy_patensとしてpythonライブラリを公開されています。これを使えば自分で実装する必要はなくなります。 <a href="https://qiita.com/easypatents39/items/d069d003b52e8c87873f" target="_blank" rel="noopener noreferrer">https://qiita.com/easypatents39/items/d069d003b52e8c87873f</a> <a href="https://qiita.com/easypatents39/items/b8ecae21e8b20152b1f5" target="_blank" rel="noopener noreferrer">https://qiita.com/easypatents39/items/b8ecae21e8b20152b1f5</a> youtube上で紹介されています。こちらも参考にさせていただきました。<iframe class="embedly-embed" src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FZ0ssBOeYGq4%3Ffeature%3Doembed&display_name=YouTube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DZ0ssBOeYGq4&image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FZ0ssBOeYGq4%2Fhqdefault.jpg&key=94335756f04b424b8ce3ce71cbe3de0a&type=text%2Fhtml&schema=youtube" width="560" height="315" scrolling="no" title="YouTube embed" frameborder="0" allow="autoplay; fullscreen" allowfullscreen="true"></iframe> <h3 id="h978afb20a8">Excel VBA</h3>エクセルマクロでの利用方法を解説されています <a href="https://micasatocasa.org/jpo-api-2" target="_blank" rel="noopener noreferrer">https://micasatocasa.org/jpo-api-2</a> <a href="https://micasatocasa.org/jpo-api-1" target="_blank" rel="noopener noreferrer">https://micasatocasa.org/jpo-api-1</a> JpoApiClass：特許情報取得API用VBAクラス　としてエクセルで利用可能なモジュールを提供しています。 これだとインターフェースもあるのでプログラムすることなく利用できます。 <a href="https://qiita.com/kenichiro_ayaki/items/12e6ef9ab1db0e513588" target="_blank" rel="noopener noreferrer">https://qiita.com/kenichiro_ayaki/items/12e6ef9ab1db0e513588</a>

試行提供されている特許庁APIとは②　～pythonでの利用方法、APIの詳細～

昨年１月から施行提供されている特許庁APIについて、その制度概要から実際に使用する方法まで 数回に分けて紹介したいと思います。まずは１回目、制度の概要について。 特許庁API試行提供制度のHPは<a href="https://www.jpo.go.jp/system/laws/sesaku/data/api-provision.html" target="_blank" rel="noopener noreferrer">こちら</a> <h2 id="h3d54687497">そもそもAPIとは？</h2>ざっくりいうと、「ソフトウェア同士が情報をやり取りする際に使用されるインタフェース」ということになります。 <img src="https://images.microcms-assets.io/assets/3e1420fe5ad546b488659d1241d9ff3d/d10a138e7c94459da87d25e9f3cbca43/How%20the%20API%20works-png-4.webp" alt=""> 出典(Twilioブログ <a style="color:inherit" href="https://cloudapi.kddi-web.com/magazine/twilio-sms/what-is-api" target="_blank" rel="noopener noreferrer">https://cloudapi.kddi-web.com/magazine/twilio-sms/what-is-api</a>) 一般には、単にデータを取得するだけでなく、さまざまなAPIが存在します。<ul><li>クラウドAI　(顔認識、自然言語処理 etc.)</li><li>銀行や決済システム(クレジットカード、paypay etc.)</li><li>ECサイトの運営管理</li><li>データベース </li></ul> 現状の特許庁APIは、出願番号の問い合わせに対して情報を返すのみのシンプルなアプリケーションです。 <h2 id="hff752cf7c1">特許庁APIの仕組み</h2> <img src="https://images.microcms-assets.io/assets/3e1420fe5ad546b488659d1241d9ff3d/8c1565e364114ced9d130b7ae20829f9/APIsiryo2.png" alt=""> 基本的な処理の流れは以下のようになります。<ul><li>自身の作成したアプリケーションからAPIに対して認証用トークンの取得を要求</li><li>特許庁サーバーは正しいリクエストであるかを確認してトークンを送信</li><li>ユーザのアプリケーションはトークンを利用して希望する情報（API）の指定と出願番号を送信</li><li>サーバーは出願番号に該当する情報があれば、JSONまたはzipファイルにてレスポンスを送信</li></ul> <h2 id="hf752580bc1">特許庁APIを使うメリット</h2>　私が試用して感じたメリットは以下の通りです。 <ul><li>リアルタイムの情報を取得できる</li><li>取得が簡単<ul><li>ある程度のプログラミング知識があれば情報取得まではやりやすい</li><li>言語を問わず利用可能 (python, excel vba, node.js etc.)</li><li>特許庁提供の標準データからの自前のデータベース作成はコストがかかりすぎて現実的ではない</li></ul></li><li>他のプログラムとの連携<ul><li>特許事務管理プログラム、経過ウォッチング、データベースサービスなどで都度情報が必要なときに取得できる</li></ul></li><li>言語は問わないので多くのプログラムに組み込める</li><li>民間データベースでダウンロードできないものが取得できる<ul><li>拒絶理由通知書、意見書、補正書等の審査経過書類</li></ul></li></ul> <h2 id="h83e72b78c9">APIと既存サービスの比較</h2>特許庁APIの利用と既存サービスを比較してみました。それぞれ役割が異なる ものなのでお互いの長所短所を補い合う利用方法になるかと思います。 JplatpatのAPIが利用できたら最強だとは思います… <ul><li>jplatpat<ul><li>ブラウザによるアクセスー人手による操作が必要</li><li>インターフェース固定、一部ダウンロード機能あり（件数と項目に制限あり）</li><li>審査経過の情報はすべてブラウザで見られるが、CSVj, PDFダウンロードは不可</li></ul></li><li>バルクデータダウンロード<ul><li>xml, tsv形式による書誌事項、公報データの配布</li><li>過去データは膨大（数テラ単位）、配布は毎日</li><li>データベースの構築、インターフェースの構築、日々の更新とコストが大きい</li><li>書誌事項に関してはすべての情報を含む</li><li>審査経過の情報は含むが、拒絶理由通知書や検索報告書などは配布されていない</li></ul></li><li>商用データベース<ul><li>有料のデータベース</li><li>インターフェースは固定</li><li>ダウンロード機能でまとまった件数を取得できる、項目も柔軟に指定できる</li><li>審査経過の情報は閲覧、取得できない</li></ul></li><li>特許庁API<ul><li>データの取得に関してはリクエストを送るのみで簡単</li><li>データ取得だけでもある程度のプログラミングは必要</li><li>現状大量のデータ取得やアクセスには対応していない</li><li>自身のプログラムに組み込んで情報の取得部分を自動化できる</li><li>拒絶理由通知書や審査経過は取れる</li></ul></li></ul> 以上が制度の概要です。次回は具体的にどのようなデータがとれるのか、制度の利用方法等について解説します。