0,0 → 1,353 |
<!DOCTYPE html> |
<html lang="en"> |
<head> |
<title>OID repository - Getting an OID description in XML for JSON</title> |
<meta charset="UTF-8"><!-- <meta content="text/html; charset=iso-8859-1" http-equiv="content-type"> --> |
<meta name="google-translate-customization" content="ae799a386ca63905-075d0f84d2caa8b0-g8dbf29cdfe9cdbeb-c"> |
<link rel="Stylesheet" type="text/css" href="style.css"> |
<meta name="viewport" content="width=device-width, initial-scale=1"> |
<meta name="DESCRIPTION" content="This OID repository gathers information about Object Identifiers (OIDs), and provides tools to display and search for this information."> |
<meta name="keywords" content="object identifier oid OID repository registration authority ISO ITU"> |
<link rel="SHORTCUT ICON" href="/images/favicon.ico"> |
<script src="scripts.js"></script> |
</head> |
<body id="body" onload="_onload()"> |
<div id="global_container"> |
<div id="header"> |
<a href="index.htm"> |
<img src="images/treewall.jpg" width="130" height="110"> |
</a> |
<h1 style="color: rgb(226, 137, 34);font-size: 35px; font-weight:bold;">OID Repository</h1><br><br><br><br> |
<div id="header_url_and_menu"> |
<div id="header_url"> |
<span style="color: rgb(226, 137, 34);font-size: 15px; font-weight:bold; margin-left:10px; display:inline-block;">www.oid-info.com</span> |
</div> |
<div id="header_url_right"> |
<ul id="header_menu"> |
<li><a href="index.htm">Home</a></li> |
<li><a href="/cgi-bin/display?tree=">Tree display</a></li> |
<li><a href="basic-search.htm">Search</a></li> |
<li><a href="faq.htm">FAQ</a></li> |
<li><a href="/helper">Helper</a></li> |
</ul> |
</div> |
</div> |
<div style="top: 11px; left: 694px; margin-left:-120px;" id="search"> |
<span style="color: rgb(226, 137, 34); font-family: Arial, Helvetica, sans-serif; font-size: 14px; font-weight: bold;">Display OID:</span> <br> |
<form name="form_go" method="get" action="/cgi-bin/display" enctype="multipart/form-data"> |
<input type="hidden" name="action" value="display"> |
<input name="oid" size="20" value="" onfocus="empty();" placeholder="-- OID --" type="text"> <input value="Go" type="submit"> |
</form> |
</div> |
<div id="google_translate"> |
<script> |
function googleTranslateElementInit() { |
new google.translate.TranslateElement({ pageLanguage: 'en', layout: google.translate.TranslateElement.InlineLayout.SIMPLE, gaTrack: true, gaId: 'UA-33779649-1' }, 'google_translate_element'); |
} |
</script> |
<!--<script src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"> |
</script>--> |
</div> |
</div> |
</div> |
<div id="mobile_version"> |
<aside class="sidebar"> |
<nav id="navigation" role="navigation"> |
<form name="form_go" method="get" action="/cgi-bin/display" enctype="multipart/form-data"> |
<a><input name="oid" id="searchbox_mobile" size="35" value="" onfocus="empty();" placeholder="-- Display OID --" type="search"></a> |
</form> |
<a href="index.htm">Home</a> |
<a href="/cgi-bin/display?tree=">Tree display</a> |
<a href="basic-search.htm">Search</a> |
<a href="faq.htm">FAQ</a> |
<a href="/helper">Chatbot helper</a> |
</nav> |
</aside> |
</div> |
<div class="wrapper"> |
<table width="100%" id="header_mobile"> |
<tr> |
<td width="20%"> |
<a href="#body" class="nav-button-open" aria-label="open navigation"></a> |
<a href="#" class="nav-button-close" aria-label="close navigation"></a> |
</td> |
<td width="60%" valign="middle"> |
<h1 style="color: rgb(226, 137, 34);font-size: 18px; font-weight:bold; text-align:right;">OID Repository</h1> |
<div id="header_url"> |
<span style="color: rgb(226, 137, 34);font-size: 15px; font-weight:bold; margin-left:10px; display:inline-block;">www.oid-info.com</span> |
</div> |
</td> |
<td width="20%"><a href="index.htm"><img src="images/treewall.jpg" style="height:10vh;width:auto"></a></td> |
</tr> |
</table> |
|
<div id="global_content"> |
|
<table cellspacing="0" cellpadding="0" border="0" width="100%"> |
|
<tr> |
|
<td height="20" colspan="3" valign="top" width="100%"> </td> |
|
</tr> |
|
<tr> |
<td height="40" valign="top" width="440"> |
<p> |
<span class="page_title">Getting an OID description in XML or JSON format</span> |
</p> |
</td> |
<td height="40" valign="top" width="20"> </td> |
<td width="150" height="40" valign="middle"> |
<img src="images/bullet.gif" width="10" height="8" border="0"><a href="/cgi-bin/manage?a=ca">Request a registrant account</a> |
</td> |
</tr> |
|
</table> |
<table cellspacing="0" cellpadding="0" border="0" width="100%"> |
<tr> |
<td width="10"></td> |
<td> |
|
<p> |
To get the description of an OID in XML or JSON format, use the following |
URL (as a <code>GET</code> or <code>POST</code> <a href="http://www.w3schools.com/TAGs/ref_httpmethods.asp">HTTP |
request method</a>): |
</p> |
<div align="center"> |
<table width="75%" border="1"> |
<tr> |
<td align="center"> |
<div align="center"><font class="color_orange">XML</font> </div> |
</td> |
</tr> |
<tr> |
<td> |
<div align="center"> |
<code><strong>http://oid-info.com/cgi-bin/display?a=<font class="color_orange">get-xml</font><br>&l=</strong><em>your_email_address</em><strong>&p=</strong><em>your_password</em><br><strong>&oid=</strong><em>OID_in_whichever_notation</em></code> |
</div> |
</td> |
</tr> |
<tr> |
<td align="center"> |
<div align="center"><font class="color_orange">JSON</font> </div> |
</td> |
</tr> |
<tr> |
<td> |
<div align="center"> |
<code><strong>http://oid-info.com/cgi-bin/display?a=<font class="color_orange">get-json</font><br>&l=</strong><em>your_email_address</em><strong>&p=</strong><em>your_password</em><br><strong>&oid=</strong><em>OID_in_whichever_notation</em></code> |
</div> |
</td> |
</tr> |
</table><br></div> |
<p> |
<b>Important note</b>: This feature is only available if a <a href="registrant-account-charter.htm">registrant |
account</a> has been assigned to you by the webmaster. |
</p> |
<p> |
When using this feature, you agree to conform to the <a href="disclaimer.htm">terms |
of use</a> of this web site. In particular, you understand that downloading, |
printing or copying from this web site must be for noncommercial use |
only, and must be limited to a small part of the data. Moreover, you |
endeavour to inform users of your application that data are coming from |
<a href="http://oid-info.com">OID-info.com</a> by hyperlinking to <a href="http://oid-info.com">http://oid-info.com</a>. |
</p> |
</td> |
</tr> |
</table> |
<table cellspacing="0" cellpadding="0" border="0" width="100%"> |
<tr> |
<td width="10"></td> |
<td> |
<p> |
If there is no error, the returned result is a piece of XML (resp. |
JSON) which looks like the following examples. |
</p> |
<p> |
The generated XML mostly conforms to the <a href="http://oid-info.com/oid.xsd">XML |
Schema for the OID repository</a>. One difference is that the <code><strong><value></strong></code> |
tag is separated in three tags: <code><strong><asn1-notation></strong></code>, |
<code><strong><dot-notation></strong></code> and <code><strong><iri-notation></strong></code>. |
Another main difference is that the <code><strong><oid></strong></code> |
tag can have two optional attributes: |
</p> |
<ul> |
<li> |
<code><strong>category</strong></code> which, when present, takes |
one or multiple ("<code>;</code>"-separated) values among "<a href="faq.htm#26"><code>Leaf |
OID</code></a>", "<a href="faq.htm#26"><code>Frozen OID</code></a>", |
"<code>Not allocating identifiers</code>" and "<code>Not |
allocating Unicode labels</code>"; |
</li> |
<li> |
<code><strong>standardized</strong></code> which, when present, |
takes value "<code>true</code>" and indicates that the last <a href="name-forms.htm">identifier</a> |
in the <strong><code><value></code></strong> can be used alone |
without its associated number; |
</li> |
<li> |
<code>last-modification</code> is the date (YYYY-MM-DD) when the |
OID description was last modified in the OID repository. |
</li> |
</ul> |
<p> |
In JSON, keys <code>"category"</code>, <code>"identifier"</code>, |
<code>"unicode-label"</code>, <code>"long-arc"</code> |
are tables (hence between square brackets). |
</p> |
<table width="100%" border="1"> |
<tr> |
<td align="center"> |
<font class="color_orange">XML</font> |
</td> |
</tr> |
<tr> |
<td> |
<p> |
<code><strong><oid category="</strong>Leaf OID"<strong>><br> <asn1_notation></strong>{joint-iso-itu-t(2) |
example(999) xml-submission(777)}<strong></asn1_notation><br> <dot-notation></strong>2.999.777<strong></dot-notation><br> <iri-notation></strong>/Joint-ISO-ITU-T/Example/XML_submission<strong></iri-notation><br> <identifier></strong>xml-submission<strong></identifier><br> </strong><strong><identifier></strong>xml-document<strong></identifier><br> <unicode-label></strong>XML_submission<strong></unicode-label><br> <description></strong>Example of a description |
conforming to the <a href="http://oid-info.com/oid.xsd">XML |
Schema of the OID repository</a>.<strong></description><br> <information></strong>More information can be |
found at <a href="http://oid-info.com/submit.htm">Submit |
OID descriptions as XML files</a>.<strong></information><br> <current-registrant><br> </strong><strong><first-name></strong>John<strong></first-name><br> <last-name></strong>Doe<strong></last-name><br> <email></strong>john.doe@dummy.com<strong></email><br> <modification-date></strong>2002-05-25<strong></modification-date><br> </current-registrant><br> <first-registrant privacy="</strong>true<strong>"><br> <first-name></strong>Paul<strong></first-name><br> <last-name></strong>Connor<strong></last-name><br> <email></strong>paul.connor@myhost.com<strong></email><br> <creation-date></strong>1999-12-31<strong></creation-date><br> </first-registrant><br> <last-modification></strong>2017-05-23<strong></last-modification><br></oid></strong></code> |
</p> |
</td> |
</tr> |
<tr> |
<td align="center"> |
<font class="color_orange">JSON</font> |
</td> |
</tr> |
<tr> |
<tr> |
<td> |
<p> |
<code><strong>{ "oid": {<br> "category": [</strong>"Leaf |
OID"<strong>]</strong>,<br><strong> "asn1-notation"</strong>: |
"{joint-iso-itu-t(2) example(999) xml-submission(777)}<strong>",<br> "dot-notation"</strong>: "2.999.777<strong>",<br> "iri-notation"</strong>: "/Joint-ISO-ITU-T/Example/XML_submission<strong>",<br></strong><strong> "identifier": |
[</strong>"xml-submission", "xml-document"<strong>]</strong>,<br><strong> "unicode-label": [</strong>"XML_submission"<strong>]</strong>,<br><strong> </strong></code><strong><code><strong> </strong>"description":</code></strong><code>"Example of a description conforming to the <a href=\"http://oid-info.com/oid.xsd\">XML |
Schema of the OID repository</a>.<strong>",<br> "information":</strong> "More |
information can be found at <a href=\"http://oid-info.com/submit.htm\">Submit |
OID descriptions as XML files</a>."<strong>,<br> "current-registrant": {<br> </strong></code><strong><code>"first-name":</code></strong><code>"John<strong>",<br> "last-name":</strong> |
"Doe"<strong>,<br> "email":</strong> "john.doe@dummy.com"<strong>,<br> "modification-date":</strong> |
"2002-05-25"<br><strong> }, <br> "first-registrant": {<br> "privacy":</strong> "true"<strong>,<br> "first-name":</strong> |
"Paul"<strong>,<br> "last-name":</strong> |
"Connor<strong>",<br> "email": "</strong>paul.connor@myhost.com<strong>",<br> "creation-date": "</strong>1999-12-31"<strong><br> },<br> "last-modification":</strong> "2017-05-23"<br> }<br>}</code> |
</p> |
</td> |
</tr> |
</table> |
</td> |
</tr> |
</table> |
|
<table cellspacing="0" cellpadding="0" border="0" width="100%"> |
<tr> |
<td width="10"></td> |
<td> |
Errors are rendered as follows:<br><br><table width="100%" border="1"> |
<tr> |
<td align="center"> <font class="color_orange">XML</font> </td> |
</tr> |
<tr> |
<td> |
<code><strong><error code="</strong><em>error_code</em><strong>"></strong><br> Error message in English<br><strong></error></strong></code> |
</td> |
</tr> |
<tr> |
<td align="center"> <font class="color_orange">JSON</font> </td> |
</tr> |
<tr> |
<td> |
<code><strong>{ "error": {<br> "code":</strong> "<em>error_code</em><strong>",<br> "message":</strong> "Error message |
in English"<br> <strong>}<br>}</strong></code> |
</td> |
</tr> |
</table> |
<br>where <code><em>error_code</em></code> is one of: |
<ul> |
<li> |
"<code>illegal_oid</code>" when the OID given in parameter |
<strong><code>oid</code></strong> cannot exist because, e.g., it is |
known to be forbidden or one of its ascendant OIDs is a leaf (the |
"<code>Error message in English</code>" explains what the |
problem is); |
</li> |
<li> |
"<code>maintenance</code>" when the OID repository is |
not available because it is under maintenance; |
</li> |
<li> |
"<code>oid_not_validated</code>" when the OID given in |
parameter <strong><code>oid</code></strong> is described in the OID |
repository but has not yet been validated by the OID administrator, |
so its description is not yet publicly available; |
</li> |
<li> |
"<code>runtime_error</code>" when there is an internal |
problem (in which case the OID repository admin is automatically notified |
by email); |
</li> |
<li> |
"<code>syntax_error</code>" when the OID given in parameter |
<strong><code>oid</code></strong> is not syntactiacally correct (the |
"<code>Error message in English</code>" explains what the |
problem is); |
</li> |
<li> |
"<code>unknown_oid</code>" when the OID given in parameter |
<strong><code>oid</code></strong> is not described in the OID repository |
(or this parameter is missing); |
</li> |
<li> |
"<code>wrong_login</code>" when parameters <strong><code>login</code></strong> |
or <strong><code>password</code></strong> are not correct (the "<code>Error |
message in English</code>" explains what the problem is). |
</li> |
</ul> |
Note that the <code><em>error_code</em></code> won't change whereas the |
"<code>Error message in English</code>" may evolve, so it is |
recommended that, if needed, your application checks the <code><em>error_code</em></code>. |
</td> |
</tr> |
</table> |
|
</div> |
|
|
<center id="footer"> |
<img style="border: 0px solid ; width: 760px; height: 2px;" alt="separation line" src="images/separation800.png" width="760" height="2"><br><br> |
<table width="710" cellspacing="0" cellpadding="0" border="0"> |
<tr valign="baseline"> |
<td width="34"> |
<a href="/helper"> |
<img src="images/enveloppe.png" width="30" height="13" name="mail" border="0" alt="OID helper"> |
</a> |
</td> |
<td width="58" align="center"><font size="-2">Webmaster</font></td> |
<td width="10" align="center"><img src="images/pointorange_small.gif" width="14" height="10"></td> |
<td width="78" align="center"> |
<font size="-2"> |
<!--<script language="JavaScript"> |
d=new Date(document.lastModified) |
month=new Array("Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec") |
if (Date.parse(document.lastModified) != 0) |
document.write(d.getDate()+" "+month[d.getMonth()]+" "+d.getFullYear()); |
</script>--> |
15 Apr 2022 |
</font> |
</td> |
<td width="24" align="center"><img src="images/pointorange_small.gif" width="14" height="10"></td> |
<td align="center" width="409"> |
<font size=-1> |
|
</font> |
</td> |
<td height="20" width="162" valign="middle" align="right"><a href="#top"><img src="images/page_top.png" width="150" height="17" border="0"></a></td> |
</tr> |
</table><br> |
</center> |
</div> |
</body> |
</html> |