8 Service APIs

This section provides a reference for APIs that should be implemented by this Building Block.

A Set of microservices are defined to receive requests from other GovStack-compatible Building Blocks and applications with relevant inputs and return processed results from key digital functionalities of this Building Block. This section provides a reference for APIs that should be implemented by this Building Block. The APIs defined here establish a blueprint for how the Building Block will interact with other Building Blocks. Additional APIs may be implemented by the Building Block, but the listed APIs define a minimal set of functionality that should be provided by any implementation of this Building Block.

Scheduler must expose its microservices through RESTful API interfaces as defined by OpenAPI v3+ standards. The Scheduler must have any response data payload it returns through its API only in the form of JSON formatted datasets. A summary of the APIS exposed by this Building Block is summarized in the table below. The Scheduler Building Block can be used also as an internal sub-block of another Building Block. In such a case the same services APIs will be used to embed the Scheduler Building Block (without having to pass through the Information Mediator).

The GovStack non-functional requirements document provides additional information on how 'adaptors' may be used to translate an existing API to the patterns described here. This section also provides guidance on how candidate products are tested and how GovStack validates a product's API against the API specifications defined here.

The tests for the Scheduler Building Block can be found in this GitHub repository.

8.1 Event Management

create a new event, in event_list with given event_details, returns new event id or failure error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created event

Example: "event_id:12345"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

event_id:12345

changes values of specific details (as given by event_details) of given event (selected by event_filter)in event_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event/modifications

Query parameters

Response

200400403404default

success, event updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event/modifications?requestor_id=healthngoadmin1&request_token=Organizer&event_id=12345&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined event in event_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event

Query parameters

Response

200400403404default

success, event cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event?requestor_id=healthngoadmin1&request_token=Organizer&event_id=12345', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of events filetered by criteria in event_filter and return info specified by event_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event/list_details

Query parameters

Response

200400403404default

success,event_list

Body

json

event_idstring

Example: "12345"

detailsevent_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//event/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "event_id": "12345",
      "details": {
        "name": "abc medical camp",
        "description": "medical camp for senior citizens",
        "category": "doctor_consultation",
        "host_entity_id": "67890",
        "from": "2018-02-15T11:00:00",
        "to": "2018-02-15T11:30:00",
        "deadline": "2018-02-15T11:10:00",
        "subscriber_limit": "1",
        "terms": "non refundable",
        "status": "open",
        "venue": {
          "building": "xyz",
          "street": "7th main",
          "area": "wilson garden",
          "city": "bangalore",
          "state": "karnataka",
          "country": "india",
          "lat": "0.001",
          "long": "0.002"
        }
      }
    }
  ]
]

8.2 Entity Management

create a new entity, in entity_list with given entity_details, returns new entity id or entity error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created entity

Example: "entity_name:xyz hospital,entity_id:67890"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

entity_name:xyz hospital,entity_id:67890

changes values of specific details (as given by entity_details) of given entity (selected by entity_filter)in entity_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity/modifications

Query parameters

Response

200400403404default

success, entity updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity/modifications?requestor_id=healthngoadmin1&request_token=Organizer&entity_id=67890&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined entity in entity_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity

Query parameters

Response

200400403404default

success, entity cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity?requestor_id=healthngoadmin1&request_token=Organizer&entity_id=67890', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of entities filetered by criteria in entity_filter and return info specified by entity_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity/list_details

Query parameters

Response

200400403404default

success,entity list

Body

json

entity_idstring

Example: "67890"

detailsentity_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//entity/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "entity_id": "67890",
      "details": {
        "category": "hospital",
        "name": "abc",
        "phone": "[phone]",
        "email": "[e-mail]",
        "website": "www.abc.com"
      }
    }
  ]
]

8.3 Alert Schedule Management

create a new alert_schedule, in alert_schedule_list with given alert_schedule_details, returns new alert_schedule id or error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created alert_schedule

Example: "alert_schedule_name:xyz hospital,alert_schedule_id:1"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

alert_schedule_name:xyz hospital,alert_schedule_id:1

changes values of specific details (as given by alert_schedule_details) of given alert_schedule (selected by alert_schedule_filter)in alert_schedule_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule/modifications

Query parameters

Response

200400403404default

success, alert_schedule updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule/modifications?requestor_id=healthngoadmin1&request_token=text&alert_schedule_id=1&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined alert_schedule in alert_schedule_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule

Query parameters

Response

200400403404default

success, alert_schedule cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule?requestor_id=healthngoadmin1&request_token=Organizer&alert_schedule_id=1', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of entities filetered by criteria in alert_schedule_filter and return info specified by alert_schedule_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule/list_details

Query parameters

Response

200400403404default

success,alert_schedule list

Body

json

alert_schedule_idstring

Example: "1"

detailsalert_schedule_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//alert_schedule/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "alert_schedule_id": "1",
      "details": {
        "event_id": "12345",
        "target_category": "subscriber",
        "message_id": "1",
        "alert_datetime": "2018-02-15T09:00:00"
      }
    }
  ]
]

8.4 Alert Message Management

create a new message, in message_list with given message_details, returns new message id or error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created message

Example: "message_name:xyz hospital,message_id:1"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

message_name:xyz hospital,message_id:1

changes values of specific details (as given by message_details) of given message (selected by message_filter)in message_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message/modifications

Query parameters

Response

200400403404default

success, message updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message/modifications?requestor_id=healthngoadmin1&request_token=Organizer&message_id=1&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined message in message_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message

Query parameters

Response

200400403404default

success, message cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message?requestor_id=healthngoadmin1&request_token=Organizer&message_id=1', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of entities filetered by criteria in message_filter and return info specified by message_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message/list_details

Query parameters

Response

200400403404default

success,message list

Body

json

message_idstring

Example: "1"

detailsmessage_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//message/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "message_id": "1",
      "details": {
        "entity_id": "67890",
        "category": "reminder",
        "message_body": "you have doctor consultation today"
      }
    }
  ]
]

8.5 Resource management

create a new resource, in resource_list with given resource_details, returns new resource id or error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created resource

Example: "resource_name:xyz hospital,resource_id:54321"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

resource_name:xyz hospital,resource_id:54321

changes values of specific details (as given by resource_details) of given resource (selected by resource_filter)in resource_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/modifications

Query parameters

Response

200400403404default

success, resource updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/modifications?requestor_id=healthngoadmin1&request_token=Organizer&resource_id=54321&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined resource in resource_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource

Query parameters

Response

200400403404default

success, resource cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource?requestor_id=healthngoadmin1&request_token=Organizer&resource_id=54321', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of entities filetered by criteria in resource_filter and return info specified by resource_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/list_details

Query parameters

Response

200400403404default

success,resource list

Body

json

resource_idstring

Example: "54321"

detailsresource_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "resource_id": "54321",
      "details": {
        "name": "psrk",
        "category": "doctor",
        "phone": "[phone]",
        "email": "[e-mail]",
        "alert_url": "[e-mail]",
        "alert_preference": "phone",
        "status_poll_url": "www.doctor1.com"
      }
    }
  ]
]

get details of resources matching criteria given by free_resource_filter, that are free(unallocated) in a given date range and entity and returns success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/availability

Query parameters

Response

200400403404default

success,resource list

Body

json

resource_idstring

Example: "1"

resource_namestring

Example: "abc"

free_slotsarray of string

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//resource/availability?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "resource_id": "1",
      "resource_name": "abc",
      "free_slots": [
        "{[2018-02-15T11:00:00to2018-02-15T11:09:00:00],[2018-02-22T11:00:00to2018-02-22T11:17:00:00]}"
      ]
    }
  ]
]

8.6 Subscriber management

create a new subscriber, in subscriber_list with given subscriber_details, returns new subscriber id or error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created subscriber

Example: "subscriber_name:xyz hospital,subscriber_id:12345"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

subscriber_name:xyz hospital,subscriber_id:12345

changes values of specific details (as given by subscriber_details) of given subscriber (selected by subscriber_filter)in subscriber_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber/modifications

Query parameters

Response

200400403404default

success, subscriber updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber/modifications?requestor_id=healthngoadmin1&request_token=Organizer&subscriber_id=12345&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined subscriber in subscriber_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber

Query parameters

Response

200400403404default

success, subscriber cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber?requestor_id=healthngoadmin1&request_token=Organizer&subscriber_id=12345', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of entities filetered by criteria in subscriber_filter and return info specified by subscriber_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber/list_details

Query parameters

Response

200400403404default

success,message list

Body

json

subscriber_idstring

Example: "12345"

detailssubscriber_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//subscriber/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "subscriber_id": "12345",
      "details": {
        "name": "abc",
        "category": "patient",
        "phone": "[phone]",
        "email": "[e-mail]",
        "alert_url": "www.abc.com",
        "alert_preference": "phone",
        "status_poll_url": "www.abc.com"
      }
    }
  ]
]

8.7 Affiliation management

create a new affiliation, in affiliation_list with given affiliation_details, returns new affiliation id or error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created affiliation

Example: "affiliation_name:xyz hospital,affiliation_id:1"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

affiliation_name:xyz hospital,affiliation_id:1

changes values of specific details (as given by affiliation_details) of given affiliation (selected by affiliation_filter)in affiliation_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation/modifications

Query parameters

Response

200400403404default

success, affiliation updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation/modifications?requestor_id=healthngoadmin1&request_token=Organizer&affiliation_id=1&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined affiliation in affiliation_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation

Query parameters

Response

200400403404default

success, affiliation cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation?requestor_id=healthngoadmin1&request_token=Organizer&affiliation_id=1', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of entities filetered by criteria in affiliation_filter and return info specified by affiliation_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation/list_details

Query parameters

Response

200400403404default

success,affiliation list

Body

json

affiliation_idstring

Example: "1"

detailsaffiliation_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//affiliation/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "affiliation_id": "1",
      "details": {
        "resource_id": "12345",
        "entity_id": "67890",
        "resource_category": "physician",
        "work_days_hours": [
          {
            "day_of_week": "[monday",
            "start_time": "09:00:00",
            "end_time": "17:00:00"
          }
        ]
      }
    }
  ]
]

8.8 Appointment management

create a new appointment, in appointment_list with given appointment_details, returns new appointment id or failure error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created appointment

Example: "[Event_id:12345,appointment_id:1]"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

[Event_id:12345,appointment_id:1]

changes values of specific details (as given by appointment_details) of given appointment (selected by appointment_filter)in appointment_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment/modifications

Query parameters

Response

200400403404default

success, appointment updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment/modifications?requestor_id=healthngoadmin1&request_token=Organizer&appointment_id=1&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined appointment in appointment_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment

Query parameters

Response

200400403404default

success, appointment cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment?requestor_id=healthngoadmin1&request_token=Organizer&appointment_id=1', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of appointments filetered by criteria in appointment_filter and return info specified by appointment_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment/list_details

Query parameters

Response

200400403404default

success,appointment_list

Body

json

appointment_idstring

Example: "1"

detailsappointment_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//appointment/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "appointment_id": "1",
      "details": {
        "exclusive": "true",
        "event_id": "1",
        "participant_type": "subscriber",
        "participant_id": "12345",
        "status_id": "confirmed",
        "participant_entity_id": "67890"
      }
    }
  ]
]

8.9 Status Logging and Reporting

create a new log, in log_list with given log_details, returns new log id or error code

POSThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log/new

Query parameters

Response

200400403404default

success

Body

application/json

string

ID of created log

Example: "log_name:xyz hospital,log_id:1"

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log/new?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

200

log_name:xyz hospital,log_id:1

changes values of specific details (as given by log_details) of given log (selected by log_filter)in log_list and returns success or error code

PUThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log/modifications

Query parameters

Response

200400403404default

success, log updated

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log/modifications?requestor_id=healthngoadmin1&request_token=Organizer&log_id=1&qry=%5Bobject+Object%5D', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

delete a predefined log in log_list and returns success or error code

DELETEhttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log

Query parameters

Response

200400403404default

success, log cancelled

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log?requestor_id=healthngoadmin1&request_token=Organizer&log_id=1', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

get list of entities filetered by criteria in log_filter and return info specified by log_details_required with success or error code

GEThttp://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log/list_details

Query parameters

Response

200400403404default

success,log list

Body

json

log_idstring

Example: "1"

detailslog_details (object)

Request

JavaScriptCurlPython

const response = await fetch('http://ss2.egovstack.net/r1/eGovStack/COM/11222456/SchedulerBB/creg//log/list_details?requestor_id=healthngoadmin1&request_token=Organizer&qry=%5Bobject+Object%5D', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  [
    {
      "log_id": "1",
      "details": {
        "logger_role": "resource",
        "logger_id": "1",
        "entity_id": "67890",
        "log_category": "attendance",
        "datetime": "2018-02-15T11:00:00",
        "log_data": "event_id:12345,subscriber_id:1,token:a2s3x2fer,status:attended"
      }
    }
  ]
]

4.10 Information Mediator Interface

These Service APIs are not yet specified, but it should be the purpose of a next iteration of the Scheduler Building Block Specification.

4.11 PubSub Interface

These Services APIs is not yet specified, but it should be the purpose of a next iteration of the Scheduler Building Block Specification.

4.12 Messaging interface

This Services APIs is not yet specified, but it should be the purpose of a next iteration of the Scheduler Building Block Specification.

4.13 Scheduler Administration

This Services APIs is not yet specified, but it should be the purpose of a next iteration of the Scheduler Building Block Specification.

API standards

• The microservice interfaces are defined as per OPENAPI Ver3.0 standards.

• For implementation purposes, it is suggested to refer TMF630_REST_API_Design_Guidelines.