ドキュメント

はじめに

規約

  • 以下のパスはすべてベース URL からの相対パスです。リクエストとレスポンスは JSON で、POST では Content-Type: application/json を送ってください。
  • ID は UUID です。タイムスタンプは UTC の ISO 8601 です。
  • プレースホルダーはキーで指定します。キーはテンプレートのエンドポイントが各ラベルの横に返す client_name のような snake_case の名前です。テンプレートの初回保存時にラベルから作られ、ラベルの文言を変えても変わりません。作成者はテンプレート内で変更できます。
  • レスポンスには Cache-Control: no-store と緩い CORS ヘッダーが付くため、ブラウザークライアントでも動作しますが、ブラウザーは API トークンを置く場所ではありません。
  • API のバージョンはパスで示します。レスポンスにはバージョンを変えずにフィールドが追加されることがありますが、v1 の中で削除や名前の変更はありません。