SOAP APIs
General Purpose
Rosetta SOAP Web Services provide a large number of APIs which can be called from any external application. Rosetta has started an ongoing development to release a full suite of REST APIs, providing parallel services to those currently provided as SOAP services.
List of Web Services
Most SOAP Web Services require authentication. Rosetta APIs support two authentication methods:
- Basic Authentication: A base64 encoded user, institution code and password, sent as an Authorization HTTP header. Decoded string should be {username}-institutionCode-{institutionCode}:{password}, e.g. vickyholmes-institutionCode-INS00:9uQ29kZS1JT.
- PDS handle: PDS is packaged with the Rosetta SDK. See here for integrating PDS in your application.
Alternatively, you may obtain a PDS handle over http:
https://[pds_host]:[pds_port]/pds?func=login&bor_id=[username]&bor_verification=[password]&institute=[institution_code]
For example:
https://rosetta.myorg.edu/pds?func=login&bor_id=admin1&bor_verification=a12345678A&institute=INS00
Users should note the required roles for each type of web service.
Access Restriction
Access to Rosetta web services can be restricted by IP range (IPv4 only). This is managed in the IP WebService Restriction mapping table. Changes to this table require a server restart.
| Web Service Name | Code in Mapping Table |
|---|---|
| Collection Related Web Services | CollectionWebServices |
| Data Management Web Services | DataManagerServicesWS |
| Delivery Web Services | DeliveryAccessWS |
| Deposit Related Web Services | DepositWebServices |
| IE Update Web Services | IEWebServices |
| Producer Related Web Services | ProducerWebServices |
| SIP Processing Related Web Services | SipWebServices |
| SRU | SRUServlet |
| Collection Tree | CollectionTreeServlet |
Other rows in this table refer to internal web services for communication between Rosetta servers and should not be edited.