# callback说明
BIMFACE支持回调机制。在调用方发起模型转换、模型集成、模型对比、生成离线数据包等操作时，可以通过传入参数callback的方式来启用回调机制。 在BIMFACE处理完相应操作后，根据调用方传入的回调地址通知调用方相应操作的结果。
# callback说明
GET callback地址
# Url参数
| 字段 | 类型 | 描述 | 示例 |
|---|---|---|---|
| fileId | Number | 文件ID(与集成模型ID,对比ID、场景ID 四选一) | 1938888813662976 |
| integrateId | Number | 集成模型ID(与文件ID、对比ID、场景ID 四选一) | 1738888866720224 |
| compareId | Number | 对比ID(与文件ID、集成模型ID、场景ID 四选一) | 2077707858585728 |
| sceneId | Number | 场景ID(与文件ID、集成模型ID,对比ID 四选一) | 2017707858581568 |
| thumbnail | String | 缩略图地址，多个缩略图用","分隔(该字段适用于发起模型转换、模型集成、模型对比) | 38044a282f55cb26e3704643dccd2b55/thumbnail/256.png |
| status | String | 模型处理状态或者数据包处理状态：processing(进行中)，success(完成)，failed(失败) | processing |
| reason | String | 若模型处理失败或者数据包处理失败，则返回失败原因 | … |
| nonce | String | 回调随机数 | … |
| signature | String | 签名 | … |
signature（签名）：为了确保回调消息是由BIMFACE发出的，调用方在收到回调消息后，须验证签名。签名的计算方式：MD5(``appKey:appSecret:compareId:status:nonce'')，如果调用方计算的签名与BIMFACE返回的签名一致，则证明该消息是安全可靠的。
# 消息回执
应用收到回调后，须向BIMFACE发送回执，回执消息：HTTP STATUS 200
# callbac示例
* 调用方对文件1685236328506848发起了模型转换，并且传入的回调地址是：https://my.app.com/callback。
* BIMFACE在模型转换任务处理完成后，会发送一个get请求到调用方的callback地址：
https://my.app.com/callback?fileId=1938888813662976&status=success&thumbnail=38044a282f55cb26e3704643dccd2b55/thumbnail/96.png,38044a282f55cb26e3704643dccd2b55/thumbnail/256.png&reason=&signature=99a6fccb1894dfdb4cce48fd5ec58110&nonce=123abc
* 调用方接收到这条请求后，可以进行signature的验证，并发送回执消息。