API 请求体字段定义询问各位大佬。

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

For Existing Member Sign In

This topic created in 430 days ago, the information mentioned may be changed or developed.

我们的场景是后端给前端暴露发布帖子的 api ，界面上是有明确的标题跟内容的 UI 区分的。

公司里的实习生在给前端暴露 api 的时候，给前端暴露了下述的 api：
const response: AxiosResponse<FeedFlow.PublishPostResponse> = await this.apiClient.post('/feed-flow/publish-post', {
authorId: request.authorId,
content: `${request.title}\n${request.content}`,
});

后端同学的存储格式是把 title 跟 content 正文存储在一个一段里面，按行分割。前端同学觉得要在 api 的层面上把 title 跟 content 通过字符拼接再赋值给 content 字段很不自然。后端同学觉得没什么所谓，觉得数据库里面定的就是这个字段，直接给他拼好就行了。

我的看法是，api 的提供需要是从代码层面上就有清晰语义的，这种字段的说明比较难以让人理解。

想问问大佬们怎么看待这个问题，有什么理据能够支撑各自的观点？

API

字段定义

语义

16 replies • 2025-02-22 11:51:36 +08:00