How to group REST API in micronaut? - swagger-ui

I use Micronaut #Version to implement my REST API Versioning strategy, and I use header X-API-VERSION to carry the version number, but I don't know how to group different version of REST API endpoints with Micronaut-openapi. I can do that in SprintBoot by customizing GroupedOpenApi, but I cannot do that in micronaut. Could anyone please help me with this? Thanks.

Related

Can you suggest really good documentation to add google+ OAuth2 to an openapi v3 document running in swagger-ui?

Basic authentication is working fine in my openapi v3 document running in swagger-ui. Now I want to add Google+ oauth2 authentication. Can you point me to good newbie documentation how to do this?
I find the configuration options a bit overwhelming as I don't know what options to choose. Most examples I find using a google search seem to be swagger v2 based or result in me thinking I'm an idiot (which may be the case, but I think it has more to do with knowing little about google oauth flows).
The OpenAPI Specification supports the description of OpenID Connect authorization, however Swagger-UI and Editor have not yet implemented it.
The lack of this functionality has been added to the GitHub swagger/swagger-ui issues #3641 list of features not yet supported by Swagger-UI.

Swagger 3.0.1 and oAuth1

Currently, there is no oAuth1 support in OpenApi 3.0.1 specifications
I need to indicate that some endpoints require an oAuth1.
May someone has some ideas, insights how to do it?
I'm not expecting to have a full swagger functionality,
Just a visualisation that this endpoint is secured or not secured.

Gcloud, ruby on rails, speech to text

I am trying to use Google's new speech to text api: https://cloud.google.com/speech/docs/rest-tutorial . They currently have python and node.js examples.
Unfortunately, my application is RoR. I was looking through https://github.com/GoogleCloudPlatform/gcloud-ruby , which is a gem that interacts with google cloud services (but not speech). I was hoping that I could use the two together to come out with a working solution, but my knowledge of how to use API's is limited.
Enough background, my questions are:
Does anyone know if Google is going to put out a Ruby version of the speech to text api? If yes, is there a timeline?
If I am impatient, how would I go about using their current API's. By this I mean, is there a good resource for someone to learn how to use generic API's?
The gcloud-ruby gem now supports google-cloud-speech.
To address your other questions, there are no language specific versions of the APIs themselves. They are all HTTP APIs (either REST or gRPC), so they can be used from anything that can make HTTP requests. It can be tricky to use them directly though, because of things like how authentication is handled, which is why client libraries exist for different languages.
If you want to learn more about how to use the REST APIs directly, first take a look at the doc 'Using OAuth 2.0 for Web Server Applications' to find out how to manually authenticate, which has examples for Ruby and raw HTTP/REST.

SurveyMonkey Metadata API availability

I am exploring SurveyMonkey APIs for version 3.
I would like to know is there any Metadat API available to get the comprehensive request-response structure for all the endpoints available for SurveyMonkey?
I could not find any such details on the documentation :
https://developer.surveymonkey.com/api/v3/#getting-started
If no do you plan to support it in future.
Thanks
There is no current plan at SurveyMonkey to provide a Metadata API. What is your use case for such an API?
It may be added to the roadmap if there is enough value, but currently there is no plan.

how to read data from api without any gem rails 3

I want to read data from an API ean without using any gem. What I want is when the user searches for a particular hotel then my query should return me a data from ean.
How can I go about this thing? and how/where do I add the api key and secret ?
You can perform HTTP requests in Ruby using the Net::HTTP standard library.
Most people prefer to use third party Gems because they offer additional features or cleaner API, compared to Net::HTTP.
However, most of them is based on Net::HTTP itself.
Its a soap API you can use savon to build your own class to access that api. YOu will find a screencast for savon here: http://railscasts.com/episodes/290-soap-with-savon I had a look at the documentation its pretty well documented.

Resources