[ 
https://issues.apache.org/jira/browse/FALCON-184?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13818080#comment-13818080
 ] 

Srimanth Gunturi commented on FALCON-184:
-----------------------------------------

I am thinking the default content-type for all API calls should be JSON (not 
XML), thereby not requiring additional headers (users forget to add them 
frequently). Each API call should document the default content-type and 
alternate content-types.

For example, {{/api/admin/stack}} would have a default content-type of 
{{text/plain}} with no alternative content-types.
{{/api/admin/version}} would provide {{application/json}} by default, and 
{{text/xml}} as alternative.


> Select default content-type for API responses and update docs
> -------------------------------------------------------------
>
>                 Key: FALCON-184
>                 URL: https://issues.apache.org/jira/browse/FALCON-184
>             Project: Falcon
>          Issue Type: Bug
>          Components: prism
>    Affects Versions: 0.3
>            Reporter: Srimanth Gunturi
>            Assignee: Srimanth Gunturi
>             Fix For: 0.4
>
>
> Wiki documentation shows output in JSON. However it does not mention that a 
> request header of {{Accept: application/json}} is required to output JSON 
> content.
> Either we make JSON the default output in API thereby not requiring an 
> {{Accept}} header. Or we document the header.



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Reply via email to