Hi Jo, I'll provide my input until Sunday evening...
Best regards, Frank 2015-03-26 4:52 GMT+01:00 Joseph Fonseka <[email protected]>: > Hi Frank > > What are the headers we should include ? > > 1. For the access token header we can define it globally in the security > definition [1] > <https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#securityDefinitionsObject> > 2. Content-type headers are covered by the consumes and produces > attributes [2] > <https://github.com/hevayo/restful-apim/blob/master/apim.yaml#L18-L19> > 3. For post methods we have an option of sending "Link" header with a URL > to newly created resource rather than returning newly created resource JSON. > > Thanks > Jo > > [1] > https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#securityDefinitionsObject > > [2] https://github.com/hevayo/restful-apim/blob/master/apim.yaml#L18-L19 > > On Wed, Mar 25, 2015 at 3:51 PM, Frank Leymann <[email protected]> wrote: > >> Hi Jo, >> >> nice piece of work! >> >> What is still needed is a description of the header fields for both, the >> requests and APIs. >> >> >> >> Best regards, >> Frank >> >> 2015-03-24 17:34 GMT+01:00 Joseph Fonseka <[email protected]>: >> >>> Hi All >>> >>> We are planing to implement a RESTFul API to expose the API Manager >>> functionality. This will be a replacement to the currently provided Store >>> and Publisher APIs [1] >>> <https://docs.wso2.com/display/AM180/Publisher+APIs> & [2] >>> <https://docs.wso2.com/display/AM180/Store+APIs>. >>> >>> Main Motivation. >>> 1. The current APIs are not RESTful and they do not cover all the >>> functionality. >>> 2. To make it easy to integrate and automate API manager functionality >>> with 3rd party systems. >>> 3. To provide better security with Oauth. >>> 4. To provide better versioning and documentation with the API. >>> >>> As a start we have written a draft version of the API definition which >>> you can find here [3] <http://hevayo.github.io/restful-apim/>. >>> >>> Following is a rough implementation plan. >>> 1. Work on the API Definition, get feed back from users and finalize. >>> 2. Implementation. ( Architecture , Jax-RS ?) >>> 3. Adding Security. ( O-auth, scopes ? ) >>> 4. Testing. >>> 5. Documentation. >>> >>> API definition was written with Swagger 2 once completed we can use it >>> to generate server stubs, client stubs and documentation. >>> >>> Please share your thoughts. >>> >>> Thanks >>> Jo >>> >>> [1] https://docs.wso2.com/display/AM180/Publisher+APIs >>> [2] https://docs.wso2.com/display/AM180/Store+APIs >>> [3] http://hevayo.github.io/restful-apim/ >>> >>> -- >>> *Joseph Fonseka* >>> WSO2 Inc.; http://wso2.com >>> lean.enterprise.middleware >>> >>> mobile: +94 772 512 430 >>> skype: jpfonseka >>> >>> * <http://lk.linkedin.com/in/rumeshbandara>* >>> >>> >> > > > -- > > -- > *Joseph Fonseka* > WSO2 Inc.; http://wso2.com > lean.enterprise.middleware > > mobile: +94 772 512 430 > skype: jpfonseka > > * <http://lk.linkedin.com/in/rumeshbandara>* > >
_______________________________________________ Architecture mailing list [email protected] https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
