Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @ egi.eu.

Difference between revisions of "VT Scientific Discipline Classification API"

From EGIWiki
Jump to navigation Jump to search
Line 5: Line 5:
| bgcolor="808080" colspan="2" | <span style="color:white">Resource:
| bgcolor="808080" colspan="2" | <span style="color:white">Resource:


'''GET classification/versions/?format='''  
'''GET classification/versions/?format='''
 
 




Line 11: Line 13:
| colspan="2" | Returns a list of high-level metadata for each existing scientific classification version
| colspan="2" | Returns a list of high-level metadata for each existing scientific classification version
|-
|-
| colspan="4" | Parameter(s):
| colspan="4" | '''Parameter(s):'''
|-
|-
| bgcolor="D3D3D3" | Query Parameter  
| bgcolor="D3D3D3" | Query Parameter  
Line 23: Line 25:
| Response's format
| Response's format
|-
|-
| colspan="4" | Example response (in pseudo-XML format):
| colspan="4" | '''Example response (in pseudo-XML format):'''
|-
|-
| bgcolor="D3D3D3" colspan="4" | appdb:appdb  
| bgcolor="D3D3D3" colspan="4" | &lt;appdb:appdb&gt;
  &lt;classification:version id="1" version="1.1" createdon="..." publishedon="..." archivedon="..." state="archived"/&gt;
  &lt;classification:version id="1" version="1.1" createdon="..." publishedon="..." archivedon="..." state="archived"/&gt;
  &lt;classification:version id="2" version="1.2" createdon="..." publishedon="..." archivedon="..." state="archived"/&gt;
  &lt;classification:version id="2" version="1.2" createdon="..." publishedon="..." archivedon="..." state="archived"/&gt;
Line 37: Line 39:


|-
|-
| colspan="4" | Response details
| colspan="4" | '''Response details:'''
|-
|-
| bgcolor="D3D3D3" | Element  
| bgcolor="D3D3D3" | Element  
Line 82: Line 84:
| bgcolor="808080" colspan="2" | <span style="color:white">Resource:
| bgcolor="808080" colspan="2" | <span style="color:white">Resource:


'''GET classification/version/:id/?format='''
'''GET classification/version/:id/?format='''
 




Line 93: Line 94:
| colspan="2" | Returns the full metadata of a specific (:id) scientific classification version
| colspan="2" | Returns the full metadata of a specific (:id) scientific classification version
|-
|-
| colspan="4" | Parameter(s):
| colspan="4" | '''Parameter(s):'''
|-
|-
| bgcolor="D3D3D3" | Segment Parameters  
| bgcolor="D3D3D3" | Segment Parameters  
Line 115: Line 116:
| Response's format
| Response's format
|-
|-
| colspan="4" | Example response (in pseudo-XML format):
| colspan="4" | '''Example response (in pseudo-XML format):'''
|-
|-
| bgcolor="D3D3D3" colspan="4" | appdb:appdb  
| bgcolor="D3D3D3" colspan="4" | &lt;appdb:appdb&gt;
&lt;classification:version id="6" version="2.1" createdon="..." publishedon="..." archivedon="..." state="stable"&gt;
&lt;classification:version id="6" version="2.1" createdon="..." publishedon="..." archivedon="..." state="stable"&gt; &lt;classification:discipline id="1078" parentid="1138" order="1" value="Level2"/&gt; &lt;classification:discipline id="1079" parentid="1138" order="2" value="Level2"/&gt; &lt;classification:discipline id="1047" parentid="1138" order="3" value="Level2"/&gt; &lt;classification:discipline id="1139" parentid="1201" order="2" value="Level2"/&gt; &lt;classification:discipline id="1080" parentid="1201" order="1" value="Level2"/&gt; &lt;classification:discipline id="1138" parentid="1252" order="1" value="Level1"/&gt; &lt;classification:discipline id="1201" parentid="1252" order="2" value="Level1"/&gt; &lt;classification:discipline id="1252" parentid="0" order="1" value="Level0"/&gt; .................................  
&lt;classification:discipline id="1078" parentid="1138" order="1" value="Level2"/&gt; &lt;classification:discipline id="1079" parentid="1138" order="2" value="Level2"/&gt; &lt;classification:discipline id="1047" parentid="1138" order="3" value="Level2"/&gt; &lt;classification:discipline id="1139" parentid="1201" order="2" value="Level2"/&gt; &lt;classification:discipline id="1080" parentid="1201" order="1" value="Level2"/&gt; &lt;classification:discipline id="1138" parentid="1252" order="1" value="Level1"/&gt; &lt;classification:discipline id="1201" parentid="1252" order="2" value="Level1"/&gt; &lt;classification:discipline id="1252" parentid="0" order="1" value="Level0"/&gt; .................................  


   &lt;/classification:version&gt;
   &lt;/classification:version&gt;
Line 126: Line 126:


|-
|-
| colspan="4" | Response details:
| colspan="4" | '''Response details:'''
|-
|-
| bgcolor="D3D3D3" | Element  
| bgcolor="D3D3D3" | Element  

Revision as of 15:34, 18 December 2013

VT Scientific Discipline Classification: Home Scientific Disciplines Change Management Query API Tasks/Actions/Plans Meetings
Resource:

GET classification/versions/?format=



Returns a list of high-level metadata for each existing scientific classification version
Parameter(s):
Query Parameter Type Optional Description
format ENUM ('xml', 'json')
Default: 'xml'
Yes Response's format
Example response (in pseudo-XML format):
<appdb:appdb>
<classification:version id="1" version="1.1" createdon="..." publishedon="..." archivedon="..." state="archived"/>
<classification:version id="2" version="1.2" createdon="..." publishedon="..." archivedon="..." state="archived"/>
<classification:version id="3" version="1.3" createdon="..." publishedon="..." archivedon="..." state="archived"/>
<classification:version id="4" version="2.0" createdon="..." publishedon="..." archivedon="..." state="archived"/>
<classification:version id="5" version="2.1" createdon="..." publishedon="..." archivedon="..." state="stable"/>
<classification:version id="6" version="2.2" createdon="..." publishedon="..." archivedon="..." state="under-devel"/>
.................................

</appdb:appdb>

Response details:
Element Attribute Type Description
classification:version id

Integer
String
Datetime
Datetime
A unique version id.
version String The version tag.
createdon Datetime Version creation date-time.
publishedon Datetime Version publication date-time. This attribute appears only if the state of the given version becomes 'stable'.
archivedon Datetime
state ENUM('stable', 'under-devel', 'archived')

'stable': indicates the stable/production-grade scientific classification version.

'under-devel': indicates a version that is under development

'archived': older versions

Resource:

GET classification/version/:id/?format=




Returns the full metadata of a specific (:id) scientific classification version
Parameter(s):
Segment Parameters Type Optional Description
id Integer No A specific version id.
Query Parameters Type Optional Description
format ENUM ('xml', 'json')
Default: 'xml'
Yes Response's format
Example response (in pseudo-XML format):
<appdb:appdb>

<classification:version id="6" version="2.1" createdon="..." publishedon="..." archivedon="..." state="stable"> <classification:discipline id="1078" parentid="1138" order="1" value="Level2"/> <classification:discipline id="1079" parentid="1138" order="2" value="Level2"/> <classification:discipline id="1047" parentid="1138" order="3" value="Level2"/> <classification:discipline id="1139" parentid="1201" order="2" value="Level2"/> <classification:discipline id="1080" parentid="1201" order="1" value="Level2"/> <classification:discipline id="1138" parentid="1252" order="1" value="Level1"/> <classification:discipline id="1201" parentid="1252" order="2" value="Level1"/> <classification:discipline id="1252" parentid="0" order="1" value="Level0"/> .................................

 </classification:version>

</appdb:appdb>

Response details:
Element Attribute Type Description
classification:version id integer A unique version id.
version String The version tag.
createdon Datetime Version creation date-time.
publishedon Datetime Version publication date-time. This attribute appears only if the state of the given version becomes 'stable'.
archivedon Datetime Version archival date-time. This attribute appears only if the state of the given version becomes 'archived'.
state ENUM('stable', 'under-level', 'stable') 'stable': indicates the stable/production-grade scientific classification version.
'under-level': indicates a version that is under development.
'archived': older versions.
classification:discipline id Integer The discipline unique id.
parentid Integer The parent discipline unique id. '0' indicates a top-level discipline.
order Integer An integer that defines the order of the given discipline within the tree branch.
value String The discipline name/title.