应用研发平台EMAS这个接口参数怎么传？每个参数各是啥意思？

在应用研发平台 EMAS 中，/amdc/mobileDispatch 接口的具体参数传递方式和每个参数的含义如下。以下是详细的说明：

接口参数说明

1. AppKey

• 类型: long
• 是否必填: 是
• 描述: 应用的唯一标识符，用于区分不同的应用。
• 示例值: 23267207
• 注意事项: 确保传入正确的 AppKey，否则可能导致推送失败。

2. Target

• 类型: string
• 是否必填: 是
• 描述: 指定推送的目标类型。可选值包括：
  • DEVICE: 根据设备 ID 推送。
  • ACCOUNT: 根据账号推送。
  • ALIAS: 根据别名推送。
  • TAG: 根据标签推送。
  • ALL: 推送给全部设备。
• 示例值: ALL
• 注意事项:
  • 如果选择 DEVICE、ACCOUNT 或 ALIAS，需要在 TargetValue 中提供具体的值。
  • 如果选择 ALL，则无需指定具体目标值。

3. TargetValue

• 类型: string
• 是否必填: 是
• 描述: 根据 Target 的值设置具体的目标内容：
  • Target=DEVICE: 值为设备 ID 列表，多个值用逗号分隔（最多支持 1000 个）。
  • Target=ACCOUNT: 值为账号列表，多个值用逗号分隔（最多支持 1000 个）。
  • Target=ALIAS: 值为别名列表，多个值用逗号分隔（最多支持 1000 个）。
  • Target=TAG: 支持单标签或多标签，格式需符合标签格式要求。
  • Target=ALL: 值固定为 ALL。
• 示例值: deviceid111,deviceid1111
• 注意事项:
  • 超过限制数量时，需分多次推送。
  • 标签格式需参考相关文档。

4. Title

• 类型: string
• 是否必填: 是
• 描述: 推送通知的标题。
• 示例值: title
• 注意事项: 标题内容应简洁明了，便于用户快速理解通知内容。

5. Body

• 类型: string
• 是否必填: 是
• 描述: 推送通知的内容。
• 示例值: body
• 注意事项: 内容长度需适中，避免因过长导致显示不全。

6. StoreOffline

• 类型: boolean
• 是否必填: 否
• 描述: 是否离线保存通知。默认值为 false。
  • 如果设置为 true，当用户不在线时，通知会在过期时间（ExpireTime）内保存，并在用户上线时再次发送。
  • 默认过期时间为 72 小时。
• 示例值: true
• 注意事项:
  • 离线保存功能适用于需要确保消息送达的场景。
  • 过期时间不可超过 72 小时。

7. JobKey

• 类型: string
• 是否必填: 否
• 描述: 推送任务的自定义标识。当 JobKey 不为空时，回执日志中会附带该字段。
• 示例值: 123
• 注意事项:
  • 可用于追踪推送任务的状态。
  • 查看回执日志需参考相关文档。

8. ExtParameters

• 类型: string
• 是否必填: 否
• 描述: 自定义的扩展参数，供开发者扩展使用。需以 JSON map 的格式传入。
• 示例值: {"key1":"value1","api_name":"PushNoticeToAndroidRequest"}
• 注意事项:
  • 扩展参数需符合 JSON 格式，否则可能导致解析错误。
  • 针对 Android 设备的特定需求，可通过此参数实现定制化功能。

重要提醒

• QPS 限制: 在高并发场景下，建议使用批量推送接口（如 MassPush），以降低 QPS 并提高推送成功率。
• SDK 版本要求: 使用 /amdc/mobileDispatch 接口时，需确保 SDK 升级到 3.11.0 及以上版本。
• 签名机制: 如果未使用官方 SDK，需自行实现签名机制，建议加入服务钉钉群（78410016550）获取专家指导。

通过上述参数配置，您可以灵活地实现针对不同目标的推送需求。如有进一步问题，请参考相关文档或联系技术支持团队。