Gewechat

发送视频消息

POST

/message/postVideo

注意

发送视频接口会返回cdn相关的信息，如有需求同一个视频发送多次，第二次及以后发送时可使用接口返回的cdn信息拼装xml调用转发视频接口，这样可以缩短发送时间

请求参数

Header 参数

X-GEWE-TOKEN

string

必需

示例值:

Body 参数application/json

appId

string

设备ID

必需

toWxid

string

好友/群的ID

必需

videoUrl

string

视频的链接

必需

thumbUrl

string

缩略图的链接

必需

videoDuration

integer

必需

视频的播放时长，单位秒

示例

{
  "appId": "{{appid}}",
  "toWxid": "{{toWxid}}",
  "videoUrl": "https://scrm-1308498490.cos.ap-shanghai.myqcloud.com/1/41734f00f3803ca1cd8f5ad6d5f8d559.mp4?q-sign-algorithm=sha1&q-ak=AKIDmOkqfDUUDfqjMincBSSAbleGaeQv96mB&q-sign-time=1724227372;2588140972&q-key-time=1724227372;2588140972&q-header-list=&q-url-param-list=&q-signature=4e18eb97ab165f27afe0444516e54204f506c7e1",
  "thumbUrl": "https://scrm-1308498490.cos.ap-shanghai.myqcloud.com/1/logo.jpg?q-sign-algorithm=sha1&q-ak=AKIDmOkqfDUUDfqjMincBSSAbleGaeQv96mB&q-sign-time=1724227462;2588141062&q-key-time=1724227462;2588141062&q-header-list=&q-url-param-list=&q-signature=0bc8b973567d2672e5eaada1b5d466e23ce6b750",
  "videoDuration": 10
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/message/postVideo' \
--header 'X-GEWE-TOKEN: {{gewe-token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "toWxid": "{{toWxid}}",
    "videoUrl": "https://scrm-1308498490.cos.ap-shanghai.myqcloud.com/1/41734f00f3803ca1cd8f5ad6d5f8d559.mp4?q-sign-algorithm=sha1&q-ak=AKIDmOkqfDUUDfqjMincBSSAbleGaeQv96mB&q-sign-time=1724227372;2588140972&q-key-time=1724227372;2588140972&q-header-list=&q-url-param-list=&q-signature=4e18eb97ab165f27afe0444516e54204f506c7e1",
    "thumbUrl": "https://scrm-1308498490.cos.ap-shanghai.myqcloud.com/1/logo.jpg?q-sign-algorithm=sha1&q-ak=AKIDmOkqfDUUDfqjMincBSSAbleGaeQv96mB&q-sign-time=1724227462;2588141062&q-key-time=1724227462;2588141062&q-header-list=&q-url-param-list=&q-signature=0bc8b973567d2672e5eaada1b5d466e23ce6b750",
    "videoDuration": 10
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

data

object

必需

toWxid

string

接收人的wxid

必需

createTime

null

发送时间

必需

msgId

integer

消息ID

必需

newMsgId

integer

消息ID

必需

type

null

消息类型

必需

aesKey

string

必需

cdn相关的aeskey

fileId

string

必需

cdn相关的fileid

length

integer

视频文件大小

必需

示例

{
  "ret": 200,
  "msg": "操作成功",
  "data": {
    "toWxid": "34757816141@chatroom",
    "createTime": null,
    "msgId": 769523567,
    "newMsgId": 945590746179451500,
    "type": null,
    "aesKey": "687a636f627579667a756a7168717968",
    "fileId": "3052020100044b304902010002043904752002033d11ff02045dd79b240204658e9072042466633131376136662d366566632d343638662d613633662d3536316139616133383362350204012400040201000400",
    "length": 1315979
  }
}

修改于 2025-03-06 09:34:06

发送语音消息

发送链接消息

发送视频消息

注意#

请求参数

示例代码

返回响应

注意