chore: updates API reference docs

2020-12-15 13:49:45 +01:00
parent 14585a7b32
commit 34e6c52745
16 changed files with 1149 additions and 423 deletions
@@ -0,0 +1,61 @@
+title: Product variants
+domain: store
+routes:
+  - method: GET
+    path: /product-variants
+  - method: GET
+    path: /product-variants/:id
+route: /product-variants
+description: >
+  A product variant represents a specific type of product. E.g. a variant can differ from other variants based on size and color. A variant will always belong to a product.
+endpoints:
+  - path: /:id
+    method: GET
+    title: Retrieve product variant
+    params:
+      - name: id
+        type: String
+        description: Id of the product variant.
+    description: >
+      Retrieves product variant
+  - path: /
+    method: GET
+    title: List product variants
+    params:
+      - name: ids
+        optional: true
+        type: String
+        description: String of product variant ids. Id's needs to be separated by comma.
+    description: >
+      Retrieves product variants. Specific variants can be retrieved using `ids` query param in the request.
+
+response: |
+  {
+    "region": {
+      "id": "reg_HMnixPlOicAs7aBlXuchAGxd",
+      "name": "Denmark",
+      "currency_code": "DKK",
+      "currency": "DKK",
+      "tax_rate": 0.25,
+      "tax_code": null,
+      "countries": [{
+        "id": "1001",
+        "iso_2": "DK",
+        "iso_3": "DNK",
+        "num_code": "208",
+        "name": "denmark",
+        "display_name": "Denmark"
+      }],
+      "payment_providers": [{
+        "id": "stripe",
+        "is_installed": true
+      }],
+      "fulfillment_providers": [{
+        "id": "manual",
+        "is_installed": true
+      }],
+      "created_at": "2020-12-11T17:03:54.458Z",
+      "updated_at": "2020-12-11T17:03:54.458Z",
+      "metadata": null
+    }
+  }