Back to top

WURCSFramework API

Welcome to WURCSFramework API!

Release Notes

The future date represents the release schedule.

Update August 1, 2021

  • Initial release of WURCSFramework API.

Support

Please contact the server administrator with any questions or problems, support@glyconavi.org.

WURCSFramework 1.0.1

WURCSFramework version 1.0.1 related APIs.

WURCS Version 1.0.1

These depend on WURCSFramework v1.0.1.

WURCS Validator API 1.0.1

Get the result of validation from a WURCS string.

WURCS Validator
GET/wurcsframework/wurcsvalidator/1.0.1/{wurcs}

Example URI

GET https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.0.1/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1
URI Parameters
HideShow
wurcs
string (required) Example: WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1

URL-encoded WURCS string

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "m_sInputString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_sStandardString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_mapTypeToReports": {
    "WARNING": [],
    "ERROR": []
  }
}

WURCS Validator
POST/wurcsframework/wurcsvalidator/1.0.1

cURL Example:

$ curl -H "Content-Type: application/json" -d '{"wurcs":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1"}' https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.0.1
$ {"m_sInputString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1","m_sStandardString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1","m_mapTypeToReports":{"ERROR":[],"WARNING":[]}}

Error Example (modified to d2):

$ curl -H "Content-Type: application/json" -d '{"wurcs":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d2"}' https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.0.1
$ {"m_sInputString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d2","m_mapTypeToReports":{"ERROR":[{"strMessage":"Only one modification is allowed to be connected to the CarbonDescriptor \"2\".","strTargetInfo":"a\"2\"112h-1b_1-5_2*NCC/3=O","steCalledAt":{"classLoaderName":"app","declaringClass":"org.glycoinfo.WURCSFramework.util.validation.WURCSValidator","methodName":"validateConnectionsOnCarbonDescriptors","fileName":"WURCSValidator.java","lineNumber":351,"format":1}}],"WARNING":[]}}

Example URI

POST https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.0.1
Request  with body
HideShow
Headers
Content-Type: application/json
Body
{
  "wurcs": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "wurcs": {
      "type": "string",
      "description": "WURCS string"
    }
  },
  "required": [
    "wurcs"
  ]
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "m_sInputString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_sStandardString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_mapTypeToReports": {
    "WARNING": [],
    "ERROR": []
  }
}

WURCS to Mass API 1.0.1

Calculate the mass from the WURCS string.

$ curl "https://api.glyconavi.org/wurcsframework/wurcs2mass/1.0.1/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1"
910.32778000$

Calculate Mass
GET/wurcsframework/wurcs2mass/1.0.1/{wurcs}

Example URI

GET https://api.glyconavi.org/wurcsframework/wurcs2mass/1.0.1/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1
URI Parameters
HideShow
wurcs
string (required) Example: WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1

URL-encoded WURCS string

Response  200
HideShow
Headers
Content-Type: text/plain
Body
910.32778

Calculate Mass
POST/wurcsframework/wurcs2mass/1.0.1

Example URI

POST https://api.glyconavi.org/wurcsframework/wurcs2mass/1.0.1
Request  with body
HideShow
Headers
Content-Type: application/json
Body
{
  "wurcs": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "wurcs": {
      "type": "string",
      "description": "WURCS string"
    }
  },
  "required": [
    "wurcs"
  ]
}
Response  200
HideShow
Headers
Content-Type: text/plain
Body
910.32778

WURCSFramework 1.2.9

WURCSFramework version 1.2.9 related APIs.

WURCS Version 1.2.9

These depend on WURCSFramework v1.2.9.

WURCS Validator API 1.2.9

Get the result of validation from a WURCS string.

WURCS Validator
GET/wurcsframework/wurcsvalidator/1.2.9/{wurcs}

Example URI

GET https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.2.9/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1
URI Parameters
HideShow
wurcs
string (required) Example: WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1

URL-encoded WURCS string

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "m_sInputString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_sStandardString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_mapTypeToReports": {
    "WARNING": [],
    "ERROR": []
  }
}

WURCS Validator
POST/wurcsframework/wurcsvalidator/1.2.9

cURL Example:

$ curl -H "Content-Type: application/json" -d '{"wurcs":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1"}' https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.2.9
$ {"m_sInputString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1","m_sStandardString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1","m_mapTypeToReports":{"ERROR":[],"WARNING":[]}}

Error Example (modified to d2):

$ curl -H "Content-Type: application/json" -d '{"wurcs":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d2"}' https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.2.9
$ {"m_sInputString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d2","m_mapTypeToReports":{"ERROR":[{"strMessage":"Only one modification is allowed to be connected to the CarbonDescriptor \"2\".","strTargetInfo":"a\"2\"112h-1b_1-5_2*NCC/3=O","steCalledAt":{"classLoaderName":"app","declaringClass":"org.glycoinfo.WURCSFramework.util.validation.WURCSValidator","methodName":"validateConnectionsOnCarbonDescriptors","fileName":"WURCSValidator.java","lineNumber":351,"format":1}}],"WARNING":[]}}

Example URI

POST https://api.glyconavi.org/wurcsframework/wurcsvalidator/1.2.9
Request  with body
HideShow
Headers
Content-Type: application/json
Body
{
  "wurcs": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "wurcs": {
      "type": "string",
      "description": "WURCS string"
    }
  },
  "required": [
    "wurcs"
  ]
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "m_sInputString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_sStandardString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_mapTypeToReports": {
    "WARNING": [],
    "ERROR": []
  }
}

WURCS to Mass API 1.2.9

Calculate the mass from the WURCS string.

$ curl "https://api.glyconavi.org/wurcsframework/wurcs2mass/1.2.9/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1"
910.32778000$

Calculate Mass
GET/wurcsframework/wurcs2mass/1.2.9/{wurcs}

Example URI

GET https://api.glyconavi.org/wurcsframework/wurcs2mass/1.2.9/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1
URI Parameters
HideShow
wurcs
string (required) Example: WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1

URL-encoded WURCS string

Response  200
HideShow
Headers
Content-Type: text/plain
Body
910.32778

Calculate Mass
POST/wurcsframework/wurcs2mass/1.2.9

Example URI

POST https://api.glyconavi.org/wurcsframework/wurcs2mass/1.2.9
Request  with body
HideShow
Headers
Content-Type: application/json
Body
{
  "wurcs": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "wurcs": {
      "type": "string",
      "description": "WURCS string"
    }
  },
  "required": [
    "wurcs"
  ]
}
Response  200
HideShow
Headers
Content-Type: text/plain
Body
910.32778

WURCSFramework latest

Latest WURCSFramework version related APIs.

WURCS Version latest

These depend on WURCSFramework vlatest.

WURCS Validator API latest

Get the result of validation from a WURCS string.

WURCS Validator
GET/wurcsframework/wurcsvalidator/latest/{wurcs}

Example URI

GET https://api.glyconavi.org/wurcsframework/wurcsvalidator/latest/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1
URI Parameters
HideShow
wurcs
string (required) Example: WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1

URL-encoded WURCS string

Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "m_sInputString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_sStandardString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_mapTypeToReports": {
    "WARNING": [],
    "ERROR": []
  }
}

WURCS Validator
POST/wurcsframework/wurcsvalidator/latest

cURL Example:

$ curl -H "Content-Type: application/json" -d '{"wurcs":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1"}' https://api.glyconavi.org/wurcsframework/wurcsvalidator/latest
$ {"m_sInputString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1","m_sStandardString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d1","m_mapTypeToReports":{"ERROR":[],"WARNING":[]}}

Error Example (modified to d2):

$ curl -H "Content-Type: application/json" -d '{"wurcs":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d2"}' https://api.glyconavi.org/wurcsframework/wurcsvalidator/latest
$ {"m_sInputString":"WURCS=2.0/4,4,3/[u2122h][a2112h-1b_1-5][a2112h-1a_1-5][a2112h-1b_1-5_2*NCC/3=O]/1-2-3-4/a4-b1_b3-c1_c3-d2","m_mapTypeToReports":{"ERROR":[{"strMessage":"Only one modification is allowed to be connected to the CarbonDescriptor \"2\".","strTargetInfo":"a\"2\"112h-1b_1-5_2*NCC/3=O","steCalledAt":{"classLoaderName":"app","declaringClass":"org.glycoinfo.WURCSFramework.util.validation.WURCSValidator","methodName":"validateConnectionsOnCarbonDescriptors","fileName":"WURCSValidator.java","lineNumber":351,"format":1}}],"WARNING":[]}}

Example URI

POST https://api.glyconavi.org/wurcsframework/wurcsvalidator/latest
Request  with body
HideShow
Headers
Content-Type: application/json
Body
{
  "wurcs": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "wurcs": {
      "type": "string",
      "description": "WURCS string"
    }
  },
  "required": [
    "wurcs"
  ]
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "m_sInputString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_sStandardString": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1",
  "m_mapTypeToReports": {
    "WARNING": [],
    "ERROR": []
  }
}

WURCS to Mass API latest

Calculate the mass from the WURCS string.

$ curl "https://api.glyconavi.org/wurcsframework/wurcs2mass/latest/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1"
910.32778000$

Calculate Mass
GET/wurcsframework/wurcs2mass/latest/{wurcs}

Example URI

GET https://api.glyconavi.org/wurcsframework/wurcs2mass/latest/WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1
URI Parameters
HideShow
wurcs
string (required) Example: WURCS%3D2.0%2F3%2C5%2C4%2F%5Ba2122h-1b_1-5_2%2ANCC%2F3%3DO%5D%5Ba1122h-1b_1-5%5D%5Ba1122h-1a_1-5%5D%2F1-1-2-3-3%2Fa4-b1_b4-c1_c3-d1_c6-e1

URL-encoded WURCS string

Response  200
HideShow
Headers
Content-Type: text/plain
Body
910.32778

Calculate Mass
POST/wurcsframework/wurcs2mass/latest

Example URI

POST https://api.glyconavi.org/wurcsframework/wurcs2mass/latest
Request  with body
HideShow
Headers
Content-Type: application/json
Body
{
  "wurcs": "WURCS=2.0/3,5,4/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5]/1-1-2-3-3/a4-b1_b4-c1_c3-d1_c6-e1"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "wurcs": {
      "type": "string",
      "description": "WURCS string"
    }
  },
  "required": [
    "wurcs"
  ]
}
Response  200
HideShow
Headers
Content-Type: text/plain
Body
910.32778

Generated by aglio on 27 Jan 2023