资源描述：
《金数据的应用程序编程接口(api)操作指南》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。
1、金数据的应用程序编程接口（API）操作指南金数据API为具备编程能力的用户提供了极强的扩展功能。开发者可以通过表单API获取表单定义、通过数据API追加数据或通过数据推送API将新提交的数据推送到自己的平台。您可以在个人中心——API来开启您的API支持及获取APIKey/Secret。API访问规则l所有的数据格式为JSONl所有的数据传输编码为UTF-8l目前，API访问的地址来源为https://jinshuju.net/api/v1/l除了数据推送API外，所有的API都需要恰当的API访问权限。目前我们
2、仅支持HTTPBasic验证的方式。l目前提供的API数据推送API开启数据推送API的表单收到新数据时，金数据会将该数据通过HTTPPOST推送到指定的URL。数据推送API详解：开启数据推送如果您想将某个表单新提交的数据推送到指定URL，您可以在表单的设置——数据提交页面的底部找到将数据以JSON格式发送给第三方，勾选开启后您将看到当前表单的字段对照表。填写地址并保存后，金数据会在表单收到新数据后向指定的地址以JSON格式POST该数据。数据推送示例例如指定URL为http://url.com/jinshuj
3、u/callback，则金数据以JSON格式POST该数据的Entry信息。发送的JSON数据以字段的key来展示，字段对照表将列出Key与Label的对应关系。POSThttp://url.com/jinshuju/callbackContent-Type:application/jsonX-Requested-By:jinshuju{"form":"xJfeTv","entry":{"field1":123,"field2":"Hello,World","field3":"It'sverygood."}}字段
4、的对应格式金数据字段JSON样例单行文字，多行文字，邮箱，电话string"你好，世界"数字number123.4单选，下拉框，图片单选string"男"多选，图片多选Array["篮球","足球"]地址Object{"province":"陕西","city":"西安","address":"锦业一路软件园"}日期string"2012-04-16"评分integer14注意事项•对方服务器需在2秒内返回200作为应答，2秒后金数据将中断连接。•如果出错，金数据会最多重试三次。如果连续出错超过10次，该表单的数
5、据推送过程将停止，表单创建者将获得邮件通知。开发者需要在数据推送设置中手工启动，只有成功，数据推送才会继续。表单API您可以通过该API获取表单定义，然后你可以在任意你熟知的平台上重绘这个表单。通过结合数据API，您可以脱离金数据界面绘制和添加数据。表单API用于获取表单定义，目前支持的字段有：•单选框single_choice•复选框multiple_choice•下拉框drop_down•日期date•Emailemail•数字number•电话phone•多行文本paragraph_text•单行文本sin
6、gle_line_text上传文件、商品字段等暂时未支持。使用方法首先确保您有访问API的能力。获得APIKey&Secret后，即可获取表单的JSON定义。例如，通过curl来访问：curl-uapi_key:api_secrethttps://jinshuju.net/api/v1/forms/ex27t2请注意，以下JSON内容中，选项类的部分在数据库中以name和value两部分组成。您获得的JSON表单定义类似如下：{"name":"意见反馈","description":"
当您希望从顾客那里获得
7、反馈时，可以使用该表单收集
","fields":[{"field_9":{"label":"您对我们的服务满意么？","type":"single_choice","notes":"","private":false,"validation":{},"choices":[{"name":"非常满意","value":"zyRl"},{"name":"满意","value":"8Q6B"},{"name":"一般","value":"hPWR"},{"name":"不满意","value":"s8PE"},
8、{"name":"非常不满意","value":"fLdR"}],"allow_other":false}},{"field_10":{"label":"您最喜欢的部分是","type":"multiple_choice","notes":"","private":false,"validation":{},"choices":[{"name":"服务1","value"
