liuming / developer-docs

####接口地址：

/course/catalog

####GET请求参数： id （非必须） path （非必须）

---

参数说明：

1.获取所有一级目录：

id 和 path 都为空，则返回所有一级目录

2.获得其他目录：(客户端暂不需要)

id 和 path 只传一个，两个都传，默认以id为准

id为课程目录的id，path为课程目录的标识，例如目录“教材”的id是 1，请求 /course/catalog?id=1 则返回“教材”目录下所有的二级目录

---

####接口返回值为： 返回一级目录：

GET请求 http://api.boxfish.cn/course/catalog 该地址，不带参数

  [
    {
      "id": 1867,
      "pathFlag": 100,
      "name": "教材",
      "summary": "转换思维，教材原来可以这么容易。",
      "icon":"textbook",
      "image":"images/1411532427.jpg"
    },
    {
      "id": 2420,
      "pathFlag": 101,
      "name": "文章",
      "summary": "轻松掌握我们认为掌握不了的课程",
      "icon":"listening",
      "image":"images/1411532427.jpg"
    }
  ]

---

返回二级、三级或四级目录：(客户端暂不需要)

GET请求 http://api.boxfish.cn/course/catalog?id=1931 或 http://api.boxfish.cn/course/catalog?path=100100

  [
    {
      "id": 1931,
      "pathFlag": 100102105,
      "name": "九年级",
      "summary": null
    },
    {
      "id": 1941,
      "pathFlag": 100102106,
      "name": "四上",
      "summary": null
    },
    {
      "id": 1948,
      "pathFlag": 100102107,
      "name": "四下",
      "summary": null
    },
    {
      "id": 2015,
      "pathFlag": 100102115,
      "name": "八下",
      "summary": null
    },
    {
      "id": 2045,
      "pathFlag": 100102118,
      "name": "八上",
      "summary": null
    }
  ]

path是为提供树形结构提供的数据信息，三位数字为一个单位，每个单位固定以100开头，举例来讲：

原始信息	标示
教材	100
教材_七年级上	100100
教材_七年级上_Unit 1	100100100
教材_七年级上_Unit 2	100100101
教材_七年级上_Unit 3	100100102
文章	101
文章_话题：生活	101100