rest - POST 的 RESTful API 中的多个路径参数与查询参数？

Question

我正在尝试实现一个宁静的 API

我有一个名为 Program 的实体（描述和位置详细信息）

我有一个名为 Timing 的实体（程序 + 开始时间 + 结束时间）

我有一个名为 Check-In 的实体（时间 + 用户详细信息）

场景：我需要签到可用的时间，

POST 请求的理想 URL 应该如何，选项 A

POST /programme/:id/timing/:id/check-in
query param: null

选项 B

POST /check-in
request body: {programme=id,timing:id}

第一种方式会直接使用路径参数中的id，直接识别资源。第二种方式，消费者告诉资源的类型，在过滤条件中提到资源的类型。

注意：我们将 UUID 用于 Program 和 Timing 资源，这会使 URL 略大

标签： restapi-designrestful-url

Answer 1

两者都可以，但 GET 更适合请求信息。只要您的网址小于 4000 字节，就不会成为问题。