Expose webhook documentation in apim - webhooks

To clarify the title I am not thinking of the registering to a webhook through APIM, but to utilize APIM as my documentation for all API related information.
In our setup we wanted to also expose information about possible json objects from our webhooks and saw that this exists in OAS3.1. And azure APIM supports OAS3.1 for import. However importing a test webhook results in an error saying that it isn’t supported
This example was taken from OAS GitHub. So I know I can cheat and creat a dummy endpoint to allow people to view the documentation - but it is not ideal for our use case.
So the questions are:
how to expose the webhook documentation?
am I missing something in Microsoft documentation because I cannot see that it should not be allowed what I wanted to do?

Related

What is the Integration Account Callback URL for?

The Azure Integration Account features a tab on its configuration blade labelled "Callback URL":
This is documented in terms of generated API documentation but this doesn't say anything about its purpose. I can't find any documentation that mentions it.
What is this URL for?
Basically the callback uri we are using for reverifying/recheck the details of our integration account that we created earlier so that we can see properties of it. Likewise, we use jwt.io to see the content of any token.
For example:-
You can generate the callback url of an integration account using the below api with post method by passing the following parameter as mentioned in this MS DOC:-
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/integrationAccounts/{integrationAccountName}/listCallbackUrl?api-version=2016-06-01

DocuSign Admin API OpenAPI / SDK

I'm using the DocuSign eSignature API, and am generating client code with the help of the openapi codegen (via these https://github.com/docusign/OpenAPI-Specifications).
Now I have to use the DocuSign Manage API (https://developers.docusign.com/docs/admin-api/), too, but I can't find any Swagger / OpenAPI definition for that?
Is it somewhere hidden, does it not exists, and are there plans to make it available at one point? Are there any other options, SDKs, anything or do I have to make these calls "manually"?
Unfortunately, the Swagger file for the Admin API is not yet available.
That's also why DocuSign doesn't yet have SDKs for the API yet.
I don't have access to any scheduling information on it.
I suggest that you handle any Admin API calls you need to do manually for now.
What language are you creating SDKs for with CodeGen? (Please answer in a comment or by editing your original question.)

How to call docusign apis for sending envelopes in node.js?

I have a standard DocuSign account and I want to add an integration key but I am not able to add that key as there is no option to in my standard account to add the key. Further, I want to hit DocuSign API either through nodejs-sdk or postman to create and send an envelope with the use of the template. So, for this what should I do? Can anybody help, please?
Sounds like you're just getting started with the DocuSign eSignature API. Welcome! We have a variety of resources that you will find helpful.
I would start here on the DocuSign Developer Center.
To begin experimenting with our API, you'll first need to create a demo sandbox account. Within this account, you can provision your own integrator keys. Later down the road, you will follow our "Go-Live" process to transition your integration to our paid, production environment.
Once you have your account created, I would suggest you check out this quickstart code example.
That should get you started!
You should create a new developer/sandbox account to create an integration key. You cannot do that in production.
For node.JS we have a few different resources you can use, the most complete one is our code example "launcher" that can be used as a full app to try the code. We also have a quickstart that you an use without configuring the API authentication part.

How to make 3rd party api call in dialogflow's inline editor

How to make 3rd party api call in dialogflow using inline editor please share if you have some code regarding this.
Thank you
You cannot make external network requests (for example an API call) from the inline editor. You need to deploy your code elsewhere. The easiest way to do this is by deploying to a paid Firebase plan. From Google:
Network calls originating from your Cloud Function for Firebase to destinations outside Google's network require billing to be enabled for the underlying Google Cloud or Firebase project.
You can create an API with the technology that you want, as long as the response from the API can be understand by Dialogflow.
You need to configure it by going to Fulfillment, and point it to your API.
The API needs to respond with this structure: Dialogflow.
And If you plan to integrate with Actions on Google, you have this repository which includes some examples of responses.
And here you have some libraries to interact with Dialogflow with different languages.

How to access a gmail account I own using Gmail API?

I want to run a node script as a cronjob which uses Gmail's API to poll a gmail account I own.
I am following these quickstart instructions:
I'm stuck on the first step. When requesting credentials for a cron script it tells me that "User data cannot be accessed from a platform without a UI because it requires user interaction for sign-in":
The docs are confusing in general, and mention "service accounts," "OAuth," and other things -- I cannot tell which apply to my use-case and which don't. I've used many SaaS APIs, and the typical workflow is to login to your account, get an API key and secret, and use those in your script to access the API. It seems this is not the paradigm used by the Gmail API, so I'd appreciate any guidance or links to clearer instructions.
I also find that the documentation can be confusing at times, but what you want to to is actually pretty straight forward once you get it:
Register your App at Google, and say what APIs you want your App to have access to (only the Gmail API in this case). This will give you two strings, a client_id and a client_secret (which is the content of the client_secrets.json-file above).
Since you are just going to write a script for your own account only, you don't need a http-server. The Oauth Playground will suffice. Press the Settings Cog on the top right and use your own OAuth credentials.
Select the Gmail API in the list of APIs and follow the outlined steps.
Now you have an access_token and a refresh_token you can use to keep your script going indefinitely!
To fully understand the use of Gmail API, going through Gmail API Overview really will make a difference.
And you can also use these documentations to start building a Gmail app:
The client libraries are available for download in several languages and simplify making API requests.
The developer guide topics help you better understand how to implement particular use cases.
The API reference gives you details on every resource and method in the Gmail API.
I hope these help.

Resources