Requests made to the ShipEngine APIs are done using HTTP verbs for each action. Below are the common verbs we support:
|GET||Retrieves a set of resources from a server.|
|POST||Creates a set of resources.|
|PUT||Updates or creates resources and collections.|
|DELETE||Deletes a resource.|
|PATCH||Modifies a resource.|
We use the REST Uniform Resource Identifier (URI) standard using a short string of numbers, letters, and symbols. A URI identifies a web resource such as an image, video or even a CSS file by using the location, name, or both.
URIs have the following structures:
- Scheme is the component which specifies the protocol that needs to be used to access the resource.
- Authority can be the name of the computer. It can also be a domain name or an IP address where the content is hosted.
- Path is a sequence of directories separated by slashes to define the location of a resource.
- File the name of the file where the resource is contained.
Below are a few URI examples:
mailto:firstname.lastname@example.org \─|─/ \─────────|──────────/ scheme path
https://app.shipengine.com/#/portal/apimanagement \─|─/ \──────|────────/ \───────|──────────/ scheme authority path