Requests made to the ShipEngine APIs are done using HTTP verbs for each action. Below are the common verbs we support:
Verb | Description |
---|---|
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. |
REST URIs
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:example@shipengine.com \─|─/ \─────────|──────────/ scheme path
https://app.shipengine.com/#/portal/apimanagement \─|─/ \──────|────────/ \───────|──────────/ scheme authority path