Jira server ASF JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 5aa69414-a9e9-3523-82ec-879b028fb15b key ATLAS-1691
Draft - put together by Nigel on 15 Aug – I hope this can be a starting point to get some agreement and consistency over how we develop the OMAS interfaces.
Notes from 15/08 call
* not a chatty interface
* move this comment into a sub JIRA of OMAS JIRA & add comments as pdf/doc or ascii text so they can go through JIRA review -> or even apache review board tool with line by line annotation.....
Scope
...
General
...
REST API
* GET for query, nothing should change in the entity. No side effects (except last access time/audit logs)
* PUT is used for create
* POST is used for update or actions with side effects
* DELETE will delete (usually soft)
* PATCH is not used
* Scoping parameters should feature in GETs as query parameters
* Pagination should be supported (Page Number & Page Size)
* Only json is supported
* A non successful response will send back a sensible http status code, a more detailed enumeration specifying the type of error, a specific, unique error code, and a string containing other helpful information or parameters. A "user response" is also returned. (Example I used for GAF is here - follow swagger link)
* The endpoint will be /v2/<omasname>
* The /v2/<omasname>/>object> will be a plural noun
Kafka Messaging (pub/sub)
...
Language/Bindings
...
Documentation
* A skeleton Java implementation will initially be committed to generate Swagger API
* When the community is broadly happy the implementation will be filled outSee https://github.com/odpi/egeria