Anatomy of a Request

All REST API requests require:

  • a METHOD (GET, POST, PATCH/PUT, DELETE)
  • an ENDPOINT (https://{host}/{endpoint}...?access_token=...) - the location within an API URL structure that encompasses the objects or entities that can be
     manipulated by identified actions available at that location
  • POST / PATCH / PUT may require raw JSON content dependent upon intended action (samples are provided throughout the documentation when raw JSON content is commonly required)
  • an access_token, an active session identifier that the API utilizes to validate security access to the configured account(s)

GET Request Format

  • METHOD = GET (generally used to obtain, query existing records from a system)
  • an ENDPOINT (https://{host}/{endpoint}...?access_token=...)

POST / PATCH / PUT Request Format

  • METHOD = POST / PATCH / PUT (generally used to create new, or add to/update, existing records within a system)
  • an ENDPOINT (https://{host}/{endpoint}...?access_token=...)
  • Content-Type: "application/json"
    • Use Content-Type: "application/x-www-form-urlencoded" for POST Authorization Request
  • RequestBody: ensure JSON for the request is placed here

DELETE Request Format

  • METHOD = DELETE (generally used to remove a record from a system)
  • an ENDPOINT (https://{host}/{endpoint}...?access_token=...)