<!DOCTYPE html>
<
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="icon" type="/image/png" href="images/favicon.png">
<
body id="body" onload="_onload()">
<
div id="global_container">
<
img src="images/treewall.jpg" width="130" height="110">
<
div id="header_url_and_menu">
<
div id="header_url">www.oid-info.com<
/div>
<
div id="header_url_right">
<
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>
<
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">
<
div id="google_translate">
function googleTranslateElementInit() {
new google.translate.TranslateElement({ pageLanguage: 'en', layout: google.translate.TranslateElement.InlineLayout.SIMPLE, gaTrack: true, gaId: 'UA-33779649-1' }, 'google_translate_element');
}
<!--<
script src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit">
<
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>
<
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>
<
table width="100%" id="header_mobile">
<
a href="#body" class="nav-button-open" aria-
label="open navigation"><
/a>
<
a href="#" class="nav-button-close" aria-
label="close navigation"><
/a>
<
td width="60%" valign="middle">
<
h1 id="header_h1">OID Repository<
/h1>
<
div id="header_url">www.oid-info.com<
/div>
<
td width="20%"><
a href="index.htm"><
img src="images/treewall.jpg" style="height:10vh;width:auto"><
/a><
/td>
<
div id="global_content">
<
table cellspacing="0" cellpadding="0" border="0" width="100%">
<
td height="20" colspan="3" valign="top" width="100%"> <
/td>
<
td height="40" valign="top" width="440">
<
span class="page_title">Getting an OID description in XML or JSON format<
/span>
<
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>
<
table cellspacing="0" cellpadding="0" border="0" width="100%">
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
<
table width="75%" border="1">
<
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.
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 adding a hyperlink to <
a href="http://oid-info.com">http:
//oid-info.com<
/a>
or <
a href="https://oid-rep.orange-labs.fr">https:
//oid-rep.orange-labs.fr<
/a>.
<
table cellspacing="0" cellpadding="0" border="0" width="100%">
If there is no error, the returned result is a piece of XML (resp.
JSON) which looks like the following examples.
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 can have two optional attributes:
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>";
takes
value "<code>true</code>" and indicates that the last <
a href="name-forms.htm">identifier<
/a>
without its associated number;
<
code>last-modification<
/code> is the date
(YYYY-MM-DD
) when the
OID description was last modified in the OID repository.
In JSON, keys <
code>"category"<
/code>, <
code>"identifier"<
/code>,
are tables (hence between square brackets).
<
table width="100%" border="1">
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>
<
code><
strong>
{ "oid":
{<
br> "category":
[<
/strong>"Leaf
"
{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":
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>
<
table cellspacing="0" cellpadding="0" border="0" width="100%">
Errors are rendered as follows:<
br><
br><
table width="100%" border="1">
<
td align="center"> <
font class="color_orange">XML<
/font> <
/td>
<
td align="center"> <
font class="color_orange">JSON<
/font> <
/td>
<
code><
strong>
{ "error":
{<
br> "code":<
/strong> "<
em>error_code<
/em><
strong>",<
br> "message":<
/strong> "Error message
"<
code>illegal_oid<
/code>" when the OID given in parameter
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);
"<
code>maintenance<
/code>" when the OID repository is
not available because it is under maintenance;
"<
code>oid_not_validated<
/code>" when the OID given in
repository but has not yet been validated by the OID administrator,
so its description is not yet publicly available;
"<
code>runtime_error<
/code>" when there is an internal
problem (in which case the OID repository admin is automatically notified
by email);
"<
code>syntax_error<
/code>" when the OID given in parameter
"<
code>Error message in English<
/code>" explains what the
problem is);
"<
code>unknown_oid<
/code>" when the OID given in parameter
(or this parameter is missing);
message in English<
/code>" explains what the problem is
).
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>
</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>