When making calls to fabric APIs, you must use the following HTTP headers to provide context.

  • --header: This flag is used to include headers in the request. The most commonly used headers in fabric APIs are:
    • x-fabric-tenant-id: This is a custom header used by the API to identify the tenant making the request. You can find the tenant-id in Copilot.
    • Content-Type: application/json: This tells the server that the data being sent in the request is in JSON format.
    • Authorization: Bearer: This is the authorization token used to authenticate the request. You must pass the access token generated from the system app.
    • x-fabric-channel-id: This is a custom header, used to identify the channel through which the request is being made. This is primarily used for a multichannel use case. Usually, the default value is 12 (US).

fabric API responses are in JSON format.

Prerequisites

Before you can start using fabric APIs:

Procedure

The following steps use Create attribute as an example:

  1. Log in to Postman client.
  2. In the left menu, click Import The import window will display.
  3. In the import window, copy and paste the following code:
   curl --request POST \
   --url https://api.fabric.inc/v3/product-attributes \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer <token>' \
   --header 'x-fabric-tenant-id: <tenant-id>' \
   --data '{
      "name": "Category datetime example",
      "isLocalizable": false,
      "target": "CATEGORY",
      "type": "DATETIME",
      "validation": {
         "isMandatory": false,
         "isManualOverwrite": false,
         "formula": "",
         "dateFormat": "MM/DD/YYYY"
      }
   }'  
  1. To populate the headers, click the Headers tab and do the following:
  2. Click Send.