リファレンス
AWASUの詳細ドキュメントです。タブで「ユーザーガイド」と「技術仕様（開発者向け）」を切り替えてご覧ください。
1. AWASUの概要
AWASUは、複数人での日程調整をブラウザだけで完結させるWebツールです。
- 会員登録・ログイン不要：主催者も参加者も、アカウント作成なしで即利用できます。
- 30分単位の時間指定：候補日時を30分刻みで細かく設定できます。
- ヒートマップ表示：参加可能人数を色の濃淡でリアルタイムに可視化します。
- マルチデバイス対応：PC・スマートフォン・タブレットに対応しています。
- 完全無料：すべての機能を無料でご利用いただけます。
2. 用語集
| 用語 | 説明 |
|---|---|
| イベント | 日程調整の単位。調整目的1つにつき1つ作成します。 |
| イベント名 | イベントのタイトル。参加者がURLを開いたときに表示されます。必須項目です。 |
| 候補日の期間 | 日程調整の候補として表示する期間。「この日から」「この日まで」を設定します。 |
| 時間帯 | 1日のうち候補として表示する時間の範囲。この範囲内が30分単位のグリッドで表示されます。 |
| イベントURL | イベント作成後に発行される専用ページのURL。このURLを参加者に共有します。 |
| 候補グリッド | 参加者が都合を入力するマス目。横軸が日付、縦軸が時間帯。ドラッグで選択します。 |
| ヒートマップ | 参加者の回答を色の濃淡で可視化した表示。人数が多いほど色が濃くなります。 |
| 主催者 | イベントを作成した人。 |
| 参加者 | 主催者からURLを共有され、都合を入力する人。登録・ログイン不要で参加できます。 |
3. イベントの作成
- トップページからイベント名を入力します（必須）。
- 説明を入力します（任意）。会議の目的・場所・持ち物など補足情報を記入できます。
- 候補日の期間を「この日から」「この日まで」で設定します。1〜2週間程度がおすすめです。
- 時間帯を開始時刻・終了時刻で指定します。ビジネス用途なら9:00〜19:00が目安です。
- 「イベントを作成」ボタンを押すと専用URLが発行されます。
⚠️ イベント作成後はイベント名・期間・時間帯を変更できません。変更が必要な場合は新しいイベントを作成してください。
4. URLの共有
- イベントページ上部の「URLをコピー」ボタンを押すとURLがコピーされます。
- LINEやメール、Slackなどで参加者に送付します。回答期限の一言を添えると回答率が上がります。
例文：
「来月の○○の日程をAWASUで調整します。下記URLから参加可能な日時を選択してください。【回答期限：○月○日まで】（URL）1〜2分で完了します。」
5. 参加者の予定入力
- 共有されたURLをブラウザで開きます。アプリインストール・ログインは不要です。
- 「お名前」欄に名前（ニックネーム可）を入力します。
- 候補グリッドで参加可能な時間帯をドラッグ（スマホはスワイプ）で選択します。
- 「予定を保存」ボタンを押すと送信完了。ヒートマップと参加者一覧に反映されます。
6. ヒートマップの見方
| 色の濃さ | 参加可能な人数が多いほど濃い青色になります。最も濃いマスが最適候補です。 |
| 白（色なし） | その時間帯に参加可能な回答者が0人です。 |
| 数字 | 各マスに表示される数字は参加可能と回答した人数です。 |
7. 参加者一覧
- 回答済みの参加者の名前と選択時間帯数が表示されます。
- 参加者名をタップするとその人の選択時間帯をハイライト表示できます。
- 参加者が回答するたびにヒートマップと一覧がリアルタイムで更新されます。
8. 制限事項・注意点
| イベントの編集 | 作成後のイベント名・期間・時間帯の編集は不可。変更は新規作成で対応してください。 |
| 回答の修正 | 保存した回答を後から修正する機能は現在未対応です。 |
| イベントの削除 | 手動削除機能は現在未対応。一定期間後に自動削除されます。 |
| パスワード保護 | URLへのパスワード設定機能は現在未対応です。 |
| 時間単位 | 最小単位は30分です。15分・10分単位には対応していません。 |
| カレンダー連携 | Googleカレンダー・Outlookとの直接連携機能は現在未対応です。 |
9. 動作環境
| PC | Google Chrome・Firefox・Edge・Safari（各最新版） |
| スマートフォン | iOS 15以降のSafari、Android 10以降のChrome |
| タブレット | iPadOS 15以降のSafari、AndroidタブレットのChrome |
⚠️ Internet Explorerは非対応です。Microsoft Edgeをご利用ください。
📋 目次
1. 技術概要
| ベースURL | https://awasu-time.com/api/v1 |
| プロトコル | HTTPS必須。HTTPへのアクセスはHTTPSへリダイレクトされます。 |
| データ形式 | リクエスト・レスポンスともにJSON。Content-Type: application/json を指定してください。 |
| 文字コード | UTF-8 |
| 認証 | 現バージョンではAPIキー不要（オープンAPI）。将来バージョンで認証機能を追加予定です。 |
| タイムゾーン | すべての日時データはISO 8601形式（例：2026-04-01T09:00:00+09:00）を使用します。 |
2. URLスキーマ
イベントページ URL
# イベントページ（参加者が開くページ）
https://awasu-time.com/event/{event_id}
# 例
https://awasu-time.com/event/xK7mP2qRn
API エンドポイント
https://awasu-time.com/api/v1/events # イベント作成
https://awasu-time.com/api/v1/events/{id} # イベント取得
https://awasu-time.com/api/v1/events/{id}/answers # 回答一覧・送信
3. REST API 一覧
| メソッド | エンドポイント | 説明 |
|---|---|---|
POST | /events | イベントを作成する |
GET | /events/{id} | イベント情報・ヒートマップを取得する |
GET | /events/{id}/answers | 回答一覧を取得する |
POST | /events/{id}/answers | 回答を送信する |
📌 APIは現在ベータ提供中です。仕様は予告なく変更される場合があります。本番環境への組み込みの際はお問い合わせください。
4. イベント作成 API
POST /api/v1/events
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
title | string | 必須 | イベント名。最大100文字。 |
description | string | 任意 | 説明。最大500文字。 |
date_from | string | 必須 | 候補日開始日。YYYY-MM-DD |
date_to | string | 必須 | 候補日終了日。最大31日間。 |
time_from | string | 必須 | 時間帯開始。HH:MM（30分刻み） |
time_to | string | 必須 | 時間帯終了。HH:MM（30分刻み） |
リクエスト例
POST /api/v1/events
Content-Type: application/json
{
"title": "4月キックオフミーティング",
"date_from": "2026-04-07",
"date_to": "2026-04-18",
"time_from": "09:00",
"time_to": "19:00"
}
レスポンス例（201 Created）
{
"id": "xK7mP2qRn",
"title": "4月キックオフミーティング",
"url": "https://awasu-time.com/event/xK7mP2qRn",
"created_at": "2026-03-24T10:00:00+09:00"
}
5. イベント取得 API
GET /api/v1/events/{id}
{
"id": "xK7mP2qRn",
"title": "4月キックオフミーティング",
"answer_count": 5,
"heatmap": {
"2026-04-09T14:00:00+09:00": 5,
"2026-04-08T10:00:00+09:00": 4
// 0人の時間帯はキーが省略されます
},
"created_at": "2026-03-24T10:00:00+09:00"
}
6. 回答送信 API
POST /api/v1/events/{id}/answers
リクエスト例
POST /api/v1/events/xK7mP2qRn/answers
Content-Type: application/json
{
"name": "山田 太郎",
"slots": [
"2026-04-09T14:00:00+09:00",
"2026-04-09T14:30:00+09:00"
]
}
💡
slots に渡せるのは、イベントの候補期間・時間帯の範囲内の日時のみです。範囲外の値を渡すと400エラーが返ります。
7. エラーレスポンス
{
"error": {
"code": "VALIDATION_ERROR",
"message": "date_to must be after date_from"
}
}
| ステータス | コード | 説明 |
|---|---|---|
| 400 | VALIDATION_ERROR | パラメータの形式が不正です。 |
| 404 | EVENT_NOT_FOUND | 指定したIDのイベントが存在しないか有効期限切れです。 |
| 400 | SLOT_OUT_OF_RANGE | slotsに指定した日時がイベントの範囲外です。 |
| 429 | RATE_LIMIT_EXCEEDED | レート制限に達しました。しばらく待ってから再試行してください。 |
8. レート制限
| イベント作成 | 同一IPアドレスから1時間あたり20件まで |
| 回答送信 | 同一イベントへ同一IPから1時間あたり10件まで |
| 取得系（GET） | 同一IPから1分あたり60リクエストまで |
9. データモデル
Event オブジェクト
| フィールド | 型 | 説明 |
|---|---|---|
id | string | イベントID（9文字のBase62文字列） |
title | string | イベント名 |
description | string|null | イベントの説明 |
date_from | string | 候補日開始日（YYYY-MM-DD） |
date_to | string | 候補日終了日（YYYY-MM-DD） |
time_from | string | 時間帯開始（HH:MM） |
time_to | string | 時間帯終了（HH:MM） |
url | string | イベントページのURL |
answer_count | integer | 現在の回答者数 |
heatmap | object | 時間帯ごとの参加可能人数マップ |
created_at | string | イベント作成日時（ISO 8601） |
10. 埋め込み（iFrame）
AWASUのイベントページは、iFrameを使って外部サイトや社内ツールに埋め込むことができます。
<!-- AWASU イベントページの埋め込み -->
<iframe
src="https://awasu-time.com/event/xK7mP2qRn"
width="100%"
height="700"
frameborder="0"
allow="clipboard-write"
></iframe>
| 推奨幅 | 320px 以上。レスポンシブ対応のため width="100%" を推奨します。 |
| 推奨高さ | 候補日数・時間帯数によって変動します。最低600px、余裕をもって800px程度を目安にしてください。 |
| allow属性 | clipboard-write を指定すると「URLをコピー」ボタンが正常に動作します。 |