Q1、接口请求返回“该接口未开通，请联系巧房实施进行开通”时怎么处理？
A:开放平台所有接口均需申请后才会开通，部分接口为付费后开通（付费接口范围为接口说明文档中带有“付费”字样的分类下所有接口），接口开通申请可联系对应销售提交；
Q2、接口请求返回“开放平台暂未绑定此平台，请客户方联系巧房销售/实施进行开通！”时怎么处理？
A:若当前自研平台已对接过开放平台接口，则可能是经纪公司自研平台后台服务端IP地址发生变化，可通过系统侧边栏-帮助反馈-反馈与查询-反馈问题-工单分类选择“巧房-开放平台”提交工单，写明公司库UUID、自研平台名称、当前后台服务端IP地址，将会有后台人员处理添加请求IP白名单；
若当前自研平台未对接过开放平台接口，则需联系销售申请开通对接新平台；
Q3、接口请求返回“绑定平台已到期，请客户方联系巧房销售/实施进行续期操作”时怎么处理？
A:开放平台对接默认有效期限为1年，到期后需联系销售申请续期；
Q4、接口请求返回“签名错误”时怎么处理？
A:开放平台接口请求的密钥可能发生更新，可在“系统”-“开发平台”-“密钥管理”页面获取新的appsercret密钥重新进行请求；
Q5、发现系统中有的房源/图片/vr等数据接口请求未返回，该怎么处理？
A:开放平台接口数据同步可能会存在延迟，可等待一天后重新请求或，若仍无法通过接口获取到，可通过系统侧边栏-帮助反馈-反馈与查询-反馈问题-工单分类选择“巧房-开放平台”提交工单，写明请求接口名称、请求参数、系统中未同步到接口的数据截图，将会有技术人员进行排查；
Q6、现有接口入参或出参不满足自研平台开发需求怎么办？
A:当现有接口入参或出参不满足贵公司自研平台开发需求时，可联系对应销售提报需求进行接口定制开发评估，接口定制开发将会涉及到开发费用，可通过销售咨询具体收费详情；
Q7、如何获取新增房源/员工/房源视频/房源VR/房源图片/房源带看数据？
A:第一步、调用“分页拉取资源”接口（pullResourceUuidList），请求参数说明： （1）“resourceType”参数中传入对应所选资源类型值；
（2）“scrollId”参数第一次请求不需要传值的，当第一次请求有数据返回后，第二次请求时，可以将第一次请求得到的最大的resourceId作为scrollId值，依次分页拉取数据；
（3）“startUpdatedTime”、“endUpdatedTime”参数，为限定房源数据更新的时间区间，按照实际需求传入需查询的新增数据时间区间，将得到在该时间区间内发生过更新的相关数据；
第二步、根据获取到的资源UUID，再调用相关的资源详细信息查询接口来获取这些资源UUID的详细信息：
| “resourceType”参数值 | 返回资源UUID | 使用方法 |
|---|---|---|
| PROPERTY_BASE | 返回资源UUID为“公共营销房房源UUID（propertyBaseUuids）” | 可作为“查询全部房源”/"查询有效房源"/"查询公共营销库房源V1.0"接口的“propertyBaseUuids”请求参数使用； |
| PROPERTY_VIDEO | 返回资源UUID为“房源videoUuid” | 可作为“查询房源视频”接口的“uuids”请求参数使用； |
| PROPERTY_VR_INFO | 返回资源UUID为“房源vrInfoUuid” | 可作为“查询全景房VR”接口的“uuids”请求参数使用 |
| PROPERTY_VR_PHOTO | 返回资源UUID为“房源vrPhotoUuid” | 可作为“查询全景房2D-VR”接口的“uuids”请求参数使用 |
| BROKER_INFO | 返回资源UUID为“员工UUID” | 可作为“查询全部员工”接口的“employeeUuids”请求参数使用 |
| PROPERTY_ROLE | 返回资源UUID为“角色人UUID” | 可作为“查询房源角色人”接口的“uuids”请求参数使用 |
| PROPERTY_PHOTO | 返回资源UUID为“房源photoUuid” | 可作为“查询房源图片”接口的“uuids”请求参数使用 |
| PROPERTY_INSPECTION | 返回资源UUID为“带看Uuid” | 可作为“查询房源带看记录”接口的“uuids”请求参数使用 |
Q8、查询有效房源、查询全部房源接口中返回的propertyBaseUuid与propertyUuid有什么区别？
A：propertyBaseUuid可作为“/api/marketingopenapi”地址下的接口房源UUID入参，propertyUuid可作为“/api/jediopenplatformopenapi”地址下的接口房源UUID入参；
Q9、查询全部员工、查询有效员工接口中返回的employeeUuid与externalEmployeeUuid有什么区别？
A:employeeUuid可作为“/api/marketingopenapi”地址下的接口员工UUID入参，externalEmployeeUuid可作为“/api/jediopenplatformopenapi”地址下的接口员工UUID入参；
Q10、房源状态变更后（如房源状态由出租改为出售）是否会生成新的房源？
A:若巧房系统未开启租售分离设置，则房源状态变更后不会生成新的房源uuid,原房源状态字段将发生更新，可通过分页拉取资源接口获取到对应时间段内房源状态发生更新的房源UUID集合；若巧房系统开启了租售分离设置，则房源状态由出租改为出售后会生成新的房源UUID，原房源UUID的房源状态将不会发生变化；
Q11、“查询有效房源”与“查询全部房源”接口有什么区别？
A:“查询有效房源”接口返回的房源不包括已删除、无效、封盘、保护房状态的房源，即仅可获取出租、出售、租售状态的房源；“查询全部房源”接口可返回所有状态的房源；
Q12、报表接口获取的数据怎么跟系统展示数据不一致？
A：报表接口获取的数据量不要跟系统列表展示的数据量进行比对（因为系统列表展示有默认的筛选过滤逻辑，与报表筛选过滤逻辑不一致），报表接口获取的数据量应该与系统中"数据"-"报表管理"页面对应报表统计数据进行比对，且需要注意系统中对应报表界面显示的更新时间、界面默认的筛选条件与接口请求参数是否一致；
Q12、其他接口使用上的问题或返回数据问题需要协助怎么处理？
A：，若需巧房技术协助排查，可通过系统侧边栏-帮助反馈-反馈与查询-反馈问题-工单分类选择“巧房-开放平台”提交工单，写明使用接口名称、请求参数、接口返回参数、系统报表界面数据展示截图（返回数据不一致情况排查时需提供，且截图中可清楚看到系统完整查询条件及数据总量）、问题描述，以上信息请尽可能完整提供，信息不全时将会影响问题处理效率;