用語集参照 APIの使い方 || OSS iPedia

用語集参照 APIの使い方

用語集参照APIは、用語集、Q&A、ディレクトリの指定したページを取得する機能を提供します。

リクエスト例

http://ossipedia.ipa.go.jp/webapi/getkb?key=XXXXXXXX&query=Linux&format=html

リクエストURL

http://ossipedia.ipa.go.jp/webapi/getkb

リクエストパラメータ

パラメータ	説明	値	デフォルト値
key(必須)	OSS iPedia webAPIの利用キー	string
query(必須)	用語集のタイトル	string
format	レスポンス内の配信物のフォーマット。"plain"または"html"から選択する	string	plain

レスポンス例

format=plain

<kb>
	<title>Linux</title>
	<url>http://ossipedia.ipa.go.jp/kb/Linux</url>
	<body>
読み  リナックス／リヌクス／ライナックス


パーソナルコンピュータ上で利用されるOSの1つで、UNIXがモデルとなっている。WebサーバーやDNSサーバーなど、インターネット/イントラネット用のサーバーOSとして広く使われるほか、ユーザー用のデスクトップ環境としても利用されている。また、現在はワークステーションや汎用機でも使われている。

狭義のLinuxはLinuxカーネル部分だけを指すが、一般には、Linuxカーネルを中心としたOS全体を指すことが多い。シェルやツール群の多くはGNUツール（GPLで配布されているツール）であることから、OSとしてのLinuxは「GNU/Linuxシステム」と呼ばれることがある。また、「Red Hat Linux」「Fedora Core」「Turbolinux」「Debian GNU/Linux」のように、プロジェクト名やディストリビューション名で呼ばれることも多い。

なお、"Linux"の読み方は決まっていない。Linuxカーネル開発者Linus氏は、「好きに読んでくれてかまわない。ただしボクの名前はリーナス」と述べている。本人の発音はwavファイルで公開されており、カタカナで表記すると´リーヌクス¡に近い。


 関連見出し
組み込みLinux
POSIX
ディストリビューション
GNU General Public License


 関連URL
The Linux Kernel Archives（http://www.kernel.org/）
日本の Linux 情報（http://www.linux.or.jp/）
GNU オペレーティング・システム（http://www.gnu.org/home.ja.html）
	</body>
</kb>

format=html

<kb>
	<title>Linux</title>
	<url>http://ossipedia.ipa.go.jp/kb/Linux</url>
	<content:encoded><![CDATA[
  <p><br />
</p>
<dl><dt>読み </dt><dd> リナックス／リヌクス／ライナックス
</dd></dl>
<p><br />
パーソナルコンピュータ上で利用されるOSの1つで、UNIXがモデルとなっている。WebサーバーやDNSサーバーなど、インターネット/イントラネット用のサーバーOSとして広く使われるほか、ユーザー用のデスクトップ環境としても利用されている。また、現在はワークステーションや汎用機でも使われている。
</p><p><br />
狭義のLinuxはLinuxカーネル部分だけを指すが、一般には、Linuxカーネルを中心としたOS全体を指すことが多い。シェルやツール群の多くはGNUツール（GPLで配布されているツール）であることから、OSとしてのLinuxは「GNU/Linuxシステム」と呼ばれることがある。また、「<a href="/kb/Red_Hat_Linux" title="Red Hat Linux">Red Hat Linux</a>」「<a href="/kb/Fedora_Core" title="Fedora Core">Fedora Core</a>」「<a href="/kb/Turbolinux" title="Turbolinux">Turbolinux</a>」「<a href="/kb/Debian_GNU/Linux" title="Debian GNU/Linux">Debian GNU/Linux</a>」のように、プロジェクト名やディストリビューション名で呼ばれることも多い。
</p><p><br />
なお、"Linux"の読み方は決まっていない。Linuxカーネル開発者Linus氏は、「好きに読んでくれてかまわない。ただしボクの名前はリーナス」と述べている。本人の発音はwavファイルで公開されており、カタカナで表記すると"リーヌクス"に近い。
</p><p><br />
</p>
<a name=".E9.96.A2.E9.80.A3.E8.A6.8B.E5.87.BA.E3.81.97"></a><h2> <span class="mw-headline">関連見出し</span></h2>
<p><a href="/kb/%E7%B5%84%E3%81%BF%E8%BE%BC%E3%81%BFLinux" title="組み込みLinux">組み込みLinux</a>
</p><p><a href="/kb/POSIX" title="POSIX">POSIX</a>
</p><p><a href="/kb/%E3%83%87%E3%82%A3%E3%82%B9%E3%83%88%E3%83%AA%E3%83%93%E3%83%A5%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3" title="ディストリビューション">ディストリビューション</a>
</p><p><a href="/kb/GNU_General_Public_License" title="GNU General Public License">GNU General Public License</a>
</p><p><br />
</p>
<a name=".E9.96.A2.E9.80.A3URL"></a><h2> <span class="mw-headline">関連URL</span></h2>
<p><a href="http://www.kernel.org/" class="external text" title="http://www.kernel.org/" rel="nofollow">The Linux Kernel Archives（http://www.kernel.org/）</a>
</p><p><a href="http://www.linux.or.jp/" class="external text" title="http://www.linux.or.jp/" rel="nofollow">日本の Linux 情報（http://www.linux.or.jp/）</a>
</p><p><a href="http://www.gnu.org/home.ja.html" class="external text" title="http://www.gnu.org/home.ja.html" rel="nofollow">GNU オペレーティング・システム（http://www.gnu.org/home.ja.html）</a>
</p>]]>
	</content:encoded>
</kb>

レスポンス

フィールド	説明	親要素
kb	レスポンスの全てを含む要素	なし
title	配信物のタイトル	kb
url	配信物の存在するURL	kb
body	配信物	kb
content:encoded	配信物	kb

エラーレスポンス例

<Error>
	403: Forbidden.
</Error>

エラーレスポンス

フィールド	説明	親要素
Error	エラーコード+エラーメッセージ	なし

エラーコード

コード	説明
400	Bad request. 渡されたパラメータが期待されたものと異なる場合
403	Forbidden. アクセスを許されていない場合
404	Not Found. 指定されたリソースが見つからない場合

サンプルコード

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html lang="ja">
  <head>
    <title>用語集取得API使用例</title>
  </head>
  <body>
<?php
function getContent()
{
    // URLの作成
    $request_url = "http://ossipedia.ipa.go.jp/webapi/getkb";
    $key = "XXXXXXXX";
    $query = urlencode("Q：どうしてオープンソースという考え方が出てきたのですか？");
    $format = "html";
    $request_url .= "?query=".$query."&format=".$format."&key=".$key;

    // APIへの接続
    $content = file_get_contents($request_url);
    if (!$content) {
      return "<p>情報の取得に失敗しました</p>";
    }

    // 取得XMLの解析
    $xml = simplexml_load_string($content);
    if (!$xml) {
      return "<p>情報の取得に失敗しました</p>";
    }

    // 出力の作成
    $ns = $xml->getNamespaces(true);

    $result = "<a href=\"".htmlspecialchars((string)$xml->url)."\">";
    $result .= htmlspecialchars((string)$xml->title);
    $result .= "</a>";
    $result .= (string)$xml->children($ns["content"]);
    return $result;
}
?>
    <h1>用語集取得API使用例</h1>
    <?php echo getContent(); ?>
  </body>
</html>

Web APIの利用申請について

Web APIを利用したい方はこちらからWeb API利用キーの利用申請をしてください。

用語集取得例

Q：どうしてオープンソースという考え方が出てきたのですか？

ソフトウェアは、特定のハードウェアやプラットフォーム向けに作られることが普通でしたが、その中で使われる技術やアルゴリズムは、他のプラットフォームやハードウェアにも利用可能なものです。ソフトウェアのソースコードを公開することで、こうした技術を共有することが可能になります。これにより、ソフトウェア自体を進化させることが可能になり、より良いソフトウェアを作ることも可能になります。また、その一部を利用して、別種の有益なソフトウェアを作ることもできるでしょう。ソースコードを公開することには、こうしたメリットがありますが、反面、単なる公開のみで、その利用が制限されるようでは、技術の進歩にとってメリットがありません。

大学などの研究分野では、成果を共有するという観点からソースコードの公開が行われていたり、国によっては、税金を利用して作られたソフトウェアを広く国民が利用可能にするために公開するといったことが行われてきました。また、個人でも開発したソフトウェアのソースコードを公開することもありました。こうした中で、利用制限や派生物に関する問題などがあり、ソフトウェア開発者コミュニティの中で、これらを解決する形で形成されていったのが、オープンソースの考え方です。