I suggest you ...

Support application/x-www-form-urlencoded input parameters

I want to describe method that accepts form-urlencoded POST parameters.
I'd like to specify them somehow, so they will be displayed inside "In" section of method description.

Might be it's possible already, but i didn't find how.

59 votes
Vote
Sign in
Check!
(thinking…)
Reset
or sign in with
  • facebook
  • google
    Password icon
    I agree to the terms of service
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    daeqdaeq shared this idea  ·   ·  Admin →

    4 comments

    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      Submitting...
      • Huiming TeoHuiming Teo commented  · 

        Hi Lukas, any updates on this feature? I wish know how to document application/x-www-form-urlencoded input parameters for a POST request. Can you show me a working example?

        I'm trying to do this, but the input parameters table is not rendered.
        ```
        ### Create a Note [POST]

        + Request (application/x-www-form-urlencoded)
        + Parameters
        + title (required, string) ... Foo bar

        + Body

        title=Foo

        ```

      • Jakub NesetrilAdminJakub Nesetril (CEO, apiary.io) commented  · 

        Hi everybody,

        I would like to ask for a brief clarification on this request...

        You can accept any POST data in Apiary as of now. For x-www-form-urlencoded parameters it would mean adding appropriate HTTP content type header to the incoming headers section, and then properly encoded incoming data to the data section.

        While this works, it is clearly not overly convenient.

        Since you voted for this feature, I wanted to ask for some feedback on what you actually view as important addition:

        - better syntax-highlight of urlencoded parameters in blueprint editor
        - ability to describe the parameters in a more user-friendly way (and for apiary to produce the required sterilization automatically)
        - better support in code samples (let the client library do the serialization)

        Please let me know if it's any of the above or another idea that I have missed.

        Thanks in advance,

        Jakub

      Feedback and Knowledge Base