MyJVN >> API >> getOvalData >> 動作確認支援ツール

■ getOvalData

OVAL 定義データを取得します。

■ リクエスト

  • http://jvndb.jvn.jp/myjvn?method=getOvalData&パラメタ名=パラメタ値&...
    • リクエスト URL は、HTTP の GET および POST に対応しています。
  • パラメタ
    • メソッド名、パラメタ名は大文字小文字を区別しています。
    • 必須パラメタが未指定、または値なし ("method="など) の場合はエラーとなります。
    • 必須でないパラメタが未指定、または値なし ("lang="など) の場合はデフォルトを使用します。

パラメタ名 名称 パラメタ値 必須 デフォルト[1]
method メソッド名 getOvalData (固定)
startItem エントリ開始位置 整数 (半角数字)
1〜応答エントリ数
1
maxCountItem エントリ取得件数 整数 (半角数字)
1〜10 (getOvalData エントリ上限値)
10
ovalId OVAL 定義データ識別子 getOvalList の レスポンス <OvalListItem oid="oval:jp.jvn.jvndb.v1.oval:def:###"/> の oid を指定

  • 大文字/小文字区別なし
  • 複数指定時は "+" で連結
lang 表示言語 (日本語/英語) ja:日本語、en:英語 ja
xsl XSLファイル適用/未適用 1:適用、0:未適用 (準備中) 0
  • 1)「デフォルト」は、該当パラメタに指定がない場合 (パラメタ自体もしくはパラメタ値が未指定の場合)に MyJVN API 側で自動的に設定する値です。

■ レスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<Result version="3.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://jvndb.jvn.jp/myjvn/Results"
xmlns:mjres="http://jvndb.jvn.jp/myjvn/Results"
xmlns:status="http://jvndb.jvn.jp/myjvn/Status"
xsi:schemaLocation="http://jvndb.jvn.jp/myjvn/Results 
http://jvndb.jvn.jp/schema/results_3.1.xsd ">

<oval_definitions xmlns="http://oval.mitre.org/XMLSchema/oval-definitions-5"
xmlns:oval="http://oval.mitre.org/XMLSchema/oval-common-5"
xmlns:oval-def="http://oval.mitre.org/XMLSchema/oval-definitions-5"
xmlns:jvnmeta="http://jvndb.jvn.jp/myjvn/jvnmetadata"
xmlns:jvndef="http://jvndb.jvn.jp/myjvn/jvndefinitions"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://oval.mitre.org/XMLSchema/oval-definitions-5#windows
http://oval.mitre.org/language/download/schema/version5.8/ovaldefinition/minimal/windows-definitions-schema.xsd
http://oval.mitre.org/XMLSchema/oval-definitions-5#independent
http://oval.mitre.org/language/download/schema/version5.8/ovaldefinition/minimal/independent-definitions-schema.xsd
http://oval.mitre.org/XMLSchema/oval-definitions-5
http://jvndb.jvn.jp/schema/oval-definitions-schema_5.8.xsd
http://oval.mitre.org/XMLSchema/oval-common-5
http://oval.mitre.org/language/download/schema/version5.8/ovaldefinition/minimal/oval-common-schema.xsd
http://jvndb.jvn.jp/myjvn/jvnmetadata
http://jvndb.jvn.jp/schema/jvnmetadata_0.3.xsd">
  <generator>
    <oval:product_name>The OVAL Repository (MyJVN API Ver 3.0)</oval:product_name>
    <oval:schema_version>5.8</oval:schema_version>
    <oval:timestamp>2011-08-12T11:32:49+09:00</oval:timestamp>
  </generator>
  OVAL 定義データ (definitions, tests, states, objects)
</oval_definitions>
件数分 oval_definitions ノードを繰り返します。

<status:Status
version="3.1"
method="getOvalData"
lang="表示言語"
retCd="リターンコード (0:成功時、1:エラー時) "
retMax="取得件数"
errCd="エラーコード (処理成功時は空文字列) "
errMsg="エラーメッセージ (処理成功時は空文字列) "
totalRes="応答エントリ総数"
totalResRet="応答エントリ数"
firstRes="応答エントリ開始位置"
各リクエストパラメタ>
</status:Status>
</Result>

  • エラーコードとエラーメッセージ

パラメタ 条件 エラーコード エラーメッセージ
method パラメタなし、パラメタ値なし、対象外のメソッド名 XX00000000 対象外のメソッド名です。メソッド名を確認の上、再試行してください。
startItem 半角数字以外 OD01020851 startItem は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) OD01020852 startItem は正の整数値のみ指定可能です。
startItem > 応答エントリ数 OD01030853 startItem が検索結果件数を超えています。
maxCountItem 半角数字以外 OD02020854 maxCountItem は半角数値のみ指定可能です(1〜2147483647)。
整数以外(0、マイナス、小数など) OD02020855 maxCountItem は正の整数値のみ指定可能です。
maxCountItem > エントリ上限値 OD02030856 maxCountItem が API 検索上限値を超えています。
ovalId ovalId パラメタならびにパラメタ値未設定 OD01010858 ovalId パラメタとパラメタ値は必須です。
lang "en"、"ja"以外 OD06030857 lang は "en" または "ja" のみ指定可能です。
サーバ側でエラーが発生した場合 RQ01999951 ※サーバ側でエラーが発生しました。しばらく時間を置いてから再試行してください。問題が解決しない場合は管理者にお問い合わせください。

TOP

[更新履歴]
2012年08月09日 初版.