Subversion Repositories oidinfo_new_design

Rev

Rev 2 | Only display areas with differences | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 2 Rev 17
1
<div id="global_content">
1
<div id="global_content">
2
 
2
 
3
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
3
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
4
 
4
 
5
                <tr>
5
                <tr>
6
 
6
 
7
                        <td height="20" colspan="3" valign="top" width="100%">&nbsp;</td>
7
                        <td height="20" colspan="3" valign="top" width="100%">&nbsp;</td>
8
 
8
 
9
                </tr>
9
                </tr>
10
 
10
 
11
                <tr>
11
                <tr>
12
                        <td height="40" valign="top" width="440">
12
                        <td height="40" valign="top" width="440">
13
                                <p>
13
                                <p>
14
                                        <span class="page_title">Getting an OID description in XML or JSON format</span>
14
                                        <span class="page_title">Getting an OID description in XML or JSON format</span>
15
                                </p>
15
                                </p>
16
                        </td>
16
                        </td>
17
                        <td height="40" valign="top" width="20">&nbsp;</td>
17
                        <td height="40" valign="top" width="20">&nbsp;</td>
18
                        <td width="150" height="40" valign="middle">
18
                        <td width="150" height="40" valign="middle">
19
                                <img src="images/bullet.gif" width="10" height="8" border="0"><a href="/cgi-bin/manage?a=ca">Request a registrant account</a>
19
                                <img src="images/bullet.gif" width="10" height="8" border="0"><a href="/cgi-bin/manage?a=ca">Request a registrant account</a>
20
                        </td>
20
                        </td>
21
                </tr>
21
                </tr>
22
 
22
 
23
        </table>
23
        </table>
24
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
24
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
25
                <tr>
25
                <tr>
26
                        <td width="10"></td>
26
                        <td width="10"></td>
27
                        <td>
27
                        <td>
28
 
28
 
29
                                <p>
29
                                <p>
30
                                        To get the description of an OID in XML or JSON format, use the following
30
                                        To get the description of an OID in XML or JSON format, use the following
31
                                        URL (as a <code>GET</code> or <code>POST</code> <a href="http://www.w3schools.com/TAGs/ref_httpmethods.asp">HTTP
31
                                        URL (as a <code>GET</code> or <code>POST</code> <a href="http://www.w3schools.com/TAGs/ref_httpmethods.asp">HTTP
32
                                                request method</a>):
32
                                                request method</a>):
33
                                </p>
33
                                </p>
34
                                <div align="center">
34
                                <div align="center">
35
                                        <table width="75%" border="1">
35
                                        <table width="75%" border="1">
36
                                                <tr>
36
                                                <tr>
37
                                                        <td align="center">
37
                                                        <td align="center">
38
                                                                <div align="center"><font class="color_orange">XML</font> </div>
38
                                                                <div align="center"><font class="color_orange">XML</font> </div>
39
                                                        </td>
39
                                                        </td>
40
                                                </tr>
40
                                                </tr>
41
                                                <tr>
41
                                                <tr>
42
                                                        <td>
42
                                                        <td>
43
                                                                <div align="center">
43
                                                                <div align="center">
44
                                                                        <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>
44
                                                                        <code><strong>https://oid-rep.orange-labs.fr/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>
45
                                                                </div>
45
                                                                </div>
46
                                                        </td>
46
                                                        </td>
47
                                                </tr>
47
                                                </tr>
48
                                                <tr>
48
                                                <tr>
49
                                                        <td align="center">
49
                                                        <td align="center">
50
                                                                <div align="center"><font class="color_orange">JSON</font> </div>
50
                                                                <div align="center"><font class="color_orange">JSON</font> </div>
51
                                                        </td>
51
                                                        </td>
52
                                                </tr>
52
                                                </tr>
53
                                                <tr>
53
                                                <tr>
54
                                                        <td>
54
                                                        <td>
55
                                                                <div align="center">
55
                                                                <div align="center">
56
                                                                        <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>
56
                                                                        <code><strong>https://oid-rep.orange-labs.fr/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>
57
                                                                </div>
57
                                                                </div>
58
                                                        </td>
58
                                                        </td>
59
                                                </tr>
59
                                                </tr>
60
                                        </table><br></div>
60
                                        </table><br></div>
61
                                <p>
61
                                <p>
62
                                        <b>Important note</b>: This feature is only available if a <a href="registrant-account-charter.htm">registrant
62
                                        <b>Important note</b>: This feature is only available if a <a href="registrant-account-charter.htm">registrant
63
                                                account</a> has been assigned to you by the webmaster.
63
                                                account</a> has been assigned to you by the webmaster.
64
                                </p>
64
                                </p>
65
                                <p>
65
                                <p>
66
                                        When using this feature, you agree to conform to the <a href="disclaimer.htm">terms
66
                                        When using this feature, you agree to conform to the <a href="disclaimer.htm">terms
67
                                                of use</a> of this web site. In particular, you understand that downloading,
67
                                                of use</a> of this web site. In particular, you understand that downloading,
68
                                        printing or copying from this web site must be for noncommercial use
68
                                        printing or copying from this web site must be for noncommercial use
69
                                        only, and must be limited to a small part of the data. Moreover, you
69
                                        only, and must be limited to a small part of the data. Moreover, you
70
                                        endeavour to inform users of your application that data are coming from
70
                                        endeavour to inform users of your application that data are coming from
71
                                        <a href="http://oid-info.com">OID-info.com</a> by hyperlinking to <a href="http://oid-info.com">http://oid-info.com</a>.
71
                                        <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>
-
 
72
                                        or <a href="https://oid-rep.orange-labs.fr">https://oid-rep.orange-labs.fr</a>.
72
                                </p>
73
                                </p>
73
                        </td>
74
                        </td>
74
                </tr>
75
                </tr>
75
        </table>
76
        </table>
76
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
77
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
77
                <tr>
78
                <tr>
78
                        <td width="10"></td>
79
                        <td width="10"></td>
79
                        <td>
80
                        <td>
80
                                <p>
81
                                <p>
81
                                        If there is no error, the returned result is a piece of XML (resp.
82
                                        If there is no error, the returned result is a piece of XML (resp.
82
                                        JSON) which looks like the following examples.
83
                                        JSON) which looks like the following examples.
83
                                </p>
84
                                </p>
84
                                <p>
85
                                <p>
85
                                        The generated XML mostly conforms to the <a href="http://oid-info.com/oid.xsd">XML
86
                                        The generated XML mostly conforms to the <a href="http://oid-info.com/oid.xsd">XML
86
                                                Schema for the OID repository</a>. One difference is that the <code><strong>&lt;value&gt;</strong></code>
87
                                                Schema for the OID repository</a>. One difference is that the <code><strong>&lt;value&gt;</strong></code>
87
                                        tag is separated in three tags: <code><strong>&lt;asn1-notation&gt;</strong></code>,
88
                                        tag is separated in three tags: <code><strong>&lt;asn1-notation&gt;</strong></code>,
88
                                        <code><strong>&lt;dot-notation&gt;</strong></code> and <code><strong>&lt;iri-notation&gt;</strong></code>.
89
                                        <code><strong>&lt;dot-notation&gt;</strong></code> and <code><strong>&lt;iri-notation&gt;</strong></code>.
89
                                        Another main difference is that the <code><strong>&lt;oid&gt;</strong></code>
90
                                        Another main difference is that the <code><strong>&lt;oid&gt;</strong></code>
90
                                        tag can have two optional attributes:
91
                                        tag can have two optional attributes:
91
                                </p>
92
                                </p>
92
                                <ul>
93
                                <ul>
93
                                        <li>
94
                                        <li>
94
                                                <code><strong>category</strong></code> which, when present, takes
95
                                                <code><strong>category</strong></code> which, when present, takes
95
                                                one or multiple ("<code>;</code>"-separated) values among &quot;<a href="faq.htm#26"><code>Leaf
96
                                                one or multiple ("<code>;</code>"-separated) values among &quot;<a href="faq.htm#26"><code>Leaf
96
                                                                OID</code></a>&quot;, &quot;<a href="faq.htm#26"><code>Frozen OID</code></a>&quot;,
97
                                                                OID</code></a>&quot;, &quot;<a href="faq.htm#26"><code>Frozen OID</code></a>&quot;,
97
                                                &quot;<code>Not allocating identifiers</code>&quot; and &quot;<code>Not
98
                                                &quot;<code>Not allocating identifiers</code>&quot; and &quot;<code>Not
98
                                                        allocating Unicode labels</code>&quot;;
99
                                                        allocating Unicode labels</code>&quot;;
99
                                        </li>
100
                                        </li>
100
                                        <li>
101
                                        <li>
101
                                                <code><strong>standardized</strong></code> which, when present,
102
                                                <code><strong>standardized</strong></code> which, when present,
102
                                                takes value "<code>true</code>" and indicates that the last <a href="name-forms.htm">identifier</a>
103
                                                takes value "<code>true</code>" and indicates that the last <a href="name-forms.htm">identifier</a>
103
                                                in the <strong><code>&lt;value&gt;</code></strong> can be used alone
104
                                                in the <strong><code>&lt;value&gt;</code></strong> can be used alone
104
                                                without its associated number;
105
                                                without its associated number;
105
                                        </li>
106
                                        </li>
106
                                        <li>
107
                                        <li>
107
                                                <code>last-modification</code> is the date (YYYY-MM-DD) when the
108
                                                <code>last-modification</code> is the date (YYYY-MM-DD) when the
108
                                                OID description was last modified in the OID repository.
109
                                                OID description was last modified in the OID repository.
109
                                        </li>
110
                                        </li>
110
                                </ul>
111
                                </ul>
111
                                <p>
112
                                <p>
112
                                        In JSON, keys <code>&quot;category&quot;</code>, <code>&quot;identifier&quot;</code>,
113
                                        In JSON, keys <code>&quot;category&quot;</code>, <code>&quot;identifier&quot;</code>,
113
                                        <code>&quot;unicode-label&quot;</code>, <code>&quot;long-arc&quot;</code>
114
                                        <code>&quot;unicode-label&quot;</code>, <code>&quot;long-arc&quot;</code>
114
                                        are tables (hence between square brackets).
115
                                        are tables (hence between square brackets).
115
                                </p>
116
                                </p>
116
                                <table width="100%" border="1">
117
                                <table width="100%" border="1">
117
                                        <tr>
118
                                        <tr>
118
                                                <td align="center">
119
                                                <td align="center">
119
                                                        <font class="color_orange">XML</font>
120
                                                        <font class="color_orange">XML</font>
120
                                                </td>
121
                                                </td>
121
                                        </tr>
122
                                        </tr>
122
                                        <tr>
123
                                        <tr>
123
                                                <td>
124
                                                <td>
124
                                                        <p>
125
                                                        <p>
125
                                                                <code><strong>&lt;oid category=&quot;</strong>Leaf OID&quot;<strong>&gt;<br>&nbsp;&nbsp;&lt;asn1_notation&gt;</strong>{joint-iso-itu-t(2)
126
                                                                <code><strong>&lt;oid category=&quot;</strong>Leaf OID&quot;<strong>&gt;<br>&nbsp;&nbsp;&lt;asn1_notation&gt;</strong>{joint-iso-itu-t(2)
126
                                                                        example(999) xml-submission(777)}<strong>&lt;/asn1_notation&gt;<br>&nbsp;&nbsp;&lt;dot-notation&gt;</strong>2.999.777<strong>&lt;/dot-notation&gt;<br>&nbsp;&nbsp;&lt;iri-notation&gt;</strong>/Joint-ISO-ITU-T/Example/XML_submission<strong>&lt;/iri-notation&gt;<br>&nbsp;&nbsp;&lt;identifier&gt;</strong>xml-submission<strong>&lt;/identifier&gt;<br>&nbsp;&nbsp;</strong><strong>&lt;identifier&gt;</strong>xml-document<strong>&lt;/identifier&gt;<br>&nbsp;&nbsp;&lt;unicode-label&gt;</strong>XML_submission<strong>&lt;/unicode-label&gt;<br>&nbsp;&nbsp;&lt;description&gt;</strong>Example of a description
127
                                                                        example(999) xml-submission(777)}<strong>&lt;/asn1_notation&gt;<br>&nbsp;&nbsp;&lt;dot-notation&gt;</strong>2.999.777<strong>&lt;/dot-notation&gt;<br>&nbsp;&nbsp;&lt;iri-notation&gt;</strong>/Joint-ISO-ITU-T/Example/XML_submission<strong>&lt;/iri-notation&gt;<br>&nbsp;&nbsp;&lt;identifier&gt;</strong>xml-submission<strong>&lt;/identifier&gt;<br>&nbsp;&nbsp;</strong><strong>&lt;identifier&gt;</strong>xml-document<strong>&lt;/identifier&gt;<br>&nbsp;&nbsp;&lt;unicode-label&gt;</strong>XML_submission<strong>&lt;/unicode-label&gt;<br>&nbsp;&nbsp;&lt;description&gt;</strong>Example of a description
127
                                                                        conforming to the &lt;a href="http://oid-info.com/oid.xsd"&gt;XML
128
                                                                        conforming to the &lt;a href="http://oid-info.com/oid.xsd"&gt;XML
128
                                                                        Schema of the OID repository&lt;/a&gt;.<strong>&lt;/description&gt;<br>&nbsp;&nbsp;&lt;information&gt;</strong>More information can be
129
                                                                        Schema of the OID repository&lt;/a&gt;.<strong>&lt;/description&gt;<br>&nbsp;&nbsp;&lt;information&gt;</strong>More information can be
129
                                                                        found at &lt;a href="http://oid-info.com/submit.htm"&gt;Submit
130
                                                                        found at &lt;a href="http://oid-info.com/submit.htm"&gt;Submit
130
                                                                        OID descriptions as XML files&lt;/a&gt;.<strong>&lt;/information&gt;<br>&nbsp;&nbsp;&lt;current-registrant&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;</strong><strong>&lt;first-name&gt;</strong>John<strong>&lt;/first-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;last-name&gt;</strong>Doe<strong>&lt;/last-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;email&gt;</strong>john.doe@dummy.com<strong>&lt;/email&gt;<br>&nbsp;&nbsp;&nbsp; &lt;modification-date&gt;</strong>2002-05-25<strong>&lt;/modification-date&gt;<br>&nbsp; &lt;/current-registrant&gt;<br>&nbsp; &lt;first-registrant privacy=&quot;</strong>true<strong>&quot;&gt;<br>&nbsp;&nbsp;&nbsp; &lt;first-name&gt;</strong>Paul<strong>&lt;/first-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;last-name&gt;</strong>Connor<strong>&lt;/last-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;email&gt;</strong>paul.connor@myhost.com<strong>&lt;/email&gt;<br>&nbsp;&nbsp;&nbsp; &lt;creation-date&gt;</strong>1999-12-31<strong>&lt;/creation-date&gt;<br>&nbsp; &lt;/first-registrant&gt;<br>&nbsp;&nbsp;&lt;last-modification&gt;</strong>2017-05-23<strong>&lt;/last-modification&gt;<br>&lt;/oid&gt;</strong></code>
131
                                                                        OID descriptions as XML files&lt;/a&gt;.<strong>&lt;/information&gt;<br>&nbsp;&nbsp;&lt;current-registrant&gt;<br>&nbsp;&nbsp;&nbsp;&nbsp;</strong><strong>&lt;first-name&gt;</strong>John<strong>&lt;/first-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;last-name&gt;</strong>Doe<strong>&lt;/last-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;email&gt;</strong>john.doe@dummy.com<strong>&lt;/email&gt;<br>&nbsp;&nbsp;&nbsp; &lt;modification-date&gt;</strong>2002-05-25<strong>&lt;/modification-date&gt;<br>&nbsp; &lt;/current-registrant&gt;<br>&nbsp; &lt;first-registrant privacy=&quot;</strong>true<strong>&quot;&gt;<br>&nbsp;&nbsp;&nbsp; &lt;first-name&gt;</strong>Paul<strong>&lt;/first-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;last-name&gt;</strong>Connor<strong>&lt;/last-name&gt;<br>&nbsp;&nbsp;&nbsp; &lt;email&gt;</strong>paul.connor@myhost.com<strong>&lt;/email&gt;<br>&nbsp;&nbsp;&nbsp; &lt;creation-date&gt;</strong>1999-12-31<strong>&lt;/creation-date&gt;<br>&nbsp; &lt;/first-registrant&gt;<br>&nbsp;&nbsp;&lt;last-modification&gt;</strong>2017-05-23<strong>&lt;/last-modification&gt;<br>&lt;/oid&gt;</strong></code>
131
                                                        </p>
132
                                                        </p>
132
                                                </td>
133
                                                </td>
133
                                        </tr>
134
                                        </tr>
134
                                        <tr>
135
                                        <tr>
135
                                                <td align="center">
136
                                                <td align="center">
136
                                                        <font class="color_orange">JSON</font>
137
                                                        <font class="color_orange">JSON</font>
137
                                                </td>
138
                                                </td>
138
                                        </tr>
139
                                        </tr>
139
                                        <tr>
140
                                        <tr>
140
                                        <tr>
141
                                        <tr>
141
                                                <td>
142
                                                <td>
142
                                                        <p>
143
                                                        <p>
143
                                                                <code><strong>{ &quot;oid&quot;: {<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;category&quot;: [</strong>&quot;Leaf
144
                                                                <code><strong>{ &quot;oid&quot;: {<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;category&quot;: [</strong>&quot;Leaf
144
                                                                        OID&quot;<strong>]</strong>,<br><strong>&nbsp;&nbsp;&nbsp;&nbsp;&quot;asn1-notation&quot;</strong>:
145
                                                                        OID&quot;<strong>]</strong>,<br><strong>&nbsp;&nbsp;&nbsp;&nbsp;&quot;asn1-notation&quot;</strong>:
145
                                                                        &quot;{joint-iso-itu-t(2) example(999) xml-submission(777)}<strong>&quot;,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;dot-notation&quot;</strong>: &quot;2.999.777<strong>&quot;,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;iri-notation&quot;</strong>: &quot;/Joint-ISO-ITU-T/Example/XML_submission<strong>&quot;,<br></strong><strong>&nbsp;&nbsp;&nbsp;&nbsp;&quot;identifier&quot;:
146
                                                                        &quot;{joint-iso-itu-t(2) example(999) xml-submission(777)}<strong>&quot;,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;dot-notation&quot;</strong>: &quot;2.999.777<strong>&quot;,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;iri-notation&quot;</strong>: &quot;/Joint-ISO-ITU-T/Example/XML_submission<strong>&quot;,<br></strong><strong>&nbsp;&nbsp;&nbsp;&nbsp;&quot;identifier&quot;:
146
                                                                                [</strong>&quot;xml-submission&quot;, &quot;xml-document&quot;<strong>]</strong>,<br><strong>&nbsp;&nbsp;&nbsp;&nbsp;&quot;unicode-label&quot;: [</strong>&quot;XML_submission&quot;<strong>]</strong>,<br><strong>&nbsp;&nbsp;</strong></code><strong><code><strong>&nbsp;&nbsp;</strong>&quot;description&quot;:</code></strong><code>&quot;Example of a description conforming to the &lt;a href=\"http://oid-info.com/oid.xsd\"&gt;XML
147
                                                                                [</strong>&quot;xml-submission&quot;, &quot;xml-document&quot;<strong>]</strong>,<br><strong>&nbsp;&nbsp;&nbsp;&nbsp;&quot;unicode-label&quot;: [</strong>&quot;XML_submission&quot;<strong>]</strong>,<br><strong>&nbsp;&nbsp;</strong></code><strong><code><strong>&nbsp;&nbsp;</strong>&quot;description&quot;:</code></strong><code>&quot;Example of a description conforming to the &lt;a href=\"http://oid-info.com/oid.xsd\"&gt;XML
147
                                                                        Schema of the OID repository&lt;/a&gt;.<strong>&quot;,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;information&quot;:</strong> &quot;More
148
                                                                        Schema of the OID repository&lt;/a&gt;.<strong>&quot;,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;information&quot;:</strong> &quot;More
148
                                                                        information can be found at &lt;a href=\"http://oid-info.com/submit.htm\"&gt;Submit
149
                                                                        information can be found at &lt;a href=\"http://oid-info.com/submit.htm\"&gt;Submit
149
                                                                        OID descriptions as XML files&lt;/a&gt;.&quot;<strong>,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;current-registrant&quot;: {<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</strong></code><strong><code>&quot;first-name&quot;:</code></strong><code>&quot;John<strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;last-name&quot;:</strong>
150
                                                                        OID descriptions as XML files&lt;/a&gt;.&quot;<strong>,<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;current-registrant&quot;: {<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</strong></code><strong><code>&quot;first-name&quot;:</code></strong><code>&quot;John<strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;last-name&quot;:</strong>
150
                                                                        &quot;Doe&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;email&quot;:</strong> &quot;john.doe@dummy.com&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;modification-date&quot;:</strong>
151
                                                                        &quot;Doe&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;email&quot;:</strong> &quot;john.doe@dummy.com&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;modification-date&quot;:</strong>
151
                                                                        &quot;2002-05-25&quot;<br><strong>&nbsp;&nbsp;&nbsp;&nbsp;}, <br>&nbsp; &nbsp;&nbsp;&quot;first-registrant&quot;: {<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;privacy&quot;:</strong> &quot;true&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;first-name&quot;:</strong>
152
                                                                        &quot;2002-05-25&quot;<br><strong>&nbsp;&nbsp;&nbsp;&nbsp;}, <br>&nbsp; &nbsp;&nbsp;&quot;first-registrant&quot;: {<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;privacy&quot;:</strong> &quot;true&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;first-name&quot;:</strong>
152
                                                                        &quot;Paul&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;last-name&quot;:</strong>
153
                                                                        &quot;Paul&quot;<strong>,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;last-name&quot;:</strong>
153
                                                                        &quot;Connor<strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;email&quot;: &quot;</strong>paul.connor@myhost.com<strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;creation-date&quot;: &quot;</strong>1999-12-31&quot;<strong><br>&nbsp; &nbsp;&nbsp;},<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;last-modification&quot;:</strong> &quot;2017-05-23&quot;<br>&nbsp;&nbsp;}<br>}</code>
154
                                                                        &quot;Connor<strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;email&quot;: &quot;</strong>paul.connor@myhost.com<strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&quot;creation-date&quot;: &quot;</strong>1999-12-31&quot;<strong><br>&nbsp; &nbsp;&nbsp;},<br>&nbsp;&nbsp;&nbsp;&nbsp;&quot;last-modification&quot;:</strong> &quot;2017-05-23&quot;<br>&nbsp;&nbsp;}<br>}</code>
154
                                                        </p>
155
                                                        </p>
155
                                                </td>
156
                                                </td>
156
                                        </tr>
157
                                        </tr>
157
                                </table>
158
                                </table>
158
                        </td>
159
                        </td>
159
                </tr>
160
                </tr>
160
        </table>
161
        </table>
161
 
162
 
162
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
163
        <table cellspacing="0" cellpadding="0" border="0" width="100%">
163
                <tr>
164
                <tr>
164
                        <td width="10"></td>
165
                        <td width="10"></td>
165
                        <td>
166
                        <td>
166
                                Errors are rendered as follows:<br><br><table width="100%" border="1">
167
                                Errors are rendered as follows:<br><br><table width="100%" border="1">
167
                                        <tr>
168
                                        <tr>
168
                                                <td align="center"> <font class="color_orange">XML</font> </td>
169
                                                <td align="center"> <font class="color_orange">XML</font> </td>
169
                                        </tr>
170
                                        </tr>
170
                                        <tr>
171
                                        <tr>
171
                                                <td>
172
                                                <td>
172
                                                        <code><strong>&lt;error code=&quot;</strong><em>error_code</em><strong>&quot;&gt;</strong><br>&nbsp;&nbsp;Error message in English<br><strong>&lt;/error&gt;</strong></code>
173
                                                        <code><strong>&lt;error code=&quot;</strong><em>error_code</em><strong>&quot;&gt;</strong><br>&nbsp;&nbsp;Error message in English<br><strong>&lt;/error&gt;</strong></code>
173
                                                </td>
174
                                                </td>
174
                                        </tr>
175
                                        </tr>
175
                                        <tr>
176
                                        <tr>
176
                                                <td align="center"> <font class="color_orange">JSON</font> </td>
177
                                                <td align="center"> <font class="color_orange">JSON</font> </td>
177
                                        </tr>
178
                                        </tr>
178
                                        <tr>
179
                                        <tr>
179
                                                <td>
180
                                                <td>
180
                                                        <code><strong>{ &quot;error&quot;: {<br>&nbsp;&nbsp;&nbsp; &quot;code&quot;:</strong> &quot;<em>error_code</em><strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &quot;message&quot;:</strong> &quot;Error message
181
                                                        <code><strong>{ &quot;error&quot;: {<br>&nbsp;&nbsp;&nbsp; &quot;code&quot;:</strong> &quot;<em>error_code</em><strong>&quot;,<br>&nbsp;&nbsp;&nbsp; &quot;message&quot;:</strong> &quot;Error message
181
                                                                in English&quot;<br>&nbsp;&nbsp;<strong>}<br>}</strong></code>
182
                                                                in English&quot;<br>&nbsp;&nbsp;<strong>}<br>}</strong></code>
182
                                                </td>
183
                                                </td>
183
                                        </tr>
184
                                        </tr>
184
                                </table>
185
                                </table>
185
                                <br>where <code><em>error_code</em></code> is one of:
186
                                <br>where <code><em>error_code</em></code> is one of:
186
                                <ul>
187
                                <ul>
187
                                        <li>
188
                                        <li>
188
                                                &quot;<code>illegal_oid</code>&quot; when the OID given in parameter
189
                                                &quot;<code>illegal_oid</code>&quot; when the OID given in parameter
189
                                                <strong><code>oid</code></strong> cannot exist because, e.g., it is
190
                                                <strong><code>oid</code></strong> cannot exist because, e.g., it is
190
                                                known to be forbidden or one of its ascendant OIDs is a leaf (the
191
                                                known to be forbidden or one of its ascendant OIDs is a leaf (the
191
                                                &quot;<code>Error message in English</code>&quot; explains what the
192
                                                &quot;<code>Error message in English</code>&quot; explains what the
192
                                                problem is);
193
                                                problem is);
193
                                        </li>
194
                                        </li>
194
                                        <li>
195
                                        <li>
195
                                                &quot;<code>maintenance</code>&quot; when the OID repository is
196
                                                &quot;<code>maintenance</code>&quot; when the OID repository is
196
                                                not available because it is under maintenance;
197
                                                not available because it is under maintenance;
197
                                        </li>
198
                                        </li>
198
                                        <li>
199
                                        <li>
199
                                                &quot;<code>oid_not_validated</code>&quot; when the OID given in
200
                                                &quot;<code>oid_not_validated</code>&quot; when the OID given in
200
                                                parameter <strong><code>oid</code></strong> is described in the OID
201
                                                parameter <strong><code>oid</code></strong> is described in the OID
201
                                                repository but has not yet been validated by the OID administrator,
202
                                                repository but has not yet been validated by the OID administrator,
202
                                                so its description is not yet publicly available;
203
                                                so its description is not yet publicly available;
203
                                        </li>
204
                                        </li>
204
                                        <li>
205
                                        <li>
205
                                                &quot;<code>runtime_error</code>&quot; when there is an internal
206
                                                &quot;<code>runtime_error</code>&quot; when there is an internal
206
                                                problem (in which case the OID repository admin is automatically notified
207
                                                problem (in which case the OID repository admin is automatically notified
207
                                                by email);
208
                                                by email);
208
                                        </li>
209
                                        </li>
209
                                        <li>
210
                                        <li>
210
                                                &quot;<code>syntax_error</code>&quot; when the OID given in parameter
211
                                                &quot;<code>syntax_error</code>&quot; when the OID given in parameter
211
                                                <strong><code>oid</code></strong> is not syntactiacally correct (the
212
                                                <strong><code>oid</code></strong> is not syntactiacally correct (the
212
                                                &quot;<code>Error message in English</code>&quot; explains what the
213
                                                &quot;<code>Error message in English</code>&quot; explains what the
213
                                                problem is);
214
                                                problem is);
214
                                        </li>
215
                                        </li>
215
                                        <li>
216
                                        <li>
216
                                                &quot;<code>unknown_oid</code>&quot; when the OID given in parameter
217
                                                &quot;<code>unknown_oid</code>&quot; when the OID given in parameter
217
                                                <strong><code>oid</code></strong> is not described in the OID repository
218
                                                <strong><code>oid</code></strong> is not described in the OID repository
218
                                                (or this parameter is missing);
219
                                                (or this parameter is missing);
219
                                        </li>
220
                                        </li>
220
                                        <li>
221
                                        <li>
221
                                                &quot;<code>wrong_login</code>&quot; when parameters <strong><code>login</code></strong>
222
                                                &quot;<code>wrong_login</code>&quot; when parameters <strong><code>login</code></strong>
222
                                                or <strong><code>password</code></strong> are not correct (the &quot;<code>Error
223
                                                or <strong><code>password</code></strong> are not correct (the &quot;<code>Error
223
                                                        message in English</code>&quot; explains what the problem is).
224
                                                        message in English</code>&quot; explains what the problem is).
224
                                        </li>
225
                                        </li>
225
                                </ul>
226
                                </ul>
226
                                Note that the <code><em>error_code</em></code> won't change whereas the
227
                                Note that the <code><em>error_code</em></code> won't change whereas the
227
                                &quot;<code>Error message in English</code>&quot; may evolve, so it is
228
                                &quot;<code>Error message in English</code>&quot; may evolve, so it is
228
                                recommended that, if needed, your application checks the <code><em>error_code</em></code>.
229
                                recommended that, if needed, your application checks the <code><em>error_code</em></code>.
229
                        </td>
230
                        </td>
230
                </tr>
231
                </tr>
231
        </table>
232
        </table>
232
 
233
 
233
</div>
234
</div>
234
 
235