Web Service:PR-WS-4: Difference between revisions

From IHRIS Wiki
No edit summary
No edit summary
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{WebServicePage|Get Provider Posting Detail
{{WebServicePage|Query For Postings
  |number=PR-WS-4
  |number=PR-WS-4
  |description=Fetches details of a provider's postings by their EPID.
  |description=Fetches details of a provider's postings by their EPID.
  |applications=Interoperability Layer, Point-Of-Care, Facility Registry, iHRIS
  |applications=Interoperability Layer, Point-Of-Care, Facility Registry, iHRIS
  |url=/ws/rest/v2/providerPosts
  |url=/ws/rest/v2/query/posts
  |params=This contains the following parameters to identify the provider whose details we shall return:
  |params=This contains the following parameters to identify the provider whose details we shall return.  The values of epid, foasid and orgunit are "and"ed together:
${epid} The provider's EPID
*${epid} The provider's EPID. Optional.
*${format}The response format.  One of 'hl7' or 'json'  
*${fosaid} The facility code.  Optional.
*${orgunit} The code for the organizational unit for the posting.  Optional
*${type} The type of the provider, one of PPS or CHW. Optional.
*${category} The category/cadre of the provider.  Optional.
*${format}The response format.  One of 'hl7' or 'json'
*${size} The maximum number number of IDs to return.  Defaults to 50.
*${start} The starting offset for listing IDs.  Defaults to 10.
  |response=*HTTP 200 - OK
  |response=*HTTP 200 - OK
*If the format='hl7' .....
*If the format='hl7' .....
*If the format='json' we return an array of associative arrays.  The associative arrays have keys for the post attribtues.  For example:
*If the format='json' we return an array of associative arrays.  The associative arrays have keys for the post attributes.  For example:
{  
{  
   0 : {
   total_size : 2,
    facility: 'XXX District Hospital',
   start: 0,
    foasid: '123213',    
  posts: {
    type: 'PPS',
    98798798 : {
    category: 'NURSE',
      editPost: http://rhea-pr.ihris.org/webservices/edit/post?id=98798798',
    actions: {
      postDetails: http://rhea-pr.ihris.org/webservices/details/post?id=98798798'
        'editPost': http://blahblah/,
    },
          'disablePost': http://blahblah/
    9878799 : {
    }
      editPost: http://rhea-pr.ihris.org/webservices/edit/post?id=98798799',
  },
      postDetails: http://rhea-pr.ihris.org/webservices/details/post?id=98798799'
  1 : {
    }
    facility: 'YYY District Hospital',
  }
    code: '12345', 
    type:  'PPS',
    category: 'NURSE',
    actions: {
        'editPost': http://blahblah/,
          'disablePost': http://blahblah/
    }
  },
}
}
  |error=*HTTP 500 - Server Error - If the server encountered an error.
  |error=*HTTP 500 - Server Error - If the server encountered an error.

Latest revision as of 06:47, 31 October 2012

Web Service: PR-WS-4 Query For Postings

Fetches details of a provider's postings by their EPID.

URL /ws/rest/v2/query/posts
GET Parameters This contains the following parameters to identify the provider whose details we shall return. The values of epid, foasid and orgunit are "and"ed together:
  • ${epid} The provider's EPID. Optional.
  • ${fosaid} The facility code. Optional.
  • ${orgunit} The code for the organizational unit for the posting. Optional
  • ${type} The type of the provider, one of PPS or CHW. Optional.
  • ${category} The category/cadre of the provider. Optional.
  • ${format}The response format. One of 'hl7' or 'json'
  • ${size} The maximum number number of IDs to return. Defaults to 50.
  • ${start} The starting offset for listing IDs. Defaults to 10.
GET Response
  • HTTP 200 - OK
  • If the format='hl7' .....
  • If the format='json' we return an array of associative arrays. The associative arrays have keys for the post attributes. For example:

{ 

 total_size : 2,
 start: 0,
 posts: {
   98798798 : {
      editPost: http://rhea-pr.ihris.org/webservices/edit/post?id=98798798',
      postDetails: http://rhea-pr.ihris.org/webservices/details/post?id=98798798'
   },
   9878799 : {
      editPost: http://rhea-pr.ihris.org/webservices/edit/post?id=98798799',
      postDetails: http://rhea-pr.ihris.org/webservices/details/post?id=98798799'
   }
  }
}
GET Error
  • HTTP 500 - Server Error - If the server encountered an error.
  • HTTP 400 - Bad Request - If the parameters are malformed.

Other Resources: Use Case:PR-WS-4

Retrieved from "https://wiki.ihris.org/mediawiki/index.php?title=Web_Service:PR-WS-4&oldid=46672"