Accessing SESAR’s REST web services

SESAR’s REST web services will have restricted access after release v7.5 becasue of the introduction of MARS (Middleware for Assisting the Registration of Samples) provides a possible pathway where individuls can register samples through REST web services with checks on the quality of the metadata or the mapping of metadata fields. Therefore, access to REST web services will be restricted to ensure quality of registered sample metedata. If you used REST web services before the release of v7.5, you will be grandfathered into accessing SESAR’s REST web services. If you wish to be a new user of SESAR’s REST web services you must fill out this request form. SESAR curators will work with you to ensure that your use of SESAR’s web services results in the registration of good, quality metadata.

SESAR provides following REST web services

  1. Sample registration
  2. Validate user credentials and get user codes
  3. IGSN list for a specific user code
  4. IGSN list for a geospatial polygon
  5. IGSN list for a specific field program
  6. Sample profile for a specific IGSN
  7. Update sample metadata for a specific IGSN
  8. Get IGSN(s) for a specific user code and a sample name (NEW)
  9. Delete a related URL for a specific IGSN (NEW)

The end point is https://app.geosamples.org/webservices/. The test end point is https://sesardev.geosamples.org/webservices/. Before you start to use web services 1, 2, 7, you need to do the following two steps.

  1. Create a free GeoPass account. Follow this link.
  2. Create your namespace(s) or user code(s). Or gain access to other user’s namespace(s). Follow this link.
  3. Fill out this request form