Build Your Own Customer Portal (Advanced)

Working with the ''/s/customer'' endpoint

The /s/customer endpoint is a bit different than the other public-facing endpoints in Foxy. Some notes:

• CORS: You must specify the domains from which your customer portal will function. This prevents certain types of attacks or unauthorized access against your users. Note that this does prevent use of certain super old browsers, but that's probably for the best.

• REST: In general, GET requests are for retrieving (and not modifying) data. POST is to create something new. PATCH is for modifying existing things.

  • Do not include a body in GET requests.

• Request Bodies: For POST and PATCH, you should submit a JSON object in the body of the request.

• Version Header: Pass a header of “FOXY-API-VERSION”: “1” with your requests

• Successful Requests: A 200 status code indicates a successful request/response, and will have a JSON payload.

• Errors: Error responses will use the appropriate HTTP response code (ie. non-2XX or 3XX), and will generally be JSON that looks something like this:

  Copy Copied

  {
      "type": "authentication",
      "code": "422",
      "message": "`password` not defined or invalid."
  }