開発者向け

Maanaは、京都で開催するワークショップの今後の日程を確認できる、読み取り専用の公開APIを1つ提供しています。AIエージェントなどの連携サービスは、このAPIで日程、お一人様あたりの料金、残席数を調べ、maana.jpで予約するためのリンクをご本人に案内できます。
利用条件
認証は不要です。APIキー、アカウント、事前登録はなく、無料でご利用いただけます。APIは読み取り専用のため、リクエストによって予約、仮押さえ、支払いが行われることはなく、サンドボックス環境もありません。レスポンスはどのウェブサイトからでも読み込めます。
クイックスタート
すべてのワークショップの今後の日程をJSONで取得します。
curl https://www.maana.jp/api/workshops/sessions
ご本人に読みやすい一覧を見せたい場合などは、Markdownで取得できます。
curl -H 'Accept: text/markdown' https://www.maana.jp/api/workshops/sessions
1つのワークショップに絞り、リンク先を日本語ページにします。
curl 'https://www.maana.jp/api/workshops/sessions?workshop=tea-ceremony&lang=ja'
パラメーター
GET /api/workshops/sessions では、次のクエリパラメーターを指定できます。いずれも省略可能です。
  • workshop：ワークショップを1つ指定します。値は indigo, tea-dye, earthen-wall, kyoto-botanical-teas, fermentation, tea-ceremony, tea-ceremony-night のいずれかです。省略するとすべてのワークショップを返します。
  • from：期間の開始日（日本時間、YYYY-MM-DD形式）。省略すると今日になります。過去の日付を指定した場合も今日から始まります。
  • to：期間の終了日（日本時間、YYYY-MM-DD形式）。省略すると from の60日後になります。期間は最長92日です。
  • lang：予約ページとワークショップページのリンクの言語。en（既定）または ja です。
  • format：json、md、markdown のいずれか。Acceptヘッダーより優先されます。
レスポンス
JSONレスポンスには、生成日時 generatedAt、期間 from と to、タイムゾーン timezone、通貨 currency、予約方法の説明 booking、カレンダーのURL calendarUrl、開始日時の順に並んだ sessions が含まれます。unavailableWorkshops には、現在日程を読み込めなかったワークショップが入ります。それ以外のワークショップの日程はすべて含まれています。
各回には次の項目があります。
  • id：各回を識別する固定のID。
  • workshop：ワークショップの slug、英語名 name、ワークショップページの url。
  • start と end：日本時間のオフセット付きのISO 8601形式の日時（例：2026-11-08T10:00:00+09:00）。
  • durationMinutes：所要時間（分）。
  • priceJpy：お一人様あたりの料金（日本円）。料金が予約ページにのみ表示される場合は null です。
  • seatsRemaining と capacity：残席数と定員。
  • available：満席の場合は false です。満席の回も一覧に含まれます。
  • location：会場。addressSentAfterBooking が true の場合、正確な住所はご予約後にメールでお知らせします。
  • bookingUrl：maana.jpでこの回の予約フォームを開くリンク。
エラー
エラーの場合は、固定のエラーコード error、説明 message、リクエストの直し方 hint、このページへのリンク docs を含むJSONを返します。パラメーターが正しくない場合は400、/api 以下の存在しないパスには404を返します。502は予約カレンダーが応答しなかったことを示すため、少し時間をおいてから再度お試しください。例：
{
  "error": "invalid_from",
  "message": "Expected from=YYYY-MM-DD",
  "hint": "Send from as a calendar date in Asia/Tokyo formatted YYYY-MM-DD, for example 2026-11-01. Omit it to start today.",
  "docs": "https://www.maana.jp/developers"
}
エラーコード：invalid_workshop, invalid_from, invalid_to, invalid_range, upstream_unavailable, not_found
予約について
このAPIで予約や支払いはできません。予約するには、ご本人が選んだ回の bookingUrl を案内してください。maana.jpの予約フォームが開き、ご本人が情報とお支払いを入力して、ワークショップの免責事項に同意します。ご本人に代わって支払いを完了しないでください。
残席は予約に応じて変わるため、おすすめする前にもう一度APIで確認してください。APIに含まれない料金や空き状況は伝えないでください。
リファレンス
  • OpenAPI 3.1 定義：エンドポイント、パラメーター、レスポンスの機械可読な定義。
  • llms.txt：AIエージェント向けのサイト全体のガイド。
お問い合わせ

APIやワークショップのご予約についてのご質問：atelier@maana.jp