spree_api_v2 0.2.0

data/docs/source/includes/_states.md

@@ -0,0 +1,96 @@
+# States
+
+## List States
+
+```shell
+curl "https://kabuni.com/api/v2/states"
+```
+
+```json
+{
+  "data": [
+    {
+      "id": "1",
+      "type": "spree_states",
+      "attributes": {
+        "name": "Canillo",
+        "abbr": "02"
+      },
+      "relationships": {
+        "country": {
+          "data": {
+            "type": "spree_countries",
+            "id": "1"
+          }
+        }
+      }
+    }
+  ]
+}
+```
+
+This will list all of the states.
+
+## Show State
+
+```shell
+curl "https://kabuni.com/api/v2/states/1"
+```
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "spree_states",
+    "attributes": {
+      "name": "Canillo",
+      "abbr": "02"
+    },
+    "relationships": {
+      "country": {
+        "data": {
+          "type": "spree_countries",
+          "id": "1"
+        }
+      }
+    }
+  }
+}
+```
+
+Select a state via its `id`.
+
+## Show Country of a States
+
+```shell
+curl "https://kabuni.com/api/v2/states/1/countries"
+```
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "spree_countries",
+    "attributes": {
+      "iso_name": "ANDORRA",
+      "iso": "AD",
+      "iso3": "AND",
+      "name": "Andorra",
+      "numcode": 20,
+      "states_required": true
+    },
+    "relationships": {
+      "states": {
+        "data": [
+          {
+            "type": "spree_states",
+            "id": "1"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+View the country that a state belongs to via the state's `id`.

data/docs/source/includes/_taxonomies.md

@@ -0,0 +1,325 @@
+# Taxonomies
+
+## List Taxonomies
+
+```shell
+curl "https://kabuni.com/api/v2/taxonomies"
+```
+
+```json
+{
+  "data": [
+    {
+      "id": "1",
+      "type": "spree_taxonomies",
+      "attributes": {
+        "name": "Category",
+        "position": 1
+      },
+      "relationships": {
+        "taxons": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "2"
+            },
+            {
+              "type": "spree_taxons",
+              "id": "1"
+            }
+          ]
+        },
+        "children": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "2"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
+```
+
+List of the taxonomies in the database.
+
+## Show Taxonomy
+
+```shell
+curl "https://kabuni.com/api/v2/taxonomies/1"
+```
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "spree_taxonomies",
+    "attributes": {
+      "name": "Category",
+      "position": 1
+    },
+    "relationships": {
+      "taxons": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "2"
+          },
+          {
+            "type": "spree_taxons",
+            "id": "1"
+          }
+        ]
+      },
+      "children": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "2"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Select a taxonomy via the `id`.
+
+## List Taxons of a Taxonomy
+
+```shell
+curl "https://kabuni.com/api/v2/taxonomies/1/taxons"
+```
+
+```json
+{
+  "data": [
+    {
+      "id": "2",
+      "type": "spree_taxons",
+      "attributes": {
+        "name": "SLEEP",
+        "permalink": "category/sleep",
+        "position": 0,
+        "description": null,
+        "meta_title": null,
+        "meta_description": null,
+        "meta_keywords": null,
+        "depth": 1,
+        "classifications_count": null
+      },
+      "relationships": {
+        "taxonomy": {
+          "data": {
+            "type": "spree_taxonomies",
+            "id": "1"
+          }
+        },
+        "parent": {
+          "data": {
+            "type": "spree_taxons",
+            "id": "1"
+          }
+        },
+        "children": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "3"
+            }
+          ]
+        }
+      }
+    },
+    {
+      "id": "1",
+      "type": "spree_taxons",
+      "attributes": {
+        "name": "Category",
+        "permalink": "category",
+        "position": 0,
+        "description": null,
+        "meta_title": null,
+        "meta_description": null,
+        "meta_keywords": null,
+        "depth": 0,
+        "classifications_count": 1
+      },
+      "relationships": {
+        "taxonomy": {
+          "data": {
+            "type": "spree_taxonomies",
+            "id": "1"
+          }
+        },
+        "parent": {
+          "data": null
+        },
+        "children": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "2"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
+```
+
+List all of the taxons that a taxonomy has a reference to.
+
+## Show Taxon of a Taxonomy
+
+```shell
+curl "https://kabuni.com/api/v2/taxonomies/1/taxons/1"
+```
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "spree_taxons",
+    "attributes": {
+      "name": "Category",
+      "permalink": "category",
+      "position": 0,
+      "description": null,
+      "meta_title": null,
+      "meta_description": null,
+      "meta_keywords": null,
+      "depth": 0,
+      "classifications_count": 1
+    },
+    "relationships": {
+      "taxonomy": {
+        "data": {
+          "type": "spree_taxonomies",
+          "id": "1"
+        }
+      },
+      "parent": {
+        "data": null
+      },
+      "children": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "2"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Find a taxon that the taxonomy owns via the taxonomy's `id` and the taxon's `id`.
+
+## List Children of a Taxonomy
+
+```shell
+curl "https://kabuni.com/api/v2/taxonomies/1/children"
+```
+
+```json
+{
+  "data": [
+    {
+      "id": "2",
+      "type": "spree_taxons",
+      "attributes": {
+        "name": "SLEEP",
+        "permalink": "category/sleep",
+        "position": 0,
+        "description": null,
+        "meta_title": null,
+        "meta_description": null,
+        "meta_keywords": null,
+        "depth": 1,
+        "classifications_count": null
+      },
+      "relationships": {
+        "taxonomy": {
+          "data": {
+            "type": "spree_taxonomies",
+            "id": "1"
+          }
+        },
+        "parent": {
+          "data": {
+            "type": "spree_taxons",
+            "id": "1"
+          }
+        },
+        "children": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "3"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
+```
+
+List all of the children of a taxonomy.
+This does _not_ include the root taxon that would be included when listing all of the taxons of this taxonomy.
+
+## Show Child of a Taxonomy
+
+```shell
+curl "https://kabuni.com/api/v2/taxonomies/1/children/2"
+```
+
+```json
+{
+  "data": {
+    "id": "2",
+    "type": "spree_taxons",
+    "attributes": {
+      "name": "SLEEP",
+      "permalink": "category/sleep",
+      "position": 0,
+      "description": null,
+      "meta_title": null,
+      "meta_description": null,
+      "meta_keywords": null,
+      "depth": 1,
+      "classifications_count": null
+    },
+    "relationships": {
+      "taxonomy": {
+        "data": {
+          "type": "spree_taxonomies",
+          "id": "1"
+        }
+      },
+      "parent": {
+        "data": {
+          "type": "spree_taxons",
+          "id": "1"
+        }
+      },
+      "children": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "3"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Fetch a child of the taxnomy via the taxonomy's `id` and the child's `id`.

data/docs/source/includes/_taxons.md

@@ -0,0 +1,414 @@
+# Taxons
+
+## List Taxons
+
+```shell
+curl "https://kabuni.com/api/v2/taxons"
+```
+
+```json
+{
+  "data": [
+    {
+      "id": "2",
+      "type": "spree_taxons",
+      "attributes": {
+        "name": "SLEEP",
+        "permalink": "category/sleep",
+        "position": 0,
+        "description": null,
+        "meta_title": null,
+        "meta_description": null,
+        "meta_keywords": null,
+        "depth": 1,
+        "classifications_count": null
+      },
+      "relationships": {
+        "taxonomy": {
+          "data": {
+            "type": "spree_taxonomies",
+            "id": "1"
+          }
+        },
+        "parent": {
+          "data": {
+            "type": "spree_taxons",
+            "id": "1"
+          }
+        },
+        "children": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "3"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
+```
+
+List all the taxons in the database.
+
+## Show Taxon
+
+```shell
+curl "https://kabuni.com/api/v2/taxons/1"
+```
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "spree_taxons",
+    "attributes": {
+      "name": "Category",
+      "permalink": "category",
+      "position": 0,
+      "description": null,
+      "meta_title": null,
+      "meta_description": null,
+      "meta_keywords": null,
+      "depth": 0,
+      "classifications_count": 1
+    },
+    "relationships": {
+      "taxonomy": {
+        "data": {
+          "type": "spree_taxonomies",
+          "id": "1"
+        }
+      },
+      "parent": {
+        "data": null
+      },
+      "children": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "2"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Locate the taxon that you're looking for via its `id`.
+
+## Show Taxonomy of a Taxon
+
+```shell
+curl "https://kabuni.com/api/v2/taxons/1/taxonomy"
+```
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "spree_taxonomies",
+    "attributes": {
+      "name": "Category",
+      "position": 1
+    },
+    "relationships": {
+      "taxons": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "2"
+          },
+          {
+            "type": "spree_taxons",
+            "id": "1"
+          }
+        ]
+      },
+      "children": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "2"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Display the taxonomy that a taxon belongs.
+
+## Show Parent of a Taxon
+
+```shell
+curl "https://kabuni.com/api/v2/taxons/2/parent"
+```
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "spree_taxons",
+    "attributes": {
+      "name": "Category",
+      "permalink": "category",
+      "position": 0,
+      "description": null,
+      "meta_title": null,
+      "meta_description": null,
+      "meta_keywords": null,
+      "depth": 0,
+      "classifications_count": 1
+    },
+    "relationships": {
+      "taxonomy": {
+        "data": {
+          "type": "spree_taxonomies",
+          "id": "1"
+        }
+      },
+      "parent": {
+        "data": null
+      },
+      "children": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "2"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Display the parent taxon that a taxon may belong to.
+
+## List Children of a Taxon
+
+```shell
+curl "https://kabuni.com/api/v2/taxons/1/children"
+```
+
+```json
+{
+  "data": [
+    {
+      "id": "2",
+      "type": "spree_taxons",
+      "attributes": {
+        "name": "SLEEP",
+        "permalink": "category/sleep",
+        "position": 0,
+        "description": null,
+        "meta_title": null,
+        "meta_description": null,
+        "meta_keywords": null,
+        "depth": 1,
+        "classifications_count": null
+      },
+      "relationships": {
+        "taxonomy": {
+          "data": {
+            "type": "spree_taxonomies",
+            "id": "1"
+          }
+        },
+        "parent": {
+          "data": {
+            "type": "spree_taxons",
+            "id": "1"
+          }
+        },
+        "children": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "3"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
+```
+
+List all the children that a taxon has.
+
+## Show Child of a Taxon
+
+```shell
+curl "https://kabuni.com/api/v2/taxons/1/children/2"
+```
+
+```json
+{
+  "data": {
+    "id": "2",
+    "type": "spree_taxons",
+    "attributes": {
+      "name": "SLEEP",
+      "permalink": "category/sleep",
+      "position": 0,
+      "description": null,
+      "meta_title": null,
+      "meta_description": null,
+      "meta_keywords": null,
+      "depth": 1,
+      "classifications_count": null
+    },
+    "relationships": {
+      "taxonomy": {
+        "data": {
+          "type": "spree_taxonomies",
+          "id": "1"
+        }
+      },
+      "parent": {
+        "data": {
+          "type": "spree_taxons",
+          "id": "1"
+        }
+      },
+      "children": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "3"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Find a child via its `id` and its owners (taxon) `id`.
+
+## List Products of a Taxon
+
+```shell
+curl "https://kabuni.com/api/v2/taxons/1/products"
+```
+
+```json
+{
+  "data": [
+    {
+      "id": "10",
+      "type": "spree_products",
+      "attributes": {
+        "name": "Spree Ringer T-Shirt",
+        "description": "Velit nemo odio ducimus nobis non doloremque beatae sunt. Totam quia voluptatum perferendis tempore sed voluptate consequuntur. Sit id corporis autem veritatis reprehenderit.",
+        "slug": "spree-ringer-t-shirt",
+        "meta_description": null,
+        "meta_keywords": null,
+        "store_name": "Whole New Home"
+      },
+      "relationships": {
+        "master": {
+          "data": {
+            "type": "spree_variants",
+            "id": "10"
+          }
+        },
+        "variants": {
+          "data": []
+        },
+        "taxons": {
+          "data": [
+            {
+              "type": "spree_taxons",
+              "id": "1"
+            }
+          ]
+        },
+        "option_types": {
+          "data": [
+            {
+              "type": "spree_option_types",
+              "id": "1"
+            }
+          ]
+        },
+        "images": {
+          "data": [
+            {
+              "type": "spree_images",
+              "id": "1"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
+```
+
+List all of the products that taxon owns via the taxons `id`.
+
+## Show Product of a Taxon
+
+```shell
+curl "https://kabuni.com/api/v2/taxons/1/products/10"
+```
+
+```json
+{
+  "data": {
+    "id": "10",
+    "type": "spree_products",
+    "attributes": {
+      "name": "Spree Ringer T-Shirt",
+      "description": "Velit nemo odio ducimus nobis non doloremque beatae sunt. Totam quia voluptatum perferendis tempore sed voluptate consequuntur. Sit id corporis autem veritatis reprehenderit.",
+      "slug": "spree-ringer-t-shirt",
+      "meta_description": null,
+      "meta_keywords": null,
+      "store_name": "Whole New Home"
+    },
+    "relationships": {
+      "master": {
+        "data": {
+          "type": "spree_variants",
+          "id": "10"
+        }
+      },
+      "variants": {
+        "data": []
+      },
+      "taxons": {
+        "data": [
+          {
+            "type": "spree_taxons",
+            "id": "1"
+          }
+        ]
+      },
+      "option_types": {
+        "data": [
+          {
+            "type": "spree_option_types",
+            "id": "1"
+          }
+        ]
+      },
+      "images": {
+        "data": [
+          {
+            "type": "spree_images",
+            "id": "1"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Fetch a product of taxon via the taxon's `id` and the products `id`.