常见问题

最后更新：2016-03-16

这里列出了站点接入中常见的问题

旧数据迁移

1. 如何导入数据？

如果站方需要将旧平台的数据导入新平台，需要站方开发人员根据迁移数据的接口文档的要求进行相应的开发，开发完成并检测数据格式无误后向我方客服或技术人员申请导入数据，导入的操作一切都由我方技术人员执行操作，导入完成后会给站方一个反馈。如果导入过程有错误或者其他意外情况，我方技术会直接联系站方相应开发人员解决，直到数据全部导入为止。

2. 图片文件如何导入以及原理？

大多数形式是要求站方将数据库中保存的图片相对地址导入过来，并告知客服或技术人员图片的主机地址即可。技术人员会在云存储后台配置好原图文件所在的主机地址，当页面上访问该图片链接时，云存储会在云存储本地寻找文件，找不到时才会根据配置的主机地址将站方那的图片文件拉取到云存储上保存。

例子：假设站方有一张图片完整地址是http://oldpichost.com/family/2015/1021/14443237644324234.jpg，数据库中存储的相对地址数据为2015/1021/14443237644324234.jpg，并将该相对地址数据导入新系统，技术人员在云存储后台配置镜像源地址为http://oldpichost.com/family/即可完成平滑过渡。

3. 很多接口规则中需要给出主键id，导入系统后能对应关联吗？

有的数据接口中规定需要给出数据的主键id，主要是用于保持与其他数据的关联。

假设将地区数据导入到系统中，系统记录了每条记录的旧的主键id，同时并拥有一个新的id，在导入其他数据时如楼盘，楼盘给出的地区id是旧的区域id，导入后系统就会根据旧区域id寻找对应记录并将该旧id替换为新的区域id。

4. 字段数据超长了怎么办？

部分接口规则文档中，已经对必要字段注明了最大长度，单位是字符，无论中英文都算一个字符。最大长度规定一般情况下都是已经设置的合理长度，如果任何字段超长则数据将无法正确导入，请进行截取。

5. 所有数据都需要导入吗？

建议只需要把正在用、可能用的数据导入过来，一些其他早已废弃的旧数据就无需导入过来了，以节省导入时间和存储空间。

比如旧平台中的区域表中有已经删除了的区域数据（这里假设站方使用的是软删，即标记删除，而非物理删除数据），那么接口给出的数据就不需要给出已经删除了的区域数据。

常规接口开发

1. 接口编码好像有问题，该怎么设置？

编码问题大部分出现在使用GBK编码的论坛站点上，一般遵循以下两点设置基本能解决问题：

确保编写脚本的代码文件与论坛使用的编码一致。如使用PHP脚本写接口且论坛编码为GBK，则在IDE或其他编辑器中将PHP脚本文件编码设为GBK。
因为使用json格式的数据进行传输，在PHP脚本中所使用的数据编码需为UTF-8，所以从GBK编码的数据库中取出GBK编码的数据后，将该数据转换成UTF-8编码后进行json_encode

2. 为什么在后台设置了接口却不能正常显示？

遇到这种情况，您可能需要检查：

后台是否填写在了正确的输入框。
是否按照文档要求正确开发接口。
编码是否有问题（上面有解决方法）。
被调用接口的地址是否屏蔽了请求来源，若是则将请求方IP加入白名单。

如果还是未能解决问题，请联系我方技术人员协助排查问题。