パブリックAPI の使い方（書き込み）

更新日2026年8月21日

このページでは、パブリックAPI を使ってアイテムを作成（POST）する方法を説明します。

事前準備：パブリックAPI を有効にする

パブリックAPI でモデルのデータを投稿できるようにするには、パブリックAPI ページの 書き込み タブでそのモデルを有効にする必要があります。

プロジェクトの パブリックAPI を開きます
書き込み タブを選択します
許可済みオリジンを少なくとも1つ追加します。ブラウザからのリクエストは、指定されたオリジンからのみ受け入れられます
対象モデルの「有効」トグルをオンにします
変更を保存 ボタンをクリックします

画面の Copy ボタンを押すと、curl リクエストをコピーできます。

アイテムを作成する（POST）

POST /{model}/items エンドポイントに JSON でフィールドを指定すると、新しいアイテムを作成できます。認証は不要です。<workspace_id_or_alias> などの山括弧の部分は、実際の値に置き換えてください。fields のキーと値は、対象モデルのフィールド定義に応じて変わります。以下はサンプルです。

curl -X POST 'https://api.cms.reearth.io/api/p/<workspace_id_or_alias>/<project_id_or_alias>/<model_id_or_key>/items' \
  -H 'Content-Type: application/json' \
  -d '{
  "fields": {
    "<field-key-1>": "<value-1>",
    "<field-key-2>": "<value-2>"
  }
}'

$WORKSPACE_ID = "<workspace_id_or_alias>"
$PROJECT_ID = "<project_id_or_alias>"
$MODEL_ID = "<model_id_or_key>"

$uri = "https://api.cms.reearth.io/api/p/$WORKSPACE_ID/$PROJECT_ID/$MODEL_ID/items"
$body = @{
  fields = @{
    "<field-key-1>" = "<value-1>"
    "<field-key-2>" = "<value-2>"
  }
} | ConvertTo-Json

$resp = Invoke-RestMethod -Method Post -Uri $uri -ContentType "application/json" -Body $body
$resp

const WORKSPACE_ID = "<workspace_id_or_alias>";
const PROJECT_ID = "<project_id_or_alias>";
const MODEL_ID = "<model_id_or_key>";

const url = `https://api.cms.reearth.io/api/p/${WORKSPACE_ID}/${PROJECT_ID}/${MODEL_ID}/items`;

const body = {
  fields: {
    "<field-key-1>": "<value-1>",
    "<field-key-2>": "<value-2>",
  },
};

const resp = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify(body),
});

if (!resp.ok) {
  const text = await resp.text();
  throw new Error(`HTTP ${resp.status}: ${text}`);
}

const data = await resp.json();
console.log(data);