无法使用 Workers 绑定时,请使用评估 API。该 API 接受查询参数或 JSON 请求正文。
GET 端点接受作为查询参数传入的上下文属性。请将其用于标量上下文值。
Flagship 会将明确的数字和布尔查询值转换为相应类型。例如,42 会变成数字,true 会变成布尔值。其他值会保留为字符串。
看起来像 JSON 的查询值仍为字符串。例如,{"plan":"enterprise"} 不会创建嵌套对象。
使用 POST 发送嵌套对象、数组或 null。以下请求使用结构化上下文评估 new-checkout:
Required API token permissions
At least one of the following token permissions is required:Flagship ReadFlagship WriteFlagship Evaluate
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"
}