This page is about the requests you make to do things through our API, not the requests used in Rev.io to quote customers and order new services.
A request is a message asking for something. When you make an API request, you're asking us to perform the type of action you've specified in your message.
- Get information about a customer
- View report results
- Download a PDF of a quote
A request is made up of different parts, including an endpoint, a method, any parameters, and authorization information.
Our API explorer lists all our resources, as well as our available methods and parameters.
The method of a request tells us, in general, what you want to do with the resource. For example, if you wanted to view a product, you would use the GET method, rather than something like DELETE.
Parameters give us more detail about what you want to do, including which specific resource you want to work with. Using our same product example, you could include a product ID in your request, to tell us you want to get information about that specific product.
Generally, your requests need to be authorized. By including authorization information, you tell us who you are and whether you're allowed to do what you want to do.
Again continuing the product example, if you weren't allowed to view your organization's product catalog, we wouldn't want to give you information about any products. Instead, we would send you an "Unauthorized" status code.