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 <fr...@wso2.com> 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 <jos...@wso2.com>: > >> 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 Architecture@wso2.org https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture