RESTful Interface Design for Entity Version

Identifier Domain Resource

3 min read

On this page
  1. URL: /openempi-ws-rest/1.0/identifier-domains
  2. Methods
  3. Responses
  4. Example
  5. URL: /openempi-ws-rest/1.0/identifier-domains/${identifierDomainId}
  6.  Parameters
  7. Methods
  8. Responses
  9. Example
  10. URL(POST for add): /openempi-ws-rest/1.0/identifier-domains
  11. Parameters
  12. Methods
  13. Responses
  14. Example
  15. URL(PUT for update): /openempi-ws-rest/1.0/identifier-domains
  16. Parameters
  17. Methods
  18. Responses
  19. Example

URL: /openempi-ws-rest/1.0/identifier-domains

Methods

GET

Returns the complete list of identifier domains that have been defined in the system.

Responses

  • 200 - application/json - Returns a JSON representation of the response based on the Accept header

  • 200 - application/xml - Returns an XML representation of the response based on the Accept header

  • 404 - Returned if there are no entities defined in the system

Example

Version 1.0

http://localhost:8080/openempi-admin/openempi-ws-rest/1.0/identifier-domains

Return:

    

        2013-01-17T11:33:45.903-05:00

        IHERED

        2750

        IHERED

        IHERED

        1.3.6.1.4.1.21367.13.20.1000

        ISO

    

    

        2012-02-10T13:44:24.755-05:00

        OpenEMPI Domain

        56

        2.16.840.1.113883.4.357

        2.16.840.1.113883.4.357

        2.16.840.1.113883.4.357

        hl7

    

URL: /openempi-ws-rest/1.0/identifier-domains/{identifierDomainId}

 Parameters

| Parameter

|

Value Type

|

Parameter Type

|

R/O

|

Description

| | --- | --- | --- | --- | --- | |

identifierDomainId

|

Integer

|

Path Parameter

| R |

The unique identifier of the identifier domain of interest

|

Methods

GET

Returns detailed information about the identifier domain identified by the parameter identifierDomainId

Responses

  • 200 - application/json - Returns a JSON representation of the response based on the Accept header

  • 200 - application/xml - Returns an XML representation of the response based on the Accept header

  • 404 - Returned if there is no entity known in the system with that entityId

Example

Version 1.0

Identifier domain id is 2750.

http://localhost:8080/openempi-admin/openempi-ws-rest/1.0/identifier-domains/2750

Return:

    2013-01-17T11:33:45.903-05:00

    IHERED

    2750

    IHERED

    IHERED

    1.3.6.1.4.1.21367.13.20.1000

    ISO

URL(POST for add): /openempi-ws-rest/1.0/identifier-domains

Parameters

| Parameter

|

Value Type

|

Parameter Type

|

R/O

|

Description

| | --- | --- | --- | --- | --- | | identifierDomain | IdentifierDomain | Body | R | An IdentifierDomain object |

Methods

POST

Returns the newly added IdentifierDomain.

Responses

  • 200 - application/json - Returns a JSON representation of the response based on the Accept header

  • 200 - application/xml - Returns an XML representation of the response based on the Accept header

  • 400 - Returned if there is a bad request.

  • 409 - Returned if there is a record conflict in the system.

Example

Version 1.0

POST

http://localhost:8080/openempi-admin/openempi-ws-rest/1.0/identifier-domains

Content-Type: application/xml

Body:

    2013-10-01     Test     Test-Domaon     Test-Domaon         >

Return:

    2013-10-08T13:21:26.091-04:00     Test     139     Test-Domaon     Test-Domaon        

Content-Type: application/json

Body:

{ “dateCreated” : “2013-10-08”,   “identifierDomainDescription” : “Test”,   “identifierDomainName” : “Test-Domaon”,   “namespaceIdentifier” : “Test-Domaon”,   “universalIdentifier” : "",   “universalIdentifierTypeCode” : "" }

Return:

{ “dateCreated” : “2013-10-08T13:17:21.881-04:00”,   “identifierDomainDescription” : “Test”,   “identifierDomainId” : “139”,   “identifierDomainName” : “Test-Domaon”,   “namespaceIdentifier” : “Test-Domaon”,   “universalIdentifier” : "",   “universalIdentifierTypeCode” : "" }

URL(PUT for update): /openempi-ws-rest/1.0/identifier-domains

Parameters

| Parameter

|

Value Type

|

Parameter Type

|

R/O

|

Description

| | --- | --- | --- | --- | --- | | identifierDomain | IdentifierDomain | Body | R | An IdentifierDomain object |

Methods

PUT

Returns the updated IdentifierDomain.

Responses

  • 200 - application/json - Returns a JSON representation of the response based on the Accept header

  • 200 - application/xml - Returns an XML representation of the response based on the Accept header

  • 400 - Returned if there is a bad request.

  • 409 - Returned if there is a record conflict in the system.

Example

Version 1.0

PUT

http://localhost:8080/openempi-admin/openempi-ws-rest/1.0/identifier-domains

Content-Type: application/xml

Body:

    2013-10-08T13:21:26.091-04:00     Update     139     Update-Domaon     Update-Domaon        

Return:

    2013-10-08T13:24:57.230-04:00     Update     139     Update-Domaon     Update-Domaon        

Content-Type: application/json

Body:

{ “dateCreated” : “2013-10-08T13:17:21.881-04:00”,   “identifierDomainDescription” : “Update”,   “identifierDomainId” : “139”,   “identifierDomainName” : “Update-Domaon”,   “namespaceIdentifier” : “Update-Domaon”,   “universalIdentifier” : "",   “universalIdentifierTypeCode” : "" }

Return:

{ “dateCreated” : “2013-10-08T13:57:21.881-04:00”,   “identifierDomainDescription” : “Update”,   “identifierDomainId” : “139”,   “identifierDomainName” : “Update-Domaon”,   “namespaceIdentifier” : “Update-Domaon”,   “universalIdentifier” : "",   “universalIdentifierTypeCode” : "" }

Up to Entity API Documentation