Fax Signature Service Authentication with airSlate SignNow

Merge signature service order

welcome to this video series for people who are new to postman in this video we'll take a closer look at how you can authorize a request in postman not all api s-- can be accessed without providing some kind of authorization so that the api knows exactly who we are and if we are allowed to perform some actions as for this example we're gonna use the github api feel free to register for a new account if you don't have one once you are logged in from the right corner click on your image go to Settings and from the Left menu go to developer settings and click on on access tokens let's generate a new token I'm going to write here postman so that I know for what I have created is Tobin right here below the only scope that we'll need is repo and I'm going to click on that and that should be enough click on January token simply copy this token and let's go back into postman now the token that we have created is linked to our own github account and this token shouldn't be shared with anybody else for that reason let's make sure that we don't accidentally include this token in our collection in order to separate the concerts we are going to create a new environment and save this information there in order to create an environment simply click here on manage environment I'm going to create a new environment I'm gonna name my environment github API so that I know why I have created this specific environment and next what I'm going to do is I'm gonna create a variable and gonna call it token I'm gonna leave the initial value empty and for the current value I'm gonna paste the value that I have received from the github website initial value and current value are very important if I later decide to share this environment with somebody else they will not be able to see the current value so for that reason current value is always private to your account and initial value is what anybody else will be able to see if I decide to share this environment so for that reason I do not want to put the token in the initial value because then somebody else might get access to this token which I want to keep private okay that's about it so let's simply click on add and in the list of environments you will now see that we have two github API as an environment and we can quickly see what's inside that environment and you will see that a token has this specific value and you will be using that in a few minutes the documentation for the github API is available at developer github.com and describes how you can interact with this API now every time we start using a new API it's important to read the documentation and what we are trying to do is to create a new repository so in order to create a new repository there are a few pieces of information that we need to put together first of all it says in the documentation that all requests go to API that github.com so I'm going to simply select and copy this and create a new request in postman now the next thing I want to do is to navigate through different categories that are available in the API so we said we want to create a new repository for that reason it makes sense to go here to repositories and to see if there's any information regarding how to create a new repository now I can see from this list that I have hit the option create so let's go ahead and see exactly what we are talking about you'll notice right from the beginning that this will be a post request and that request needs to go to this address so let's copy this additional information and put that in postman as well so from the list of HTTP verbs I'm gonna select post this time and I'm gonna add the rest of the address to the address field within the documentation you will notice a lot of parameters that are available and the only parameter that is actually required is name and that is the name of the repository right here below you will find a very simple example on how to create a repository and this is in the JSON format and we're going to need to send this as part of the post request that we create so let's simply copy and paste it in postman in order to add this information to postman and an open the body part of the request and I'm gonna select raw and I'm gonna paste this information in order to make it nice instead of text I will select Jason and if I'm not happy with the format I can even click on this beautify it will make it look nicer now let's go ahead and submit this request and to see if it works in the first thing that you will notice is that the status that is being returned is 401 and 401 means that we are not authenticated so we are trying to create a repository but github doesn't know we are because we haven't provided any authentication so for example we haven't provided our username and password or in our scenario we haven't provided this token that we have created and this token allows could help to understand this token is associated with this account and can check if we are allowed to create a new repository in order to provide this all to token we can use the built-in authorization helpers in order to do that I'm going to go to authorization and if I select from the list I'll see here different options that are available now there are different ways to authenticate against a specific API and each API may have its own particularities so for that reason it would be hard to go into each and every scenario our case is pretty simple because we already have a token and we just need to provide it so for that reason I'm gonna select beer token and all I have to do is to input the token here now we have already created an environment and have saved that information there in order not to include this sensitive information in the collection now in order to access this variable that we have created the syntax in order to do this is to put the variable name between double curly braces so this will go like this and I can select token and it will be recognized by postman and I can type it there so the name of the variable is inside and at the beginning and at the end they are double curly braces if I hover over it I'll be able to see the current value and that is the value of the token and that shows me that this information is there and that I have written the variable properly if I don't have the environment selected so if I select no environment and I go over this variable you will see that this variable is not resolved so postman doesn't know what I am referring to because I haven't defined another token variable somewhere else now let's go ahead and submit this request and see if it works the API responds with 201 as a status code which means created so the repository the resource that we wanted to create has been successfully created so now github has understood our request was managed to match our token with our account and if you now look inside your account you will see that you have a new repository in which you can put your application code or anything else that you are interested in so at the beginning this way of creating the repository is totally fine so I'm gonna create a new collection and save this request inside our collection let's call this request create repository and I'm not gonna save it inside the github chops API this is the other collection that I have created I'm going to create a completely new collection and I'm gonna simply call it github API so to sum everything up we had a look at how you can authorize a request in postman and we have done that by creating an oauth2 token within the github interface and we have used that token as a beer authentication in postman using one of the postman authentication helpers if you have any issues getting this to run make sure you take a quick look at the video description for some troubleshooting ideas or feel free to post a comment in the section below see you in the next video