跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

评估 API

最后更新 查看 MarkdownAgent 设置

无法使用 Workers 绑定时,请使用评估 API。该 API 接受查询参数或 JSON 请求正文。

发送标量查询上下文

GET 端点接受作为查询参数传入的上下文属性。请将其用于标量上下文值。

Flagship 会将明确的数字和布尔查询值转换为相应类型。例如,42 会变成数字,true 会变成布尔值。其他值会保留为字符串。

看起来像 JSON 的查询值仍为字符串。例如,{"plan":"enterprise"} 不会创建嵌套对象。

发送结构化 JSON 上下文

使用 POST 发送嵌套对象、数组或 null。以下请求使用结构化上下文评估 new-checkout:

Required API token permissions

At least one of the following token permissions is required:
  • Flagship Read
  • Flagship Write
  • Flagship Evaluate
Evaluate flag with JSON contextbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/flagship/apps/$APP_ID/evaluate" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"flagKey": "new-checkout",
		"context": {
				"targetingKey": "user-42",
				"profile": {
						"plan": "enterprise"
				},
				"tags": [
						"beta"
				]
		}
	}'

POST 响应包含与 GET 响应相同的字段:

{
	"flagKey": "new-checkout",
	"value": true,
	"variant": "on",
	"reason": "TARGETING_MATCH"
}

无效上下文会返回 400 响应。详情请参阅限制和评估错误代码。

这篇文档对您有帮助吗?