General

I suggest you ...

You've used all your votes and won't be able to post a new idea, but you can still search and comment on existing ideas.

There are two ways to get more votes:

  • When an admin closes an idea you've voted on, you'll get your votes back from that idea.
  • You can remove your votes from an open idea you support.
  • To see ideas you have already voted on, select the "My feedback" filter and select "My open ideas".
(thinking…)

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can support and comment on it.

If it doesn't exist, you can post your idea so others can support it.

Enter your idea and we'll search to see if someone has already suggested it.

  1. bring the apiary.io parser closer to run-time & developers

    I had a slightly different approach to providing code samples in different languages than your https://github.com/apiaryio/language-templates

    You can see it at https://github.com/andreineculau/apiary.syntax.js

    tl;dr
    Raw apiary syntax is provided to a function which parses it into an apiary object. From there, one can produce any code sample at run-time (when the user switches in the browser), rather than at compile-time (when you render the page).

    Just a thought.

    1 vote
    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…)
      1 comment  ·  Admin →
    • Choose a more subtle font fallback for non ASCII characters

      The current font used for headers (Helvetica) does for some reason not contain many accented variants such as ť, č etc. It would be great if it was replaced with a font better covering foreign characters (Helvetica Neue).

      1 vote
      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…)
      • Support for return multi HTTP Status Code

        For example, an API to check if you are following a user, when the result is 'YES', return 204 status code, else return 404 status code.

        1 vote
        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…)
        • Get a Favicon

          I thought you had a designer on you team!

          4 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…)
            completed  ·  ZZ responded

            Yay, we have that favicon captured. For quite some time now. Thanks for reminding.

          • Application login should use SSL

            To protect user password, login page should be on https page.

            0 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…)
              completed  ·  0 comments  ·  Admin →
            • Try the API from the docs simular to Swagger

              Swagger has convenient way to try API calls from the web page. Maybe Apiary does as well but I wasn't able to figure it out.

              6 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…)
                completed  ·  Jakub KorálJakub Korál responded

                The requested feature “All we want is Try It out…” is now live and deployed.

                Go to Documentation > any resource > tab “Try it” (next to Example / Debugger / Comments) and enjoy.

                One click simplicity and beauty in an easy step.

              • detect content-type +json suffix

                Even though still an Internet-Draft http://tools.ietf.org/html/draft-ietf-appsawg-media-type-suffix-regs-00, it's rather wide-spread to consider application/vnd....+json to have the same syntax as application/json. I believe that +xml has a higher level of adoption.

                So, when colorizing the payload based on the content-type, would be nice to look also at these suffixed content-types.

                1 vote
                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…)
                  completed  ·  Lukas LinhartLukas Linhart responded

                  +json now forces proper brush

                  In inspector, JSON diff is now used regardless of content-type send if payload is parseable JSON.

                • Don't refresh the page when I save changes

                  It's frustrating on a large API to scroll back down to the area you were just editing

                  1 vote
                  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…)
                  • Be able to disable comments

                    For variety of reasons, it may make sense to disable comments in documentation.

                    Add a switch in settings for it.

                    3 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…)
                    • Fix Response/Call body diff

                      Body diff does not work. It does not parse newline chars correctly.
                      http://i45.tinypic.com/i35nuq.png

                      1 vote
                      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…)
                        completed  ·  Lukas LinhartLukas Linhart responded

                        Currently diff works on text/line-based basis. We will offer JSON/XML tree diffs in the future.

                        However, this was bug caused by condensing multi-line responses into one and has been fixed.

                      • Maintain invite code when clicking "sign up with github"

                        When hitting an invite link, it'd be great if the invite code itself that showed on the first form was still set on the Github signup form.

                        1 vote
                        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…)
                        • Preview Documentation without saving

                          I'm used to being able to either see a live preview of my markdown code or at least have a way to preview it to make sure i didn't mess anything up before saving.

                          5 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…)
                            completed  ·  Lukas LinhartLukas Linhart responded

                            Local preview is supported via apiary client.

                            Client is distributed as ruby gem: you can install it via (sudo) gem install apiary.

                            Use apiary —help to display usage, README is available in repository: https://github.com/apiaryio/apiary-client#apiaryio

                            Please feel free to submit bug reports/patches to our github repository.

                          • 1 vote
                            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…)
                            • Generated curl command doesn't include -XGET

                              curl defaults to POST if --data is present

                              1 vote
                              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…)
                              • The home button, it does nothing!

                                Checked FF and Chrome

                                1 vote
                                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…)
                                • Bracket Matching in UI

                                  Can you make the matching bracket 'flash' whenever you close a bracket, please please pretty please :)

                                  1 vote
                                  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…)

                                    we’ve just rolled out a massive update to the code editor, including bracket matching, syntax highlighting, support for XML and JSON etc.

                                  1 2 3 5 Next →
                                  • Don't see your idea?

                                  General

                                  Feedback and Knowledge Base