已经拿到了imageid 然后从哪个接口可以获取图片文件呢?
根据您的问题,我可以为您提供以下信息:
一旦您获得了imageId,您可以使用以下几个API接口来获取图片文件:
获取文档图片: Get document images
GET https://api.sumsub.com/resources/inspections/{inspectionId}/resources/{imageId}
从申请人操作中获取图片: Get image from applicant action
GET https://api.sumsub.com/resources/applicantActions/{actionId}/images/{imageId}
这些接口会返回二进制内容,代表图片文件。响应头中的Content-Type会准确描述返回的MIME类型。
请注意,您每次请求只能获取一张图片。调用这些接口时,需要提供相应的inspectionId或actionId,以及您已获得的imageId。
如果您需要更多关于文件格式和MIME类型的信息,可以参考Sumsub的FAQ部分。
Reference > Get document images Reference > Get image from applicant action
All feedback is reviewed by the team.
Answer based on the following sources:
Get document images
Get image from applicant action
在处理Get information about document images的接口返回时为什么会遇到image: unknown format? 报这个错的都是以liveness_photo开头的文件,身份证上传的可以正常识别?为什么?怎么解决?
根据您的问题,我理解您在处理"Get information about document images"接口返回时遇到了"image: unknown format"的错误,特别是对于以"liveness_photo"开头的文件,而身份证上传的文件可以正常识别。这个问题可能涉及到文件格式和处理方式的差异。让我为您分析一下可能的原因和解决方案:
文件格式差异: Sumsub支持多种文件格式,但对于不同类型的文档可能有特定的要求。根据Support > General-rules > Photo Requirements中的信息,Sumsub接受的文件格式包括JPG, JPEG, PNG和PDF。liveness照片可能使用了不同的格式或编码方式,导致系统无法识别。
文件大小和质量: 同样根据上述文档,上传的文件大小应不小于100 KB或300 DPI。如果liveness照片不符合这些要求,可能会导致识别问题。
处理方式差异: 根据Docs > Live capture的说明,live capture是通过设备摄像头实时拍摄的方法。这种方式可能产生的图片格式或元数据与直接上传的身份证照片有所不同。
解决方案:
检查文件格式: 确保liveness照片保存为Sumsub支持的格式(JPG, JPEG, PNG)。如果可能,尝试将文件转换为这些格式之一。
验证文件大小和质量: 确保liveness照片符合Sumsub的最低大小和质量要求。
检查文件元数据: liveness照片可能包含特殊的元数据。尝试清除或标准化这些元数据。
联系Sumsub支持: 如果问题持续存在,建议联系Sumsub的技术支持。根据Reference > Errors中的说明,您可以提供correlationId给Sumsub团队,以便他们进行更深入的调查。
查看SDK更新: 如果您使用的是Sumsub的SDK,检查是否有新版本可用。例如,Docs > Version 1.14.0提到了对liveness检测的改进。
检查API调用: 确保您正确地调用了API,包括所有必要的参数和头信息。参考Reference > Get information about document images以确保您的请求格式正确。
如果这些方法都无法解决问题,我建议您直接联系Sumsub的技术支持团队,提供具体的错误信息和correlationId,他们应该能够提供更具体的指导。
All feedback is reviewed by the team.
Answer based on the following sources:
Errors
Live capture
Photo Requirements
support.sumsub.com/general-rules
support.sumsub.com/general-rules
Show all (5)
我通过Get information about document images的接口获取用户的imageid然后通过Get document images接口获取这些照片。在使用golang的image库处理从Get document images接口获取的照片时遇到image: unknown format? 报这个错的都是以liveness_photo开头的文件,身份证上传的则可以正常处理,为什么?怎么解决?
您的问题很有趣,让我们来分析一下这个情况。
首先,您使用的方法是正确的。您通过"Get information about document images"接口获取imageid,然后使用"Get document images"接口获取实际的图片文件。这个流程是符合Sumsub API的使用方式的。
关于您遇到的"image: unknown format"错误,特别是对于liveness_photo文件,而身份证照片可以正常处理,这可能有以下几个原因:
文件格式差异: 根据Reference > Get document images的说明,返回的内容类型(Content-Type)可能会有所不同。liveness照片可能使用了一种Go的image库不能直接识别的格式。
图片编码方式: Liveness照片可能使用了特殊的编码方式或压缩算法,这可能不被Go的标准image库所支持。
元数据差异: Liveness照片可能包含额外的元数据,这可能会干扰Go image库的格式识别。
解决方案:
检查Content-Type: 在调用"Get document images"接口时,检查响应头中的Content-Type。这会告诉您确切的文件类型。根据这个信息,您可能需要使用不同的解码方法。
使用原始字节: 如果Go的image库无法识别格式,您可以尝试直接使用原始字节数据,而不是通过image库解码。
尝试其他图片处理库: 考虑使用其他更强大的图片处理库,如github.com/disintegration/imaging,它可能支持更多的图片格式。
手动检测文件类型: 您可以实现一个函数来检查文件的魔数(magic numbers),以确定确切的文件类型,然后根据类型使用适当的解码方法。
联系Sumsub支持: 如果问题持续存在,建议联系Sumsub的技术支持。根据Reference > Errors中的说明,提供具体的错误信息和correlationId给Sumsub团队,以获取更专业的帮助。
检查图片大小: 确保liveness照片符合Sumsub的大小要求。虽然这不太可能导致格式未知的错误,但仍然值得检查。
日志记录: 对于无法处理的图片,记录下它们的详细信息,包括文件大小、前几个字节的内容等,这可能有助于诊断问题。
如果您尝试了这些方法后仍然无法解决问题,我建议您直接联系Sumsub的技术支持团队,提供您的代码示例和具体的错误信息。他们应该能够提供更具体的指导,特别是关于liveness照片的格式和处理方式。
Reference > Get document images Reference > Errors
All feedback is reviewed by the team.
Answer based on the following sources:
Errors
Response explained
为什么Get information about document images的接口获取用户的image信息中 文件名以.jpg结尾 但是fileType是png? 例如: {
"id" : "219503712",
"previewId" : "1828897232",
"addedDate" : "2024-12-20 12:59:53",
"fileMetadata" : {
"fileName" : "7607e1e-China-ID1-9e995aa2b4f29c33df34d56c77131d84.jpg",
"fileType" : "png",
"fileSize" : 639808,
"resolution" : {
"width" : 742,
"height" : 464
}
},
您提出了一个很有趣的观察。这种文件名后缀和实际文件类型不匹配的情况确实可能令人困惑。让我解释一下可能的原因:
文件转换: Sumsub可能在内部处理过程中将上传的图片转换为PNG格式,以确保图像质量或一致性。这种转换可能发生在上传后,但原始文件名被保留。
文件名不可靠: 文件名扩展名并不总是准确反映文件的实际格式。Sumsub的系统可能会检查文件的实际内容来确定其真实格式,而不仅仅依赖于文件名。
系统优化: 为了优化存储或处理,Sumsub可能会将所有图像统一转换为PNG格式,但保留原始文件名以便于追踪。
API响应设计: fileMetadata.fileType字段可能被设计为反映文件的实际格式,而不是文件名中的扩展名。
用户上传行为: 用户可能上传了一个实际为PNG格式的文件,但文件名错误地使用了.jpg扩展名。Sumsub的系统正确地识别了实际格式。
解决方案和建议:
依赖fileType: 在处理这些图像时,应该始终依赖fileMetadata.fileType字段,而不是文件名来确定文件格式。
文档一致性: 您可以向Sumsub提出反馈,建议他们在API文档中明确说明fileName和fileType可能不一致的情况,以避免其他开发者的困惑。
验证流程: 如果这种不一致对您的系统有影响,考虑实施额外的验证步骤,以确保您的应用程序能够正确处理这种情况。
联系Sumsub支持: 如果这个问题对您的集成造成了重大影响,您可以联系Sumsub的技术支持,询问他们是否可以提供更一致的文件命名和类型标识。
总的来说,这种不一致性虽然可能令人困惑,但不太可能影响实际的图像处理。重要的是要依赖fileType字段来确定正确的文件格式,而不是文件名。
Reference > Get information about document images中提到了fileMetadata对象的结构,但没有具体说明这种可能的不一致性。在实际应用中,始终以fileType为准是最安全的做法。
All feedback is reviewed by the team.
Answer based on the following sources:
Response explained