Differences

This shows you the differences between two versions of the page.

--- igsn:system_architecture:registration_service [2012/07/13 06:47]
jklump created
+++ igsn:system_architecture:registration_service [2013/05/03 08:57] (current)
ulbricht [API reference]
@@ Line 1: / Line 1: @@
 ====== IGSN Registry API ======
-The IGSN registration service is located at [[http://doidb.wdc-terra.de/igsn]]
+The IGSN registration service is located at [[https://doidb.wdc-terra.org/igsn]]
 ===== Architecture =====
-This API is intended to be used in programs and you will need a valid login. The account data is the same as for the web interface of [[http://doidb.wdc-terra.org/igsn]].
+This API is intended to be used in programs and you will need a valid login. The account data is the same as for the web interface of [[https://doidb.wdc-terra.org/igsn]].
 Overview
@@ Line 31: / Line 31: @@
 ===== Characters =====
+An International GeoSample Number (IGSN), is a unique string created to identify a sample object in an online environment.
-IGSN e.V. recommends that only the following characters are used within a IGSN name:
+Using [[http://tools.ietf.org/html/rfc5234|ABNF notation]] the syntax proposed syntax for an IGSN is:
-      * 0-9
+   <IGSN> = <Namespace><Code>
-  *     a-z
+   <Namespace> = mUPPER (an m character code denoting the namespace, where m = 3. Exceptions may be defined by IGSN e.V.)
-  *     A-Z
+   <Code> = nCHAR (a n character code)
-  *     - (dash)
+   UPPER                        = %x41-5A                       (A-Z)
-  *     . (dot)
+   DIGIT                        = %x30-39                       (0-9)
-  *     _ (underscore)
+   CHAR                         = UPPER / DIGIT / "-" / "."
-  *     + (plus)
+   reserved                     = ":" / "/" / "?" / "#" / "[" / "]" / "@" / "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "=" / "_" / "~"
-  *     : (colon)
-  *     / (slash)
+The [[igsn:glossary#allocating_agent|Allocating Agent]] ensures that the n-character code is unique within their [[igsn:glossary#namespace|namespaces]]. (see also IGSN [[igsn:namespaces|namespace governance]])
+Characters a-z and A-Z in the IGSN string are case insensitive (e.g. ABC is identical to AbC). It is recommended to use upper case characters in all cases.
+Characters that may be confused with digits should be avoided (I = %x49, O = %x4F, i = %x69, o = %x6F)
+The resolvable handle URI of an IGSN is made up of two components, a handle prefix 10273 and the IGSN as suffix, separated by a forward slash.
+See also [[igsn:syntax|IGSN syntax guideline]]
 ===== Security and Accounts =====
@@ Line 86: / Line 94: @@
 ====== API reference ======
+{{:igsn:system_architecture:igsn-webservice_flow.jpg?1024| Data flow during IGSN registration}}
+Data flow diagram of the IGSN registration process

DataWiki

User Tools

Site Tools

Differences

Page Tools