Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Request MethodGET
URL

https://$SERVER/registry/api/co/coid/core/v1/people/identifier

where

  • coid: CO ID
  • identifier: CO Person Identifier, of the configured type

Index API Endpoint

Request MethodGET
URL

https://$SERVER/registry/api/co/coid/core/v1/people[&limit=limit&page=page&direction=dir]

where

  • coid: CO ID
  • directionasc (return older records first) or desc (return newer records first)
  • limit: The maximum number of records to return in the response
  • page: Return this page of the result set

Message Format

The response is a JSON document as described by this JSON Schema.

Identifier via Query Parameter

As of Registry v4.1.0, identifiers may be provided to the read API via query parameters. Effectively, all read requests will be treated as Index operations, though when an identifier is provided at most one record will be returned.

Code Block
GET https://$SERVER/registry/api/co/<coid>/core/v1/people?identifier=<foo>

CO Person Write API

The CO Person Write API is a collection of three APIs allow creation, updating, and deletion of CO Person records.

...

Note

The Write API cannot be used to update attributes that are not normally modifiable via other mechanisms, including

Create API Endpoint

Request MethodPOST
URL

https://$SERVER/registry/api/co/coid/core/v1/people

where

  • coid: CO ID

Delete API Endpoint

Request MethodDELETE
URL

https://$SERVER/registry/api/co/coid/core/v1/people/identifier

where

  • coid: CO ID
  • identifier: CO Person Identifier, of the configured type

Update API Endpoint

Request MethodPUT
URL

https://$SERVER/registry/api/co/coid/core/v1/people/identifier

where

  • coid: CO ID
  • identifier: CO Person Identifier, of the configured type

...

The Create request will include the newly assigned Identifier of the configured type in the response body.

Identifier via Query Parameter

As of Registry v4.1.0, identifiers may be provided to the write API via query parameters.

Code Block
PUT https://$SERVER/registry/api/co/<coid>/core/v1/people?identifier=<foo>
DELETE https://$SERVER/registry/api/co/<coid>/core/v1/people?identifier=<foo>