AlipayContent.Apis.Interfaces 1.3.1

AlipayContent.Apis.Interfaces

支付宝内容发布API接口定义库，提供支付宝生活号+内容发布相关的接口定义和数据传输对象(DTO)。

功能特性

• 🚀 文件上传：支持本地文件上传和URL文件上传两种方式
• 📝 内容发布：支持短图文和视频内容发布
• 🔍 内容查询：支持单条内容状态查询
• ✅ 数据验证：内置完整的数据验证特性
• 📋 完整文档：提供详细的XML文档注释

支持的接口

文件上传接口

• FileUpload - 本地文件上传（支持大文件流式上传）
• FileUploadByUrl - 通过URL上传文件

内容管理接口

• ContentPublish - 内容发布接口
• ContentQuery - 单条内容状态查询接口
• ContentBatchQuery - 批量内容查询接口
• ContentDelete - 内容删除接口

安装

dotnet add package AlipayContent.Apis.Interfaces

使用示例

文件上传DTO

public class AlipayFileUploadDto
{
    [Required(ErrorMessage = "上传文件不能为空")]
    public IFormFile File { get; set; }
    
    [Required(ErrorMessage = "素材使用场景不能为空")]
    public string BizCode { get; set; } = "content_creation";
}

URL文件上传DTO

public class AlipayFileUploadByUrlDto
{
    [Required(ErrorMessage = "文件URL地址不能为空")]
    [Url(ErrorMessage = "请输入有效的URL地址")]
    public string FileUrl { get; set; }
    
    public string BizCode { get; set; } = "content_creation";
}

内容发布DTO

public class AlipayContentPublishDto
{
    [Required(ErrorMessage = "内容类型不能为空")]
    [RegularExpression("^[12]$", ErrorMessage = "内容类型只能是1（短图文）或2（视频）")]
    public string SourceType { get; set; } = "1";

    [MaxLength(128, ErrorMessage = "内容标题长度不能超过128位")]
    public string? SourceTitle { get; set; }
}

批量内容查询DTO

public class AlipayContentBatchQueryInput
{
    [MaxLength(32, ErrorMessage = "生活号+号ID长度不能超过32位")]
    public string? PublicId { get; set; }

    public bool NeedDetail { get; set; } = false;

    [RegularExpression("^[0123]$", ErrorMessage = "内容状态只能是0（审核中）、1（发布成功）、2（审核不通过）或3（已删除）")]
    public string? Status { get; set; }

    [Range(1, int.MaxValue, ErrorMessage = "页码必须大于0")]
    public int PageNum { get; set; } = 1;

    [Range(1, 20, ErrorMessage = "分页大小必须在1-20之间")]
    public int PageSize { get; set; } = 20;
}

内容删除DTO

public class AlipayContentDeleteInput
{
    [Required(ErrorMessage = "内容ID不能为空")]
    [MaxLength(64, ErrorMessage = "内容ID长度不能超过64位")]
    public string ContentId { get; set; } = string.Empty;

    [MaxLength(64, ErrorMessage = "生活号+号ID长度不能超过64位")]
    public string? PublicId { get; set; }
}

数据验证

所有DTO类都包含完整的数据验证特性：

• [Required] - 必填字段验证
• [MaxLength] - 最大长度验证
• [RegularExpression] - 正则表达式验证
• [Url] - URL格式验证
• [Range] - 数值范围验证

版本要求

• .NET 9.0 或更高版本
• Microsoft.AspNetCore.Http.Features 5.0.17+

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

贡献

欢迎提交问题和功能请求！

更新日志

v1.2.0

• 新增内容删除接口
• 支持删除指定内容ID的内容
• 完善内容管理功能

v1.1.0

• 新增批量内容查询接口
• 支持分页查询和内容详情返回
• 优化数据验证特性

v1.0.0

• 初始版本发布
• 支持文件上传（本地文件和URL文件）
• 支持内容发布和查询
• 完整的数据验证支持