Service | iSHARE Developer Portal

Abstract endpoint for Service Provider (parameters apply to other HTTP methods as well)

This is an abstract service (business specific) endpoint to show how any Service Provider that adheres to iSHARE MUST apply iSHARE conformant OAuth to every iSHARE enabled service. Request can make use of any HTTP method and can contain any extra headers. For convenience this documentation only defines the GET method. Parameters are undefined because they vary for each Service Provider due to their business specific logic. Note: Additional headers for security, statefulnes, application functionality could be added and is out of scope of this specification.

get

/service

Authorizations

Header parameters

delegation_evidencestring

iSHARE delegation evidence regarding the requested service. The Service Consumer can obtain this evidence from an Authorization Registry / Entitled Party before requesting a specific service.

service_consumer_assertionstring

iSHARE specific optional client assertion. Used when a Service Consumer is requesting a service on behalf of another Service Consumer in a 'service broker' pattern. It is used to prove that the 'brokering' Service Consumer indeed has had a request from the original Service Consumer

LicensePurposestring

Optional iSHARE specific value describing the purpose of the license the Service Consuming Entity requests for the data in the service response

Service-Headersstring

Any service specific headers

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://isharetest.net/service' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

{
  "service_content_1": "text",
  "service_content_n": "text"
}