首页
/ EvolutionAPI 中媒体类型参数的正确使用方法

EvolutionAPI 中媒体类型参数的正确使用方法

2025-06-25 18:39:26作者:尤辰城Agatha

在使用 EvolutionAPI 发送媒体消息时,开发者经常会遇到关于 mediatype 参数的配置问题。本文将详细解析该参数的正确使用方法,帮助开发者避免常见的配置错误。

问题背景

许多开发者在尝试通过 EvolutionAPI 发送文档或音频等媒体消息时,会遇到类似 "instance requires property \"mediatype\"" 的错误提示。这通常是由于 API 版本差异或参数命名不规范导致的。

参数配置解析

文档发送的正确格式

对于文档类型的媒体消息,正确的请求体格式应该是:

{
  "number": "#############",
  "mediatype": "document",
  "fileName": "teste.pdf",
  "media": "base64编码的文档内容"
}

关键点在于:

  1. mediatype 必须作为顶级属性直接出现在请求体中
  2. 属性名必须完全小写 mediatype,而不是 mediaTypeMediaType
  3. 文档类型应指定为 "document"

音频发送的正确格式

对于音频消息,正确的请求体格式更为简洁:

{
  "number": "手机号码",
  "audio": "base64编码的音频内容"
}

API 版本差异说明

这个问题主要源于 API 版本的不同:

  1. v1 版本:需要使用 mediaMessage 嵌套结构,并包含 mediaType 属性
  2. v2 版本:参数更为扁平化,直接使用 mediatype 作为顶级属性

开发者应当根据自己使用的 API 版本选择合适的参数结构。如果使用的是最新版本,建议采用 v2 的扁平化参数结构,它更加简洁直观。

最佳实践建议

  1. 始终确认你使用的 API 版本
  2. 对于不确定的参数,可以先进行小规模测试
  3. 注意参数的大小写,API 通常对大小写敏感
  4. 文档和音频的发送方式有所不同,需分别处理
  5. 确保媒体文件的 base64 编码正确无误

通过遵循这些指导原则,开发者可以避免大多数与媒体类型参数相关的配置问题,确保消息能够成功发送。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
176
261
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
860
511
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
93
15
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
129
182
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
259
300
kernelkernel
deepin linux kernel
C
22
5
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
595
57
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.07 K
0
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
398
371
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
332
1.08 K