灵析 API 文档(V1)

开始使用 ¶

接入说明 ¶

获取 api_key 和 api_secret

1. 登录灵析账户

2. 点击右上角菜单 -> 设置中心

3. 接口设置

调用所有接口，必须包含下面四个参数

signature 的验证方式

• 首先验证时间戳是否在当前时间 600s 内

• 其次验证 signature 是否正确

signature 参数生成步骤

• 设所有需要发送的数据为集合M，在集合M中增加当前时间戳stamp，随机字符串noncestr以及机构的api_key，然后将集合M内非空参数值（或空数组）的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

• 对stringA进行sha256哈希计算，秘钥api_secret，得到signature值

signature 参数验证步骤

• 设所有接收到的数据为集合M，将集合M内非空参数值（或空数组）的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

• 对stringA进行sha256哈希计算，秘钥api_secret，得到signature值

验证和生成签名特别注意以下重要规则

• 参数名ASCII码从小到大排序（字典序）；

• 如果参数的值为空（或空数组）不参与签名；

• 参数名区分大小写；

• 验证调用返回或主动通知签名时，传送的signature参数不参与签名，将生成的签名与该signature参数值作校验。

• 接口可能会增加字段，验证签名时必须支持增加的扩展字段

参数及返回类型说明 ¶

分页参数

with 参数

使用接口给出的 with 参数获取资源的其他信息

比如

donate/?with=user,project

表示去获取 donate 的同时带上 user 和 project 信息

返回数据格式

[GET] 请求单个数据接口

{
  "data": {
    "type": "event",
    "id": "cam7klxnremov5gydo1019z84pwq237o",
    "attributes": {

    }
  }
}

[POST] 请求创建更新数据

{
  "data": {

  }
}

每个接口具体数据在 data 里面

统计数据

{
  "data": {
    "total": 1000
  }
}

分页数据

{
  "meta": {
    "pagination": {
      "total": 171,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 18
    }
  },
  "links": {
    "self": "http://apixtest.lingxi360.com/v1/cf_project/list?page=1",
    "first": "http://apixtest.lingxi360.com/v1/cf_project/list?page=1",
    "next": "http://apixtest.lingxi360.com/v1/cf_project/list?page=2",
    "last": "http://apixtest.lingxi360.com/v1/cf_project/list?page=18"
  }
}

SDK 地址 ¶

如何下载安装，具体参考链接文档

• php 链接

• java 链接

• node 链接

开发者技巧 ¶

by_column 表单式

引入 by_column 表单式，在获取资源全部数据的时候，拓展出更大的操作空间，表达式结构为

filed|operator|value

filed 为字段名称，operator 为操作符号，可选：

• eq - =

• ne - <>

• gt - >

• gte - >=

• lt - <

• lte - <=

• like - LIKE

加入要获取手机号为 13122222222 的联系人，表达式为：

mobile|eq|13122222222

测试接口 ¶

{
  "msg": "Hello, Lingxi!!!"
}

{
  "stamp": "1482473936",
  "noncestr": "7wXXaVTcRtz6DydF",
  "api_key": "pj5iHdpka",
  "signature": "33ef3dc5fb9d74e9c89caea91123bb5705f8e8e9f2823ba7525405cd88e08002"
}

联系人 ¶

{
  "name": "京城五", // (string) 姓名
  "nickname": "", // (string) 名称
  "email": "guorunmiao@qq.com", // (string) 邮箱
  "email2": "", // (string) 备用邮箱
  "mobile": "12323234545", // (string) 手机号
  "mobile2": "", // (string) 备用手机号
  "birthday": "0000-00-00", // (string) 生日
  "gender": "", // (string) 性别
  "avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLADwPUGnaAmvzHu3R4sK33OUJnLdqd97GHn2fgjiaiaKvrXs78oYUuFziahlOSCygj1z696I4ian9CACQ/0", // (string) 图像
  "address": "三元桥", // (string) 地址
  "zip_code": "", // (string) 邮编
  "description": "", // (string)
  "org_id": 102666,
  "org_department": "", // (string) 工作单位部门
  "org_position": "", // (string) 单位地址
  "org_phone": "", // (string) 单位电话
  "country": "", // (string) 国家
  "province": "", // (string) 省份
  "qq": "28223123", // (string) qq
  "wx_username": "", // (string) 微信用户名
  "weibo_name": "", // (string) 微博名称
  "weibo_link": "", // (string) 微博链接
  "create_time": 1403447755, // (int) 创建时间
  "update_time": 1427448819, // (int) 更新时间
  "constellation": 0, // (int) 星座
  "form_submit_count": 12, (int) 填写表单次数
  "member": "", // (string)
  "member_donate_count": 0, // (int)
  "member_donate_sum": 0, // (int)
  "member_donate_first_date": 0, // (int)
  "member_credit_score": 0, // (int)
  "org": { // 单位详细信息
    "id": "cavl1l5m4zq97xwn0wz023ye8pvrkogz", // (string)
    "name": "灵析", // (string)
    "website": "http://www.lingxi360.com/index.php", // (string) 网站
    "logo": "", // (string)
    "phone": "010-4683670", // (string)
    "fax": "010-64683671", // (string)
    "address": "远洋新干线A座1109", // (string)
    "zipcode": "10027", // (string)
    "email": "hi@lingxi.com", // (string)
    "description": "欢迎大家拍砖、献花和我们约聊······这里是十分热情的灵析团队！", // (string)
    "contact_user": "易昕", // (string) 单位联系人
    "create_time": 1460638709 // (int) 创建时间
  },
  "statistics_event": { // 活动统计
    "count_event": 7, // (int) 活动次数
    "duration": 16 // (int) 活动时间(小时)
  },
  "statistics_donate": { // 捐款统计
    "count_paid": 1, // (int) 支付次数
    "sum_paid": "25.00" // (float) 联系人捐款总数
  }
}

{
  "success" => true,
  "cid" => "CFhsdjf8g7fg7sf6dgf675g544"
}

{
  "success" => true,
  "cid" => "CFhsdjf8g7fg7sf6dgf675g544"
}

{
  "type": "singletime", // (string) singletime(单次捐), periodic(定期捐)
  "team_id": "ca7nxo5qvzl9gm10q2vk07w3rp24e8yk", // (string)
  "cid": "ca17nxo5qvzl9gm10q507w3rp24e8ykw", // (string) 项目分类 id
  "title": "七夕，给你一个爱的约会", // (string) 标题
  "summary": "", // (string) 简介
  "desc": "<p><span style=\"font-family: 微软雅黑, 'Microsoft YaHei'; line-height: 1.5em;\">嗨，[#姓名#]<br></span></p>", // (string) 详细
  "sequence": "0", // (string) 权重
  "preview_image": "http://file.lxi.me//attachment/2015/0915/4cf0c61a6aa6b26b3e48a17205c44a14.jpg", // (string) 预览图片
  "is_special": true, // (bool) 是否顶置
  "status": "published", (string) published(发布),  closed(关闭), draft(草稿)
  "goal": false, // (bool) 是否有目标
  "is_donatable": true, // (bool) 是否可以捐赠
  "is_together_donatable": false, // (bool) 是否开启团队捐
  "create_time": 1442032723, // (string) 创建时间
  "update_time": 1444878789, // (string) 更新时间
  "sum_paid": 8.74, // (float) 项目总筹款款
  "count_user_paid": "10", // (float) 捐款人数
  "components": {
    "periodic": { // 定期捐信息
      "information": {
        "is_enabled": "1", // (string) 是否开启分档筹款
        "options": [
          {
            "money": "6", // (string) 额度
            "desc": "一个羊肉串",
            "limit_num": "100"
          },
          {
            "money": "8",
            "desc": "一串鸡翅",
            "limit_num": "100"
          },
          {
            "money": "60",
            "desc": "一个靠羊腿",
            "limit_num": "100"
          }
        ],
        "is_input_allowed": "false" // 是否允许用户自己输入额度
      }
    },
    "donate_certificate": { // 项目每次捐赠证书配置
      "config": {
        "is_enable": "0",
        "cert_template_id": "carp7vl4kq13904we81ez6m2yxoez5wg" // (string) 证书 id
      }
    },
    "project_donate_certificate": { // 项目级别证书
      "config": {
        "is_enable": "0",
        "cert_template_id": "carp7vl4kq13904we81ez6m2yxoez5wg"
      }
    },
    "goal": { // 项目目标
      "is_enable": false, // (bool) 是否开启
      "is_enable_achieved_donate": false, // (bool) 达到目标是否可以继续捐赠
      "goal_num": 0 // 目标金额
    },
    "expire": { // 项目到期时间
      "is_enable": false, // (bool) 是否开启
      "expire_time": 0 // (int) 过期时间
    },
    "success_number_limit": { // 捐赠次数上限
      "is_enable": false, // (bool) 是否开启
      "limit_num": 0 // (int) 次数限制
    }
  }，
  "link": "http://cf.lingxi360.com/p/ca512p4q3yewvdk5y3qgodzgl8mknx7r", // 项目链接
  "donates": [ // 和捐赠信息一致
    {
      "id": "carp7vl4kq13904we81ez6m2yxoez5wg",
      "user_project_id": "caox9g48omp21rydmrwn6vew7n5qkz3l",
      "project_id": "ca512p4q3yewvdk5y3qgodzgl8mknx7r",
      "cf_user_id": "canxo5qvzl9gm10qp9lkld7w3rp24e8y",
      "donate_cf_user_id": "canxo5qvzl9gm10qp9lkld7w3rp24e8y",
      "contact_id": "capx8v2gr3ymw40557mp309qo571ezkl",
      "donate_amount": "75.00",
      "flow_number": "4008632001201608090925588822",
      "status": "paid",
      "pay_time": 1470714270,
      "comment": "",
      "donate_form_data": {
        "name": "西桐",
        "email": "joy_song@126.com",
        "new_item_1": "",
        "ip": "10.158.26.1",
        "browser_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 9_3_3 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Mobile/13G34 MicroMessenger/6.3.23 NetType/4G Language/zh_CN",
        "browser_referer": "http://cf.lingxi360.com/up/caox9g48omp21rydmrwn6vew7n5qkz3l?ouid=canxo5qvzl9gm10qp9lkld7w3rp24e8y&from=groupmessage&isappinstalled=0"
      },
      "create_time": 1470714252,
      "update_time": 1470714270
    }
  ],
  "statistics_donate": { // 捐赠统计
    "sum": 602.6, // (float) 总筹款额(包括额外捐赠)
    "sum_paid": 600, // (float) 总筹款额(不包括额外捐赠)
    "count": 8, // (int) 总捐款次数(包括额外次数)
    "count_paid": 8, // (int) 总付款次数
    "count_user": 1, // (int) 总捐款人数
    "count_user_paid": 1, // (int) 总捐款人数(包括额外次数)
    "percent": 0, // (int) 项目进度(不超过100)
    "percent_round": 0, // (int) 项目绝对进度(可以超过 100)
    "is_achieved": false, // (bool) 是否达到目标
    "is_expired": true, // (bool) 是否到期
    "is_over_limit": false, // (bool) 是否超出目标
    "is_donatable": false // (bool) 是否可以继续捐赠
  }
}

信息同上

{
  "project_id": "caz9x45erm3o21kp0g108q9ygw7lvnz2", // (string) 关联项目 id
  "interval": "monthly", // (string) 类型, monthly(月捐), weekly(周捐), daily(日捐)
  "donate_amount": "100.00", // (float) 金额
  "status": "binded", // (string) 状态, binded(绑定), unbinded(解绑), init(初始化)
  "is_anonymous": false, // (bool) 是否匿名
  "bind_time": 1462982400, // (int) 绑定时间
  "next_pay_time": 0, // (int) 下次扣款时间
  "create_time": 1468495900,
  "update_time": 1468495903,
  "comment": "", // (string) 评论
  "manage_link": "http://cfnew.lingxi.com/periodic/caz9x45erm3o21kp0g108q9ygw7lvnz2", // (string) 管理链接
  "donates": [ // (array)
      {
          "id": "camrp4nyx9v1wdy321g4v6gzloqk783e",
          "project_id": "ca924lkpryz7m38qd97x09vxe2n15wog",
          "cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm",
          "user_project_id": "ca17nxo5qvzl9gm10q507w3rp24e8ykw",
          "contact_id": "canrp7vl4kq13904lp8vdm2yxoez5wg8",
          "donate_amount": 1.01, // (float) 支付金额
          "flow_number": "k1nrp7vl4kq13904lp8vdm2yxoez5wg8", // (string) 微信，支付宝订单流水号
          "status": "paid", // (string) 已支付-`paid`, 未支付-`unpaid`
          "pay_time": 0, // (int) 付款时间
          "donate_cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm", // (string) 筹款用户 id
          "comment": "", // (string) 留言
          "create_time": 1442064826,
          "update_time": 1442064826
      }
  ],
  "project": { // 同项目字段
      "id": "caz9x45erm3o21kp0g108q9ygw7lvnz2",
      "type": "periodic",
      "title": "清华大学新百年基金",
      "summary": "“集资、集智、集力、集心”",
      "desc": "<p>This is a demo project!!!</p>",
      "preview_image": "http://file.lxi.me/cf/20160513/5735421ae707e.jpg",
      "sequence": 24,
      "status": "published",
      "create_time": 1438845474,
      "update_time": 1470294646,
      "link": "http://cfnew.lingxi.com/p/caz9x45erm3o21kp0g108q9ygw7lvnz2"
  }
}

{
  "count_join": 2, // (int) 加入的定期捐个数
  "count_paid": 3, // (int) 定期捐扣款次数
  "sum_paid": 7.10 // (float) 扣款金额
}

{
  "project_id": "cawn9v23wqo8z7m0n8w80kl5eg4py1rx", // (string) 项目 id
  "goal": "2000.00", // (string) 目标金额
  "title": "交大零八届三班", // (string) 团队标题
  "comment": "匆匆岁月，我们一起奋斗一起长大。饮水思源、助力母校，让更多的师弟师妹茁长成长。", // (string) 团队描述
  "update_time": 1442570268,
  "create_time": 1442570268,
  "project": { // 同项目
      "id": "cawn9v23wqo8z7m0n8w80kl5eg4py1rx",
      "type": "singletime",
      "title": "一起捐定额筹款",
      "summary": "这里是项目简介",
      "desc": "<p style=\"margin-top: 0px; margin-bottom: 10px; color: rgb(34, 34, 34); font-family: 'Helvetica Neue', Arial, 'Microsoft Yahei', arial, sans-serif; font-size: 13px; line-height: 20px; white-space: normal; \">\n    <strong>关于项目</strong>\n</p>\n<p style=\"margin-top: 0px; margin-bottom: 10px; color: rgb(34, 34, 34); font-family: 'Helvetica Neue', Arial, 'Microsoft Yahei', arial, sans-serif; font-size: 13px; line-height: 20px; white-space: normal;\">\n    （简短介绍项目详情，让支持者能够在最短时间内了解你的项目）\n</p>",
      "preview_image": "/uploads/cf_default/cf_demo_project_img.jpg",
      "sequence": 0,
      "status": "published",
      "create_time": 1456976008,
      "update_time": 1463654233,
      "link": "http://cfnew.lingxi.com/p/cawn9v23wqo8z7m0n8w80kl5eg4py1rx"
  },
  "donates": [ // (array) 同捐赠
    {
      "id": "ca94ygk2w7p3n0z5zx93z085m1rxoveq",
      "project_id": "ca924lkpryz7m38qd97x09vxe2n15wog",
      "cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm",
      "user_project_id": "ca4k18e2n3gk9rz70lkgdwoymvl45xqp",
      "contact_id": "caqox9g48omp21rydmpdvew7n5qkz3lm",
      "donate_amount": "20.00",
      "flow_number": "",
      "status": "paid",
      "pay_time": 0,
      "donate_cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm",
      "comment": "",
      "create_time": 1442065196,
      "update_time": 1442065196
    }
  ]
}

{
  "mine": {
    "count_create_user_project": 8, // (int) 创建的团队捐个数
    "count_user_paid": 2, // (int) 独立用户参与人数
    "sum_paid": "33905.74" // (int) 已筹金额
  },
  "me": {
    "count_donate_user_project": 58, // (int) 捐赠的团队捐个数
    "sum_paid": 128072.35 // (float) 个人参与团队捐捐赠金额
  }
}

{
  "title": "基本的功能完成了0", // (string) 表单标题
  "summary": "还要再增加一个备注\r\n感谢您在百忙之中抽出时间填写问卷，我们将在答卷中抽取幸运用户送上精美小礼品一份！\r\n备注可以得修改名称备注可以得修改名称！\r\n", // (string) 表单描述
  "status": "published", // (string) 状态
  "start_time": 0, // (int) 开始时间
  "end_time": 0, // (int) 结束时间
  "create_time": 1394364652,
  "update_time": 1395390441,
  "sequence": 0, // (int) 权重
  "statistics_form": { // 表单统计
      "form_id": "cavlypqrolg7zwk463z0v8xem3295n1x",
      "count_fill": 26 // (int) 填写数量
  },
  "link": "http://f.lingxi360.com/f/?token=KDR0cl4Gz7RyhDOhhkImP_ENi", // (string) 表单链接
  "form_fills": [ // 我的表单填写数据
      {
          "id": "cam7klxnremov5gydo1019z84pwq237o",
          "data": { // 填写内容
              "name": "张三",
              "mobile": "13412345678",
              "email": "zhangsan@qq.com",
              "province": "辽宁",
              "note": "18d95846d271ab3e8915445951db3918",
              "form_token": "abff503089dcb657f76a4aa04a40af33"
          },
          "create_time": 1395039403 // (int) 填写时间
      }
  ]
}

{
  "contact_user": "Rry", // (string) 活动创建人名称
  "title": "故宫一日游", // (string) 活动名称
  "type_id": "cam1nrp7vl4kq1396490m2yxoez5wg8w", // (string) 活动分类 id
  "description": "", // (string) 活动说明
  "image": "", // (string) 活动图片
  "event_time": 0, // (int) 管理员自己写的活动开始时间
  "event_duration": 0, // (int) 活动时长
  "relate_link": "", // (string) 活动关联链接
  "create_time": 1465963851,
  "update_time": 1465963851,
  "attachments": [ // (array) 附件
      {
        "path": "http://file.lxi.me/page/2014/0829/79dd0e0fb11881562fbbdca807980bc213084652.jpg", // (string) 路径
        "ext": "jpg", // (string) 文件后缀
        "mimetype": "image/jpeg", // (string) 文件类型
        "size": 48728 // (int) 大小
      },
      {
        "path": "http://file.lxi.me/attachment/2015/0627/a6158a1276dbb246e258ab37ce98f3a6.docx",
        "ext": "docx",
        "mimetype": "application/octet-stream",
        "size": 19645
      }
  },
  "info": { // 有 cid 同时 with 了 info 才会查询出现
    "id": "cam1nrp7vl4kq1396490m2yxoez5wg8w",
    "event_id": "cam1nrp7vl4kq1396490m2yxoez5wg8w", // (string) 活动 id
    "contact_id": "cam1nrp7vl4kq1396490m2yxoez5wg8w", // (string) 联系人 id
    "create_time": 1465963850, // (int) 联系人加入活动时间
    "duration": 8, // (int) 联系人参与时间
    "score": 2 // (int) 参与这次活动积分
  }
}

{
  "wechat_openid": "o22Yxtw0NnD69pUhKRKFMhgcU8lY" // (string)
}

{
  "cid": "ca2lo512p4q3yewvdkevdzgl8mknx7r9" // (string)
}

活动 ¶

{
      "title": "123", // (string)
      "description": "建议填写活动简介、活动流程、活动须知、注意事项、主办方联系方式等内容，并且可以上传照片吸引报名。",
      "is_free": true, // (boolean) 是否是免费活动
      "preview_image": "https://s.lingxi360.com/lingxi/assets/img/activity/1/main-1.jpg", // (string)
      "address": "", // (string)
      "address_province": "", // (string) 省
      "address_city": "", // (string) 市
      "address_area": "", // (string) 区
      "signed_up_user_count": 0, // (int) 报名人数
      "signin_start_time": 1403447755, // (int) 活动开始时间
      "signin_end_time": 1403447755, // (int) 活动结束时间
      "signup_start_time": 1403447755, // (int) 报名开始时间
      "signup_end_time": 1403447755, // (int) 报名结束时间
      "link": "https://activity.lingxi360.com/activity/cavl1l5m4zq97xwn0w5z023ye8pvrkog", // 活动地址
      "status": "signup",
      "type": { // 类型
        "id": "cam7klxnremov5gydo1019z84pwq237o",
        "name": "社区活动"
      }
    }

{
      "id": "cadasjdsdjfhgfhdfgdfhfghgjhgj", // (string)
      "name": "Category",
      "activity_count": 10
    }

捐赠项目 ¶

{
  "type": "singletime", // (string) 类型 singletime - periodic
  "cid": "ca17nxo5qvzl9gm10q507w3rp24e8ykw", // (string) 分类 id
  "title": "撸串众筹", // (string) 标题
  "summary": "", // (string) 口号
  "desc": "<p><span style=\"font-family: 微软雅黑, 'Microsoft YaHei'; line-height: 18px;\">testtest</span></p>", // (string) 描述
  "is_special": false, // (string) 是否置顶
  "preview_image": "/attachment/2015/0915/4cf0c61a6aa6b26b3e48a17205c44a14.jpg", // (string) 预览图
  "sequence": 0, // (string) 排序
  "status": "published", // (string) 状态 `published` - `closed` - `draft`
  "create_time": 1442032723,
  "update_time": 1463717527,
  "sum_paid": 0.01, // (float) 目前捐款
  "count_user_paid": 0, // (int) 目前捐款人次
  "components": {
    "periodic": { // 定期捐信息
      "information": {
        "is_enabled": "1", // (string) 是否开启分档筹款
        "options": [
          {
            "money": "6", // (string) 额度
            "desc": "一个羊肉串",
            "limit_num": "100"
          },
          {
            "money": "8",
            "desc": "一串鸡翅",
            "limit_num": "100"
          },
          {
            "money": "60",
            "desc": "一个靠羊腿",
            "limit_num": "100"
          }
        ],
        "is_input_allowed": "false" // 是否允许用户自己输入额度
      }
    },
    "donate_certificate": { // 项目每次捐赠证书配置
      "config": {
        "is_enable": "0",
        "cert_template_id": "0"
      }
    },
    "project_donate_certificate": { // 项目级别证书
      "config": {
        "is_enable": "0",
        "cert_template_id": "0"
      }
    },
    "goal": { // 项目目标
      "is_enable": false, // (bool) 是否开启
      "is_enable_achieved_donate": false, // (bool) 达到目标是否可以继续捐赠
      "goal_num": 0 // 目标金额
    },
    "expire": { // 项目到期时间
      "is_enable": false, // (bool) 是否开启
      "expire_time": 0 // (int) 过期时间
    },
    "success_number_limit": { // 捐赠次数上限
      "is_enable": false, // (bool) 是否开启
      "limit_num": 0 // (int) 次数限制
    }
  },
  "statistics_donate": {
    "sum": 602.6, // (float) 总筹款额(包括额外捐赠)
    "sum_paid": 600, // (float) 总筹款额(不包括额外捐赠)
    "count": 8, // (int) 总捐款次数(包括额外次数)
    "count_paid": 8, // (int) 总付款次数
    "count_user": 1, // (int) 总捐款人数
    "count_user_paid": 1, // (int) 总捐款人数(包括额外次数)
    "percent": 0, // (int) 项目进度(不超过100)
    "percent_round": 0, // (int) 项目绝对进度(可以超过 100)
    "is_achieved": false, // (bool) 是否达到目标
    "is_expired": true, // (bool) 是否到期
    "is_over_limit": false, // (bool) 是否超出目标
    "is_donatable": false // (bool) 是否可以继续捐赠
  }
  "link": "http://cfnew.lingxi.com/p/cam1nrp7vl4kq1396490m2yxoez5wg8w" // 项目链接
}

同列表接口

{
  "cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm", // (string) 留言用户 id
  "comment": "999", // (string) 留言内容
  "sequence": 3, // (int) 排序权重
  "status": "published", // (string) 状态 发布-`published` 草稿-`draft`
  "is_anonymous": true, // (float) 是否匿名
  "create_time": 1465884702,
  "update_time": 1465884702,
  "replys": [ // 回复
    {
      "id": "ca4k18e2n3gk9rz76lok6woymvl45xqp",
      "cf_user_id": "cawek7zx2eqwovy9027pd483gmnp5rl1",
      "comment": "来来来",
      "sequence": 0,
      "status": "published",
      "is_anonymous": false,
      "create_time": 1469263656,
      "update_time": 1469263656,
      "user": {
        // 回复用户信息
      }
    }
  ],
  "count_like": 1, // 点赞数量
  "user": { // 留言用户信息
    "team_id": "ca4k18e2n3gk9rz76l7dwoymvl45xqpl",
    "type": "wechat",
    "openid": "o22Yxt3ey8oNo-0YTDTN3gxYogKQ", // 微信 openid
    "user_info": {
      "openid": "o22Yxt3ey8oNo-0YTDTN3gxYogKQ",
      "nickname": "Caspar",
      "sex": 1,
      "language": "zh_CN",
      "city": "朝阳",
      "province": "北京",
      "country": "中国",
      "headimgurl": "http://wx.qlogo.cn/mmopen/A83vHGXtO64oO1O8vicOdicDg3NDBoEWia0qYtM3A3U5B7szj6ucetZ1lZV12uoOb9ZsApgFK5bmfrKupLz0IM5bib6mVTmr8l90/0",
      "privilege": []
    },
    "mobile": "17710189761",
    "contact_id": "ca1gk45nrwzxl30vw3po6vp7e8q29omy",
    "update_time": 1440390574,
    "create_time": 1438491910
  },
  "likes": [ // 点赞信息列表
    {
      "cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm", // (string)
      "project_id": "caz9x45erm3o21kp0g108q9ygw7lvnz2", // (string)
      "comment_id": "caqox9g48omp21rydm520vew7n5qkz3l", // (string)
      "update_time": 1468816012,
      "create_time": 1468816012
    }
  ]
}

同列表接口

{
    "project_id": "caz9x45erm3o21kp0g108q9ygw7lvnz2", // (string) 项目 id
    "cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm", // (string) 项目创建人 id
    "user_project_id": "ca17nxo5qvzl9gm10q507w3rp24e8ykw", // (string) 团队捐项目 id
    "contact_id": "capyw3m54kreo807w8ok692vnxglzq71", // (string) 联系人 id
    "donate_amount": 1000.01, // (float) 捐款额
    "flow_number": "1006930077201509180918911789", // (string) 支付宝，微信流水号
    "status": "paid", // (string) 状态
    "pay_time": 1442571809, // (int) 支付时间
    "donate_cf_user_id": "caqox9g48omp21rydmpdvew7n5qkz3lm", // (string) 捐款人 id
    "comment": "", // (string) 捐款留言
    "create_time": 1442571788,
    "update_time": 1442571788,
    "donate_form_data": {
      "name": "薛藤",
    },
    "anonymous_name": true,
    "create_time": 1440390574,
    "update_time": 1440390574,
    "user": { // 用户信息
        "team_id": "ca4k18e2n3gk9rz76l7dwoymvl45xqpl",
        "user_info": {
          "openid": "o22Yxt3ey8oNo-0YTDTN3gxYogKQ",
          "nickname": "Caspar",
          "sex": 1,
          "language": "zh_CN",
          "city": "朝阳",
          "province": "北京",
          "country": "中国",
          "headimgurl": "http://wx.qlogo.cn/mmopen/A83vHGXtO64oO1O8vicOdicDg3NDBoEWia0qYtM3A3U5B7szj6ucetZ1lZV12uoOb9ZsApgFK5bmfrKupLz0IM5bib6mVTmr8l90/0",
          "privilege": []
        },
        "contact_id": "ca1gk45nrwzxl30vw3po6vp7e8q29omy"
    }
  }

同列表

{
  "project_id": "caz9x45erm3o21kp0g108q9ygw7lvnz2", // (string) 项目 id
  "title": "Nam magni voluptatibus aut aut quas molestiae et.", // (string) 进度标题
  "desc": "Laudantium sunt sint ut eaque autem. Architecto aut est aperiam. Accusamus iusto molestiae voluptate eos soluta et dicta eum. Eum et est est blanditiis deserunt sed aspernatur. Facilis magni ut occaecati vero.", // (string) 进度描述
  "image": [ // (array) 进度图片
      {
          "path": "http:\\/\\/file.lxi.me\\/uploadify\\/20160503\\/57281c13efc20.jpg"
      }
  ],
  "progress_time": "2016-08-30 18:23:59", // (string) 进度时间
  "create_time": 1472552639,
  "update_time": 1472552639,
  "project": {...} // 同项目字段
}

[
  {
    "type": "category",
    "id": "ca924lkpryz7m38q09x09vxe2n15wog4",
    "attributes": {
      "name": "学院发展基金筹款项目", // (string) 分类标题
      "create_time": 1464624000,
      "update_time": 1464624000
    }
  }
]

{
  "project_id": "caz9x45erm3o21kp0g108q9ygw7lvnz2", // (string) 新项目 id
  "short_url": "http://lxi.me/abcde" // (string) 项目短链接
}

表单 ¶

{
      "type": "form",
      "id": "ca9r4x83g5ep9wn6rn7g0mlo1qyzv27k",
      "attributes": {
        "title": "扫我啊", // (string) 标题
        "summary": "<p><img src=\"http://file.lxi.me/uploadify/20160616/57624f695c980.png-scale560\" title=\"QQ截图20160501121853.png\" // 具体描述 alt=\"QQ截图20160501121853.png\"/>+</p><p>+face++</p>", // (string) 描述
        "status": "published", // (string) 状态
        "start_time": 1468239349, // (int) 开始报名时间
        "end_time": 1468239349, // (int) 结束报名时间
        "create_time": 1468239349, // (int) 项目创建时间
        "update_time": 1468464835, // (int) 更新时间
        "sequence": 0, // (int) 排序
        "link": "http://f.lingxi360.com/?token=cNMnkTwiFTamcTwnN" // (string) 链接
      }
    }

同表单列表

[
  "type": "form_fill",
  "id": "ca9r4x83g5ep9wn6r9xx6mlo1qyzv27k",
  "attributes": {
    "form_id": "ca7nxo5qvzl9gm1dq2gkd7w3rp24e8yk", // (string)
    "data": { // 填写数据
      "name": "邓铠易",
      "mobile": "13720050963",
      "email": "bupteasy@gmail.com",
      "new_item_1": "移动互联网"
    },
    "contact_id": "canxv8z25kyqo768gxngm0epgm1rlw94", // 联系人 id
    "create_time": 1403665577,
    "update_time": 0
  },
  "contact": { // 同联系人
    ...
  }
]

同上

{
  "success" => true,
  "formfill_id" => "ca52k7n48lw9g1dpgg533dvqpmoxzr3y"
}

筹款支付表单 ¶

目前灵析筹款表单主要分为 单次捐，组队捐 和 定期捐 ，各个类型的表单的项目连接的格式如下：

单次捐 ¶

• 单次捐筹款

单次捐筹款的链接格式为： http://cf.lingxi360.com/p/+项目信息哈希

示例：http://cf.lingxi360.com/p/LXEmxB3LG8R0

组队捐 ¶

• 组队捐创建团队

组队捐创建团队的链接格式为： http://cf.lingxi360.com/p/+项目信息哈希+/up/create

示例： http://cf.lingxi360.com/p/caxpyw3m54kreo8677qg692vnxglzq71/up/create

• 组队捐筹款

组队捐筹款页面的链接格式为： http://cf.lingxi360.com/up/+团队信息哈希（注意和单次捐的区别：中间是 up）

示例：http://cf.lingxi360.com/up/caxpyw3m54kreo8677qg692vnxglzq71

定期捐 ¶

• 定期捐筹款

定期捐捐赠页面链接格式为： http://cf.lingxi360.com/periodic/+项目信息哈希

示例：http://cf.lingxi360.com/periodic/LXEmxB3LG8R0

获取表单字段 name 值 ¶

在浏览器中通过 开发者工具（推荐） 或者 查看源代码 的方式找到需要操作的表单字段的对应 name 值。name 值将用来和表单的相关操作通信。 注意：通过查看源码可以发现部分表单的的 name 值为 form_data[*]，这时的话只需要取 [] 中的部分作为传递的 name 即可。

特殊字段的处理 ¶

在获取 name 值得时候，有几个字段的 name值比较特殊，现在下表说明，调用过程中一定要注意这个部分。

[操作] 自动弹出捐赠窗口 ¶

此接口能控制在筹款项目页面打开时是否自动弹出捐赠项目的支付弹窗。

示例：http://cf.lingxi360.com/p/LXEmxB3LG8R0?_setting_form_popup=1

_setting_form_popup: int (默认 0)

设置为1将在页面打开时自动弹出捐赠表单，目前仅支持移动端的单次捐捐款页面，组队捐捐款页面和定期捐捐款页面

[操作] 设置默认值 ¶

可以通过在url参数中设置表单项目的默认值。

示例：http://cf.lingxi360.com/p/LXEmxB3LG8R0?_default_title=今天天气很好

使用方式的在链接后面传递参数 default_* ，*可以是页面表单中存在的任意 name 值。

_default_name:    string

_default_*，* 代表页面中存在字段的 name 值

[操作] 属性只读 ¶

可以通过在 url参数中设置表单字段是否只读。

//此时表单中的 title 字段会被设置为不可修改的状态
示例：http://cf.lingxi360.com/p/LXEmxB3LG8R0?_unchangeable_title=1

使用方式的在链接后面传递参数 _unchangeable_* ，*可以是页面表单中存在的任意 name 值。

string: _unchangeable_name=默认 0 #_unchangeable_*，* 代表页面中存在字段的 name 值

//多个参数同时使用示例
http://cf.lingxi360.com/p/LXE8G6B_tyG=GOAF?_default_donate_project=50585&_setting_form_popup=1

筹款notify和redirect ¶

接口说明：

• 用户在筹款项目中设置了成功回调地址之后，用户支付成功后会向设置的回调地址发送post请求，包含用户支付的信息。

• 用户在筹款项目中设置了付款后跳转页面链接之后，用户支付成功后会跳转到设置的成功页面链接，包含用户支付的信息。

• 第三方系统通过保存用户的支付信息，可以进行定制化的统计分析等功能。

实现步骤：

• 在灵析筹款后台设置成功回调地址，如果要指定付款成功页面还需要设置支持者付款后跳转页面链接。

• 第三方系统引导用户访问传入第三方用户id信息的灵析筹款页面链接。

• 用户支付完成或绑定成功后，灵析筹款会跳转到第三方指定成功页面并向指定回调地址发送携带用户支付或绑定信息的请求。

验证方式：

• 使用lingxi api-authentication签名验证

单次捐notify ¶

• 请求方法：POST

• 请求地址：用户设置的成功回调地址

• 输入参数：如下

单次捐redirect ¶

• 请求方法：GET

• 请求地址：用户设置的支持者付款后跳转页面链接

• 输入参数：如下

定期捐绑定notify ¶

• 请求方法：POST

• 请求地址：用户设置的成功回调地址

• 输入参数：如下

定期捐扣款notify ¶

• 请求方法：POST

• 请求地址：用户设置的成功回调地址

• 输入参数：如下

同单次捐notify

定期捐redirect ¶

• 请求方法：GET

• 请求地址：用户设置的支持者付款后跳转页面链接

• 输入参数：如下

同单次捐redirect

错误代码说明 ¶

签名验证错误 ¶

请求获取数据错误 ¶

其他 ¶