Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

API request

最終更新 Markdown で表示Agent セットアップ

The APIRequest component is used 671 times on 267 pages.

See all examples of pages that use APIRequest

Used 671 times.

Pages

Partials

インポート

import { APIRequest } from "~/components";

使い方

import { APIRequest } from "~/components";

<APIRequest
	path="/zones/{zone_id}/api_gateway/settings/schema_validation"
	method="PUT"
	json={{
		validation_default_mitigation_action: "block",
	}}
	code={{
		mark: [5, "block"],
	}}
	roles="Domain"
/>

<APIRequest
	path="/zones/{zone_id}/hostnames/settings/{setting_id}/{hostname}"
	method="DELETE"
	parameters={{
		setting_id: "ciphers",
	}}
/>

<APIRequest
	path="/accounts/{account_id}/images/v2/direct_upload"
	method="POST"
	form={{
		requireSignedURLs: true,
		metadata: '{"key":"value"}',
	}}
/>

<APIRequest
	path="/zones/{zone_id}/cloud_connector/rules"
	method="PUT"
	json={[
		{
			expression: 'http.request.uri.path wildcard "/images/*"',
			provider: "cloudflare_r2",
			description: "Connect to R2 bucket containing images",
			parameters: {
				host: "mybucketcustomdomain.example.com",
			},
		},
	]}
/>

<APIRequest
	path="/zones/{zone_id}/page_shield/scripts"
	method="GET"
	parameters={{
		direction: "asc",
	}}
/>

<APIRequest> Props

path

required

type: string

API エンドポイントのパスです。

API ドキュメント の、各エンドポイント名の下にあります。

method

required

type: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD"

使う HTTP メソッドです。

parameters

type: Record<string, any>

置き換えるパラメーターです。URL パスまたはクエリパラメーターとして使います。

たとえば /zones/{zone_id}/page_shield/scripts は、次のようにすると /zones/123/page_shield/scripts?direction=asc になります。

parameters={{
	zone_id: "123",
	direction: "asc"
}}

指定しない場合、コンポーネントは環境変数にフォールバックします。たとえば {setting_id}$SETTING_ID に置き換わります。

json

type: Record<string, any> | Record<string, any>[]

送信する JSON ペイロードです。

必須プロパティが欠けていると、コンポーネントはエラーを投げます。

機能上、cURL の --json オプション--data と同等ですが、いくつかのヘッダーを自動で扱います。

form

type: Record<string, any>

送信する FormData ペイロードです。

このフィールドは、現時点ではスキーマに対して検証しません。

code

type: object

Astro の Code props のオブジェクトです。使える props は Astro の Code コンポーネントドキュメント を参照してください。

roles

type: string | boolean

default: true

true(デフォルト)の場合、すべての API トークンロールを表示します。

false の場合、API トークンロールは表示しません。

文字列の場合、その部分文字列で API トークンロールを絞り込みます(例: roles="domain" だと Account API Gateway を除き、Domain API Gateway だけ残します)。

役に立ちましたか?