You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

为什么Facebook Send API中payload的url属性为可选参数

关于Facebook Send API message.attachment.payload.url 属性可选的说明

url 被设计为可选参数,是因为Send API支持三类附件发送方式,其中两种场景不需要传递该字段:

  • 本地文件直传场景:你可以将本地文件以 multipart/form-data 格式和接口请求参数一同提交,此时 payload 中仅需按需填写 is_reusable 字段即可,不需要额外指定 url,接口会直接读取你上传的二进制文件内容完成发送。
  • 复用已上传附件场景:如果之前发送附件时将 is_reusable 设置为 true,接口会返回一个唯一的 attachment_id,后续需要发送相同附件时,仅需在 payload 中传入该 attachment_id 即可,不需要再传递 url 也不需要重新上传文件,适合高频发送相同素材的业务场景。

只有当你使用公网可访问的文件链接发送附件时,才需要填写 url 字段。官方文档不存在错误,是上述两个特性的存在让 url 成为了非必填参数。

内容的提问来源于stack exchange,提问作者Pop Flamingo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.03 12:18:05