Lukas LinhartLukas Linhart

My feedback

  1. 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…)
      under review  ·  2 comments  ·  General  ·  Admin →
      Lukas LinhartLukas Linhart commented  · 

      Hi,

      could you also please send us list of fonts you have installed?

      We are trying to pinpoint the issue, so all information possible is helpful (linux version, fonts installed, X Window Settings etc.)

      Thanks!

      Lukas

    • 133 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…)
        14 comments  ·  General  ·  Admin →
        started  ·  ZZ responded

        Updated information.

        You can already describe URI parameters in structured way with the new API Blueprint format. Refer to https://github.com/apiaryio/api-blueprint/blob/master/examples/7.%20Parameters.md for details.

        The new format is now default and URI parameters are properly rendered in the documentation.


        We are still working on description of http message–body properties (parameters). It is planned in the upcoming revision 1B of API Blueprint – as discussed in https://github.com/apiaryio/api-blueprint/issues/25

        Lukas LinhartLukas Linhart commented  · 

        Hi Ilja,

        this is because body parameters are not supported yet, but they are one of the top things on our TODO.

        In JSON, you can describe them using JSON schema, but we are not rendering them in documentation properly yet.

        Coming soon. Stay tuned!

        Lukas

        Lukas LinhartLukas Linhart commented  · 

        Boris, please be assured that we are not ignoring this request, we are just thinking very hard about the solution as we don't want to compromise the simplicity of our format.

        We are also aware of the problems with onboarding into blueprint syntax, this is already in making and will hopefully help you all.

        Please stay tuned, you are not forgotten :)

        Lukas LinhartLukas Linhart commented  · 

        Hi,

        looking at dwolla, input parameter description in that way can be done already: just use markdown tables in resource description.

        We are thinking about ways to treat them like "variables". Our current approach is to use URI-templates-like syntax. Implementation is under way and is currently in beta stage. If you are interested, please vote / subscribe to this feedback http://apiary.uservoice.com/forums/120125-general/suggestions/2950994-support-path-parameters and we will let you know how things are moving.

        Does that solve your case?

        Regards,

        Lukas

      • 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…)
          6 comments  ·  General  ·  Admin →
          Lukas LinhartLukas Linhart commented  · 

          Hi,

          subresources sound like a bug and we'll look into it.

          Regards,

          Lukas

          Lukas LinhartLukas Linhart commented  · 

          Hi,

          problem is that parenthesis are special characters in URL templates. Thus, I am not sure how to express this fact when you want to use some parts of the standard ({}), but don't want to use the other one (normal parenthesis).

          Do you have some ideas?

          Thanks,

          Lukas

        • 17 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…)
            1 comment  ·  General  ·  Admin →
            Lukas LinhartLukas Linhart commented  · 

            Hi Bob,

            just to let you know: our new blueprint format will be completely markdown-based, so you might utilise markdown support in any of your favourite editor.

            I'd still like to improve our online editor experience though, so we might get to this one in the future.

            Regards,

            Lukas

          • 20 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…)
              under review  ·  5 comments  ·  General  ·  Admin →
              Lukas LinhartLukas Linhart commented  · 

              Hi Christian,

              thanks for your submission! We think this is a valid use-case indeed, we are just yet to figure it out syntactically.

              Any suggestions on this is welcome!

              Regards,

              Lukas

            • 62 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…)
                planned  ·  4 comments  ·  General  ·  Admin →
                Lukas LinhartLukas Linhart commented  · 

                Hi Andrej,

                thanks for your idea! We certainly plan to do that, we have just no yet decided about the syntax and supported variables / parameters.

                Regards,

                Lukas

                Lukas LinhartLukas Linhart shared this idea  · 
              • 2 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…)
                  1 comment  ·  General  ·  Admin →
                  under review  ·  Lukas LinhartLukas Linhart responded

                  In a few days, there will be an API available so 3rd parties can integrate with any VCS they want to.

                  Lukas LinhartLukas Linhart commented  · 

                  Hi simo,

                  unfortunately, we cannot defocus ourselves to support SVN yet.

                  However, I am writing an integration API that will allow you to publish new blueprint versions from command line. With that. it should be fairly straightforward to write SVN post-commit hooks.

                  I cannot promise I'll have time to do it, but we welcome 3rd party additions and will happily promote it should somebody write them.

                  I'll send an update once API is officially available.

                  Regards,

                  Lukas

                • 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…)
                    3 comments  ·  General  ·  Admin →
                    under review  ·  Lukas LinhartLukas Linhart responded

                    We are revamping our documentation and we’ll see if this use case is still valid after redesign.

                    Lukas LinhartLukas Linhart commented  · 

                    Hi Rodrigo,

                    may I ask what your use-case is? What are you trying to achieve?

                    Regards,

                    Lukas

                  • 2 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…)
                      1 comment  ·  General  ·  Admin →
                      Lukas LinhartLukas Linhart commented  · 

                      Hi,

                      before diving in: what specific features you think would help you?

                      How could Apiary help you with hypermedia/HATEOAS?

                      Regards,

                      Lukas

                    • 12 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…)
                        3 comments  ·  General  ·  Admin →
                        Lukas LinhartLukas Linhart commented  · 

                        Hi Nayef,

                        as this is needed for some of our other features, you should expect it in a few weeks.

                        Regards,

                        Lukas

                      • 75 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…)
                          6 comments  ·  General  ·  Admin →
                          started  ·  Lukas LinhartLukas Linhart responded

                          We have started to work on some OAuth2 support and testing it with some customers.

                          Current status is “very alpha”; you can only mark the whole API as being authenticated and we do not provide any support for mock server yet.

                          Lukas LinhartLukas Linhart commented  · 

                          Hi Matheus,

                          we plan to work on authentication right after our blueprint format overhaul. OAuth will definitely be part of it.

                          Regards,

                          Lukas

                        • 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…)
                            1 comment  ·  General  ·  Admin →
                            planned  ·  Lukas LinhartLukas Linhart responded

                            This is definitely good observation and we plan to overhaul it in our inspector overhaul.

                            Lukas LinhartLukas Linhart commented  · 

                            Hi ingram,

                            our current plan is to validate according to schema if available, but still fail against different mock data if schema was not written -- otherwise, basically every request would pass.

                            Does that make sense for you?

                            Regards,

                            Lukas

                          • 2 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…)
                              under review  ·  0 comments  ·  General  ·  Admin →
                              Lukas LinhartLukas Linhart shared this idea  · 
                            • 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…)
                                under review  ·  2 comments  ·  General  ·  Admin →
                                Lukas LinhartLukas Linhart commented  · 

                                Ryan, just an idea -- if we would add apiary github user that you would add as a team member on your particular repo, would that solve your problem?

                              • 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…)
                                  under review  ·  2 comments  ·  General  ·  Admin →
                                  Lukas LinhartLukas Linhart commented  · 

                                  Hello,

                                  thanks for the input. There are some similar requests and it all basically boils down to "filter resources using some criteria".

                                  We'll definitely put some thoughts into that.

                                  Regards,

                                  Lukas

                                • 86 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…)
                                    11 comments  ·  General  ·  Admin →
                                    started  ·  Lukas LinhartLukas Linhart responded

                                    Undocumented pre-alpha is live, but not all in-product edges are fine-tuned properly.

                                    Please let us know (e-mail to support@apiary.io) if you want to use this feature, we will give you a howto.

                                    Lukas LinhartLukas Linhart commented  · 

                                    Hi,

                                    thanks for you interest; you both should have e-mail from me in your inbox.

                                    Regards,

                                    Lukas

                                    Lukas LinhartLukas Linhart commented  · 

                                    Hi Bill,

                                    good point again. This is planned as part of http://apiary.uservoice.com/forums/120125-general/suggestions/3066163-support-data-structures (with importing structures from other files, yes).

                                    We'll keep you posted.

                                    Thanks,

                                    Lukas

                                    Lukas LinhartLukas Linhart commented  · 

                                    Manifest approach is a good point, we'll think about that.

                                  • 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…)
                                      under review  ·  0 comments  ·  General  ·  Admin →
                                      Lukas LinhartLukas Linhart shared this idea  · 
                                    • 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…)
                                        under review  ·  1 comment  ·  General  ·  Admin →
                                        Lukas LinhartLukas Linhart commented  · 

                                        Hi,

                                        thanks for you input.

                                        "Groups" can be created via heading:

                                        -- Group name --

                                        , but if I understand you correctly, You (as a user) would like to collapse/expand them, or display only them (so basically show a resource group on separate page)?

                                        Personally, I don't see much value to filter resources in documentation based on call type, but the case above totally makes sense for me.

                                        Is my assumption correct?

                                        Thanks,

                                        Lukas

                                      1 3 Next →

                                      Feedback and Knowledge Base