摘要
本文档可帮助您排查使用 Astra 中的 REST API 操作时遇到的常见问题。内容涵盖了诸如缺少表单参数、潜在客户数据限制、身份验证错误等常见问题，以及重要的安全注意事项，以确保您的集成可靠运行。
说明
表单已提交：参数未传递
问题
自定义表单提交后，您的 REST API 接收到的是空值或缺失值。
原因
这通常发生在 REST API 配置中使用的占位符与表单字段名称不完全匹配时。
匹配是区分大小写的，并且基于占位符的后缀（最后一个 . 之后的部分）。
解决方案
确保占位符后缀与您的表单字段名称完全匹配。
示例：
表单字段
first_name→ 占位符{{first_name}}或{{contact.first_name}}✅表单字段
firstName→ 占位符{{contact.first_name}}❌原因：大小写不匹配（
firstName≠first_name）
更正占位符后，保存操作并再次进行测试。
潜在客户已捕获：自定义字段不起作用
问题
您想通过潜在客户已捕获事件发送额外的或自定义字段。
原因
潜在客户已捕获事件始终发送固定的请求体结构。此事件类型不支持自定义字段。
任何自定义的 request_body 配置都将被忽略。
替代方案
如果您需要发送自定义数据，请使用以下选项之一：
使用自定义表单的表单已提交事件
具有可自定义请求体的意图驱动触发器
这些选项允许您精确控制发送到 API 的数据。
身份验证错误
问题
您的 API 返回 401 Unauthorized 错误。
解决方案
验证您的 API 密钥或令牌是否正确
确保令牌尚未过期
更新凭据后，再次测试该操作。
安全说明
Astra 包含内置的安全措施，以保护您的数据和集成。
凭据受到保护
查看操作详情时，API 密钥和密码会进行掩码处理（
*****）
防止服务器端请求伪造 (SSRF)
对内部或私有网络地址的请求会被自动阻止
提供测试模式
使用测试模式验证您的 REST API 操作，而不会影响实时数据或分析
遵循这些指南将帮助您快速排查问题，并确保您的 REST API 操作安全可靠。