接口规范

未分类

/**
 *简单来说，数据总共有五个部分，
 * 一共4个接口，2个用于读取，2个用于写入
 */
// 首页接口
// 读取
    // 发送的请求
        // 接口做出来后我直接向特定url请求  参数为空
    // 返回的数据 返回的数据类型为json
        // 所有返回的json数据字段的类型为string
[{
    "pic1":"xxx",
    "pic2":"xxx",
    "pic3":"xxx",
    "pic4":"xxx",
    "h1":"XXX",
    "h2":"XXX",
    "h3":"XXX",
    "h4":"XXX",
    "p1":"XXX",
    "p2":"XXX",
    "p3":"XXX",
    "p4":"XXX"
}]
// 修改写入
    //向另外一个接口 发送的请求
    // 为空则意思为不修改，非空字符串修改对应的数据
{
    "safe":"wangyifan"//用于安全验证的字符串
    "pic1":"xxx",
    "pic2":"xxx",
    "pic3":"xxx",
    "pic4":"xxx",
    "h1":"XXX",
    "h2":"XXX",
    "h3":"XXX",
    "h4":"XXX",
    "p1":"XXX",
    "p2":"XXX",
    "p3":"XXX",
    "p4":"XXX"
}
// 返回
// 修改成功返回
{
    code：0
    "mes"："success"
}
// 失败返回
{
    code：999
    "mes":"error"
}

子页面接口 - 读取

发送的请求

参数

// pageCode 参数指请求的是哪个子页面的数据
{
    "pageCode":"1",//type string
    "safe":"wangyifan"//type string
}

返回的数据

// 返回数据 返回的数据类型为json
// 所有返回的json数据字段的类型为string

[
    {
        banner:"urlxxxx",
        "h1":"XXX",
        "h2":"XXX",
        "h3":"XXX",
        "h4":"XXX",
        "p1":"XXX",
        "p2":"XXX",
        "p3":"XXX",
    }
]

子页面接口 - 写入修改

发送的请求

参数

// pageCode 参数指请求的是哪个子页面的数据
{
    safe:"wangyifan"
    "pageCode":"1",//type string
    banner:"urlxxxx",
    "h1":"XXX",
    "h2":"XXX",
    "h3":"XXX",
    "h4":"XXX",
    "p1":"XXX",
    "p2":"XXX",
    "p3":"XXX",
}

返回

// 修改成功返回
{
    code：0
    "mes"："success"
}
// 失败返回
{
    code：999
    "mes":"error"
}

PS

简单来说你的数据库里一共有5块数据
1个index页面的 这些数据

[{
    "pic1":"xxx",
    "pic2":"xxx",
    "pic3":"xxx",
    "pic4":"xxx",
    "h1":"XXX",
    "h2":"XXX",
    "h3":"XXX",
    "h4":"XXX",
    "p1":"XXX",
    "p2":"XXX",
    "p3":"XXX",
    "p4":"XXX"
}]

4个子页面的 这些数据

[
    {
        banner:"urlxxxx",
        "h1":"XXX",
        "h2":"XXX",
        "h3":"XXX",
        "h4":"XXX",
        "p1":"XXX",
        "p2":"XXX",
        "p3":"XXX",
    }
]

表怎么设计看你自己，总之你返回给我的数据按这个格式就ok