Rev 6 | Go to most recent revision | Details | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 2 | daniel-mar | 1 | <!DOCTYPE html> |
| 2 | <html lang="en"> |
||
| 3 | <head> |
||
| 4 | <title>OID repository - Getting an OID description in XML for JSON</title> |
||
| 5 | <meta charset="UTF-8"><!-- <meta content="text/html; charset=iso-8859-1" http-equiv="content-type"> --> |
||
| 6 | <meta name="google-translate-customization" content="ae799a386ca63905-075d0f84d2caa8b0-g8dbf29cdfe9cdbeb-c"> |
||
| 7 | <link rel="Stylesheet" type="text/css" href="style.css"> |
||
| 8 | <meta name="viewport" content="width=device-width, initial-scale=1"> |
||
| 9 | <meta name="DESCRIPTION" content="This OID repository gathers information about Object Identifiers (OIDs), and provides tools to display and search for this information."> |
||
| 10 | <meta name="keywords" content="object identifier oid OID repository registration authority ISO ITU"> |
||
| 11 | <link rel="SHORTCUT ICON" href="/images/favicon.ico"> |
||
| 12 | <script src="scripts.js"></script> |
||
| 13 | </head> |
||
| 14 | <body id="body" onload="_onload()"> |
||
| 15 | <div id="global_container"> |
||
| 16 | <div id="header"> |
||
| 17 | <a href="index.htm"> |
||
| 18 | <img src="images/treewall.jpg" width="130" height="110"> |
||
| 19 | </a> |
||
| 20 | <h1 style="color: rgb(226, 137, 34);font-size: 35px; font-weight:bold;">OID Repository</h1><br><br><br><br> |
||
| 21 | <div id="header_url_and_menu"> |
||
| 22 | <div id="header_url"> |
||
| 23 | <span style="color: rgb(226, 137, 34);font-size: 15px; font-weight:bold; margin-left:10px; display:inline-block;">www.oid-info.com</span> |
||
| 24 | </div> |
||
| 25 | <div id="header_url_right"> |
||
| 26 | <ul id="header_menu"> |
||
| 27 | <li><a href="index.htm">Home</a></li> |
||
| 28 | <li><a href="/cgi-bin/display?tree=">Tree display</a></li> |
||
| 29 | <li><a href="basic-search.htm">Search</a></li> |
||
| 30 | <li><a href="faq.htm">FAQ</a></li> |
||
| 31 | <li><a href="/helper">Helper</a></li> |
||
| 32 | </ul> |
||
| 33 | </div> |
||
| 34 | </div> |
||
| 35 | <div style="top: 11px; left: 694px; margin-left:-120px;" id="search"> |
||
| 36 | <span style="color: rgb(226, 137, 34); font-family: Arial, Helvetica, sans-serif; font-size: 14px; font-weight: bold;">Display OID:</span> <br> |
||
| 37 | <form name="form_go" method="get" action="/cgi-bin/display" enctype="multipart/form-data"> |
||
| 38 | <input type="hidden" name="action" value="display"> |
||
| 39 | <input name="oid" size="20" value="" onfocus="empty();" placeholder="-- OID --" type="text"> <input value="Go" type="submit"> |
||
| 40 | </form> |
||
| 41 | </div> |
||
| 42 | <div id="google_translate"> |
||
| 43 | <script> |
||
| 44 | function googleTranslateElementInit() { |
||
| 45 | new google.translate.TranslateElement({ pageLanguage: 'en', layout: google.translate.TranslateElement.InlineLayout.SIMPLE, gaTrack: true, gaId: 'UA-33779649-1' }, 'google_translate_element'); |
||
| 46 | } |
||
| 47 | </script> |
||
| 48 | <!--<script src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"> |
||
| 49 | </script>--> |
||
| 50 | </div> |
||
| 51 | </div> |
||
| 52 | </div> |
||
| 53 | <div id="mobile_version"> |
||
| 54 | <aside class="sidebar"> |
||
| 55 | <nav id="navigation" role="navigation"> |
||
| 56 | <form name="form_go" method="get" action="/cgi-bin/display" enctype="multipart/form-data"> |
||
| 57 | <a><input name="oid" id="searchbox_mobile" size="35" value="" onfocus="empty();" placeholder="-- Display OID --" type="search"></a> |
||
| 58 | </form> |
||
| 59 | <a href="index.htm">Home</a> |
||
| 60 | <a href="/cgi-bin/display?tree=">Tree display</a> |
||
| 61 | <a href="basic-search.htm">Search</a> |
||
| 62 | <a href="faq.htm">FAQ</a> |
||
| 63 | <a href="/helper">Chatbot helper</a> |
||
| 64 | </nav> |
||
| 65 | </aside> |
||
| 66 | </div> |
||
| 67 | <div class="wrapper"> |
||
| 68 | <table width="100%" id="header_mobile"> |
||
| 69 | <tr> |
||
| 70 | <td width="20%"> |
||
| 71 | <a href="#body" class="nav-button-open" aria-label="open navigation"></a> |
||
| 72 | <a href="#" class="nav-button-close" aria-label="close navigation"></a> |
||
| 73 | </td> |
||
| 74 | <td width="60%" valign="middle"> |
||
| 75 | <h1 style="color: rgb(226, 137, 34);font-size: 18px; font-weight:bold; text-align:right;">OID Repository</h1> |
||
| 76 | <div id="header_url"> |
||
| 77 | <span style="color: rgb(226, 137, 34);font-size: 15px; font-weight:bold; margin-left:10px; display:inline-block;">www.oid-info.com</span> |
||
| 78 | </div> |
||
| 79 | </td> |
||
| 80 | <td width="20%"><a href="index.htm"><img src="images/treewall.jpg" style="height:10vh;width:auto"></a></td> |
||
| 81 | </tr> |
||
| 82 | </table> |
||
| 83 | |||
| 84 | <div id="global_content"> |
||
| 85 | |||
| 86 | <table cellspacing="0" cellpadding="0" border="0" width="100%"> |
||
| 87 | |||
| 88 | <tr> |
||
| 89 | |||
| 90 | <td height="20" colspan="3" valign="top" width="100%"> </td> |
||
| 91 | |||
| 92 | </tr> |
||
| 93 | |||
| 94 | <tr> |
||
| 95 | <td height="40" valign="top" width="440"> |
||
| 96 | <p> |
||
| 97 | <span class="page_title">Getting an OID description in XML or JSON format</span> |
||
| 98 | </p> |
||
| 99 | </td> |
||
| 100 | <td height="40" valign="top" width="20"> </td> |
||
| 101 | <td width="150" height="40" valign="middle"> |
||
| 102 | <img src="images/bullet.gif" width="10" height="8" border="0"><a href="/cgi-bin/manage?a=ca">Request a registrant account</a> |
||
| 103 | </td> |
||
| 104 | </tr> |
||
| 105 | |||
| 106 | </table> |
||
| 107 | <table cellspacing="0" cellpadding="0" border="0" width="100%"> |
||
| 108 | <tr> |
||
| 109 | <td width="10"></td> |
||
| 110 | <td> |
||
| 111 | |||
| 112 | <p> |
||
| 113 | To get the description of an OID in XML or JSON format, use the following |
||
| 114 | URL (as a <code>GET</code> or <code>POST</code> <a href="http://www.w3schools.com/TAGs/ref_httpmethods.asp">HTTP |
||
| 115 | request method</a>): |
||
| 116 | </p> |
||
| 117 | <div align="center"> |
||
| 118 | <table width="75%" border="1"> |
||
| 119 | <tr> |
||
| 120 | <td align="center"> |
||
| 121 | <div align="center"><font class="color_orange">XML</font> </div> |
||
| 122 | </td> |
||
| 123 | </tr> |
||
| 124 | <tr> |
||
| 125 | <td> |
||
| 126 | <div align="center"> |
||
| 127 | <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> |
||
| 128 | </div> |
||
| 129 | </td> |
||
| 130 | </tr> |
||
| 131 | <tr> |
||
| 132 | <td align="center"> |
||
| 133 | <div align="center"><font class="color_orange">JSON</font> </div> |
||
| 134 | </td> |
||
| 135 | </tr> |
||
| 136 | <tr> |
||
| 137 | <td> |
||
| 138 | <div align="center"> |
||
| 139 | <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> |
||
| 140 | </div> |
||
| 141 | </td> |
||
| 142 | </tr> |
||
| 143 | </table><br></div> |
||
| 144 | <p> |
||
| 145 | <b>Important note</b>: This feature is only available if a <a href="registrant-account-charter.htm">registrant |
||
| 146 | account</a> has been assigned to you by the webmaster. |
||
| 147 | </p> |
||
| 148 | <p> |
||
| 149 | When using this feature, you agree to conform to the <a href="disclaimer.htm">terms |
||
| 150 | of use</a> of this web site. In particular, you understand that downloading, |
||
| 151 | printing or copying from this web site must be for noncommercial use |
||
| 152 | only, and must be limited to a small part of the data. Moreover, you |
||
| 153 | endeavour to inform users of your application that data are coming from |
||
| 154 | <a href="http://oid-info.com">OID-info.com</a> by hyperlinking to <a href="http://oid-info.com">http://oid-info.com</a>. |
||
| 155 | </p> |
||
| 156 | </td> |
||
| 157 | </tr> |
||
| 158 | </table> |
||
| 159 | <table cellspacing="0" cellpadding="0" border="0" width="100%"> |
||
| 160 | <tr> |
||
| 161 | <td width="10"></td> |
||
| 162 | <td> |
||
| 163 | <p> |
||
| 164 | If there is no error, the returned result is a piece of XML (resp. |
||
| 165 | JSON) which looks like the following examples. |
||
| 166 | </p> |
||
| 167 | <p> |
||
| 168 | The generated XML mostly conforms to the <a href="http://oid-info.com/oid.xsd">XML |
||
| 169 | Schema for the OID repository</a>. One difference is that the <code><strong><value></strong></code> |
||
| 170 | tag is separated in three tags: <code><strong><asn1-notation></strong></code>, |
||
| 171 | <code><strong><dot-notation></strong></code> and <code><strong><iri-notation></strong></code>. |
||
| 172 | Another main difference is that the <code><strong><oid></strong></code> |
||
| 173 | tag can have two optional attributes: |
||
| 174 | </p> |
||
| 175 | <ul> |
||
| 176 | <li> |
||
| 177 | <code><strong>category</strong></code> which, when present, takes |
||
| 178 | one or multiple ("<code>;</code>"-separated) values among "<a href="faq.htm#26"><code>Leaf |
||
| 179 | OID</code></a>", "<a href="faq.htm#26"><code>Frozen OID</code></a>", |
||
| 180 | "<code>Not allocating identifiers</code>" and "<code>Not |
||
| 181 | allocating Unicode labels</code>"; |
||
| 182 | </li> |
||
| 183 | <li> |
||
| 184 | <code><strong>standardized</strong></code> which, when present, |
||
| 185 | takes value "<code>true</code>" and indicates that the last <a href="name-forms.htm">identifier</a> |
||
| 186 | in the <strong><code><value></code></strong> can be used alone |
||
| 187 | without its associated number; |
||
| 188 | </li> |
||
| 189 | <li> |
||
| 190 | <code>last-modification</code> is the date (YYYY-MM-DD) when the |
||
| 191 | OID description was last modified in the OID repository. |
||
| 192 | </li> |
||
| 193 | </ul> |
||
| 194 | <p> |
||
| 195 | In JSON, keys <code>"category"</code>, <code>"identifier"</code>, |
||
| 196 | <code>"unicode-label"</code>, <code>"long-arc"</code> |
||
| 197 | are tables (hence between square brackets). |
||
| 198 | </p> |
||
| 199 | <table width="100%" border="1"> |
||
| 200 | <tr> |
||
| 201 | <td align="center"> |
||
| 202 | <font class="color_orange">XML</font> |
||
| 203 | </td> |
||
| 204 | </tr> |
||
| 205 | <tr> |
||
| 206 | <td> |
||
| 207 | <p> |
||
| 208 | <code><strong><oid category="</strong>Leaf OID"<strong>><br> <asn1_notation></strong>{joint-iso-itu-t(2) |
||
| 209 | 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 |
||
| 210 | conforming to the <a href="http://oid-info.com/oid.xsd">XML |
||
| 211 | Schema of the OID repository</a>.<strong></description><br> <information></strong>More information can be |
||
| 212 | found at <a href="http://oid-info.com/submit.htm">Submit |
||
| 213 | 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> |
||
| 214 | </p> |
||
| 215 | </td> |
||
| 216 | </tr> |
||
| 217 | <tr> |
||
| 218 | <td align="center"> |
||
| 219 | <font class="color_orange">JSON</font> |
||
| 220 | </td> |
||
| 221 | </tr> |
||
| 222 | <tr> |
||
| 223 | <tr> |
||
| 224 | <td> |
||
| 225 | <p> |
||
| 226 | <code><strong>{ "oid": {<br> "category": [</strong>"Leaf |
||
| 227 | OID"<strong>]</strong>,<br><strong> "asn1-notation"</strong>: |
||
| 228 | "{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": |
||
| 229 | [</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 |
||
| 230 | Schema of the OID repository</a>.<strong>",<br> "information":</strong> "More |
||
| 231 | information can be found at <a href=\"http://oid-info.com/submit.htm\">Submit |
||
| 232 | 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> |
||
| 233 | "Doe"<strong>,<br> "email":</strong> "john.doe@dummy.com"<strong>,<br> "modification-date":</strong> |
||
| 234 | "2002-05-25"<br><strong> }, <br> "first-registrant": {<br> "privacy":</strong> "true"<strong>,<br> "first-name":</strong> |
||
| 235 | "Paul"<strong>,<br> "last-name":</strong> |
||
| 236 | "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> |
||
| 237 | </p> |
||
| 238 | </td> |
||
| 239 | </tr> |
||
| 240 | </table> |
||
| 241 | </td> |
||
| 242 | </tr> |
||
| 243 | </table> |
||
| 244 | |||
| 245 | <table cellspacing="0" cellpadding="0" border="0" width="100%"> |
||
| 246 | <tr> |
||
| 247 | <td width="10"></td> |
||
| 248 | <td> |
||
| 249 | Errors are rendered as follows:<br><br><table width="100%" border="1"> |
||
| 250 | <tr> |
||
| 251 | <td align="center"> <font class="color_orange">XML</font> </td> |
||
| 252 | </tr> |
||
| 253 | <tr> |
||
| 254 | <td> |
||
| 255 | <code><strong><error code="</strong><em>error_code</em><strong>"></strong><br> Error message in English<br><strong></error></strong></code> |
||
| 256 | </td> |
||
| 257 | </tr> |
||
| 258 | <tr> |
||
| 259 | <td align="center"> <font class="color_orange">JSON</font> </td> |
||
| 260 | </tr> |
||
| 261 | <tr> |
||
| 262 | <td> |
||
| 263 | <code><strong>{ "error": {<br> "code":</strong> "<em>error_code</em><strong>",<br> "message":</strong> "Error message |
||
| 264 | in English"<br> <strong>}<br>}</strong></code> |
||
| 265 | </td> |
||
| 266 | </tr> |
||
| 267 | </table> |
||
| 268 | <br>where <code><em>error_code</em></code> is one of: |
||
| 269 | <ul> |
||
| 270 | <li> |
||
| 271 | "<code>illegal_oid</code>" when the OID given in parameter |
||
| 272 | <strong><code>oid</code></strong> cannot exist because, e.g., it is |
||
| 273 | known to be forbidden or one of its ascendant OIDs is a leaf (the |
||
| 274 | "<code>Error message in English</code>" explains what the |
||
| 275 | problem is); |
||
| 276 | </li> |
||
| 277 | <li> |
||
| 278 | "<code>maintenance</code>" when the OID repository is |
||
| 279 | not available because it is under maintenance; |
||
| 280 | </li> |
||
| 281 | <li> |
||
| 282 | "<code>oid_not_validated</code>" when the OID given in |
||
| 283 | parameter <strong><code>oid</code></strong> is described in the OID |
||
| 284 | repository but has not yet been validated by the OID administrator, |
||
| 285 | so its description is not yet publicly available; |
||
| 286 | </li> |
||
| 287 | <li> |
||
| 288 | "<code>runtime_error</code>" when there is an internal |
||
| 289 | problem (in which case the OID repository admin is automatically notified |
||
| 290 | by email); |
||
| 291 | </li> |
||
| 292 | <li> |
||
| 293 | "<code>syntax_error</code>" when the OID given in parameter |
||
| 294 | <strong><code>oid</code></strong> is not syntactiacally correct (the |
||
| 295 | "<code>Error message in English</code>" explains what the |
||
| 296 | problem is); |
||
| 297 | </li> |
||
| 298 | <li> |
||
| 299 | "<code>unknown_oid</code>" when the OID given in parameter |
||
| 300 | <strong><code>oid</code></strong> is not described in the OID repository |
||
| 301 | (or this parameter is missing); |
||
| 302 | </li> |
||
| 303 | <li> |
||
| 304 | "<code>wrong_login</code>" when parameters <strong><code>login</code></strong> |
||
| 305 | or <strong><code>password</code></strong> are not correct (the "<code>Error |
||
| 306 | message in English</code>" explains what the problem is). |
||
| 307 | </li> |
||
| 308 | </ul> |
||
| 309 | Note that the <code><em>error_code</em></code> won't change whereas the |
||
| 310 | "<code>Error message in English</code>" may evolve, so it is |
||
| 311 | recommended that, if needed, your application checks the <code><em>error_code</em></code>. |
||
| 312 | </td> |
||
| 313 | </tr> |
||
| 314 | </table> |
||
| 315 | |||
| 316 | </div> |
||
| 317 | |||
| 318 | |||
| 319 | <center id="footer"> |
||
| 320 | <img style="border: 0px solid ; width: 760px; height: 2px;" alt="separation line" src="images/separation800.png" width="760" height="2"><br><br> |
||
| 321 | <table width="710" cellspacing="0" cellpadding="0" border="0"> |
||
| 322 | <tr valign="baseline"> |
||
| 323 | <td width="34"> |
||
| 324 | <a href="/helper"> |
||
| 325 | <img src="images/enveloppe.png" width="30" height="13" name="mail" border="0" alt="OID helper"> |
||
| 326 | </a> |
||
| 327 | </td> |
||
| 328 | <td width="58" align="center"><font size="-2">Webmaster</font></td> |
||
| 329 | <td width="10" align="center"><img src="images/pointorange_small.gif" width="14" height="10"></td> |
||
| 330 | <td width="78" align="center"> |
||
| 331 | <font size="-2"> |
||
| 332 | <!--<script language="JavaScript"> |
||
| 333 | d=new Date(document.lastModified) |
||
| 334 | month=new Array("Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec") |
||
| 335 | if (Date.parse(document.lastModified) != 0) |
||
| 336 | document.write(d.getDate()+" "+month[d.getMonth()]+" "+d.getFullYear()); |
||
| 337 | </script>--> |
||
| 338 | 15 Apr 2022 |
||
| 339 | </font> |
||
| 340 | </td> |
||
| 341 | <td width="24" align="center"><img src="images/pointorange_small.gif" width="14" height="10"></td> |
||
| 342 | <td align="center" width="409"> |
||
| 343 | <font size=-1> |
||
| 344 | |||
| 345 | </font> |
||
| 346 | </td> |
||
| 347 | <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> |
||
| 348 | </tr> |
||
| 349 | </table><br> |
||
| 350 | </center> |
||
| 351 | </div> |
||
| 352 | </body> |
||
| 353 | </html> |