请求和响应 Requests and Responses

Strapi 后端服务器基于 Koa。当您通过 REST API 发送请求时，上下文对象 (ctx) 会传递给 Strapi 后端的每个元素（例如 policies、controllers、services）。

ctx 包含 3 个主要对象：

• ctx.request 用于获取客户端发出 API 请求时发送的请求信息，
• ctx.state 用于获取 Strapi 后端内请求状态信息，
• ctx.response 用于获取服务器将返回的响应信息。

该图表示请求如何通过 Strapi 后端的简化版本，其中突出显示了请求和响应。后端定制介绍页面包含一个完整的交互式图表。

ctx.request

ctx.request 对象包含以下参数：

协议、来源、url、href、路径、主机和主机名之间的区别：

给定一个发送到 https://example.com:1337/api/restaurants?id=123 URL 的 API 请求，以下是 ctx.request 对象返回的不同参数：

ctx.request.query

ctx.request 提供了一个 query 对象，可以访问 Strapi 查询参数。下表列出了可用的参数，并附有简短说明和相关 REST API 文档部分的链接（有关更多信息，请参阅 REST API 参数）：

ctx.state

ctx.state 对象允许访问 Strapi 后端内请求的状态，包括有关 用户、身份验证、路由 的特定值：

ctx.state.user

ctx.state.user 对象允许访问有关执行请求的用户的信息，并包含以下参数：

ctx.state.auth

ctx.state.auth 对象允许访问与身份验证相关的信息，并包含以下参数：

ctx.state.route

ctx.state.route 对象允许访问与当前路由相关的信息，并包含以下参数：

ctx.response

ctx.response 对象可以访问并返回服务器的响应信息，并包括以下参数：

在任何地方访问请求上下文

Strapi 公开了一种从代码中的任何位置访问当前请求上下文的方法（例如生命周期函数）。

您可以按如下方式访问请求：

const ctx = strapi.requestContext.get()

您只应在 HTTP 请求上下文中调用的函数内部使用它。

// correct

const service = {
  myFunction() {
    const ctx = strapi.requestContext.get()
    console.log(ctx.state.user)
  },
}

// incorrect
const ctx = strapi.requestContext.get()

const service = {
  myFunction() {
    console.log(ctx.state.user)
  },
}

Example:

module.exports = {
  beforeUpdate() {
    const ctx = strapi.requestContext.get()

    console.log('User info in service: ', ctx.state.user)
  },
}