MyJVN >> API >> getOvalData >> Tool

getOvalData

Getting on the OVAL definition in JVN repository

Request

  • http://jvndb.jvn.jp/myjvn?method=getOvalData&ParameterName=ParameterValue&...
    • MyJVN API supports GET and POST method.

ParameterName Description ParameterValue Required Default
method Method name of API getOvalData (Fix) v --
startItem Start position of items Integer (1 - The item number of results) -- 1
maxCountItem Maximum number of items Integer
1 - 10 (The maximum item number of results in getOvalData API)
-- 10
ovalId OVAL definition ID oid of <OvalListItem oid="oval:jp.jvn.jvndb.v1.oval:def:###"/> in the response of getOvalList

  • Case-insensitive
  • Multi-valued value by the plus (+) "string concatenate"
v --
lang Language (Japanese/English) ja: Japanese en: English -- ja
xsl XSL 1:Enable 0:Disable (Under Construction) -- 0

Response

<?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 definition (definitions, tests, states, objects and etc.)
</oval_definitions>
Repeat of oval_definitions node

<status:Status
version="3.1"
method="getOvalData"
lang="Language"
retCd="Return code (0:success, 1:failure) "
retMax="Maximum number of Entry"
errCd="Error code (Null:success) "
errMsg="Error message (Null:success) "
totalRes="Total number of Result entries"
totalResRet="Number of Result entries"
firstRes="Start entry number in Result entries"
Parameters in request>
</status:Status>
</Result>

  • Error code and Error message

ParameterName Error code Error message
method XX00000000 Invalid or no method name. Please retry with valid method name.
startItem OD01020851 Parameter startItem can be number only (1 to 2147483647).
OD01020852 Parameter startItem can be positive number only.
OD01030853 Parameter startItem exceeds result count.
maxCountItem OD02020854 Parameter maxCountItem can be number only (1 to 2147483647).
OD02020855 Parameter maxCountItem can be positive number only.
OD02030856 Parameter maxCountItem exceeds maximum count set by API.
ovalId OD01010858 No value in parameter ovalId.
lang OD06030857 Parameter lang can have "en" and "ja" only.
-- RQ01999951 Error occurred while processing the request. Please retry later or contact administrator.

TOP

[Revisions]
August 9, 2012: MyJVN API getOvalData released.