RESTful Web Services for People and Organizations
- Parties: search for generically for People and Organizations
- People: search for people
- Party: CRUD operations for individual Person records
- Person: CRUD operations for individual Person records
- Organizations: search for organizations
- Organization: CRUD operations for individual Organization records
HTTP Headers
When requesting content from ScienceBase services, use the Accept header to request a format such as
Accept: application/json
And when sending content in the body of a POST or PUT, use the Content-Type header to tell the server the format of the incoming content and add an Accept header to specify what format should be returned.
Content-Type: application/json
Accept: application/json
Older versions of some ScienceBase services conflated Content-Type and Accept headers. So some services have worked with only specifying one of these headers for both submitted and requested formats. Do not rely on that going forward. Use Accept to request a format from a service and Content-Type to describe data being sent to the service. POST and PUT methods involve both sending and receiving data so both headers should be used.
Status
These services are being used by production applications such as ScienceBase-Catalog and are still an active work in progress. JSON (ScienceBase-JSON) is the preferred format, while there is an XML format, at least for Read operations, it's future is uncertain. This current ScienceBase XML format might be replaced with a standard like ATOM. To get ScienceBase-JSON make sure you add the header Accept: application/json
or the query param format=json
to the request.