用語集
配送APIの用語
API、コンソール、ドライバーアプリで使う用語を一文ずつ、関連ページへのリンク付きで。
- MCPサーバー参照 →
- rentadriver-mcp。APIの全機能をエージェントが呼べるツールとして公開するModel Context Protocolサーバー。
- OTP受け渡し参照 →
- 配送メタデータに入れるワンタイムコード。受取人がドライバーに伝えないと案件は完了できません。
- quote_id参照 →
- 見積もりの識別子。create_deliveryに渡すと、その料金のまま予約できます。
- Turnstile参照 →
- ブラウザからの登録に任意で行う人間確認。エージェント、MCPサーバー、curlは対象外。
- Webhook署名参照 →
- 各WebhookのHMACヘッダー。イベントがRentADriverからのものか検証できます。コンソールからテスト送信可。
- アドレス帳参照 →
- 連絡先付きで保存した集荷・配達先。コンソールとAPIから利用可。
- ウォレット参照 →
- 配送の資金となるプリペイド残高。カードまたはUSDCでチャージし、コンソールで全履歴を確認。
- オファー参照 →
- RentADriver Goでドライバーに提示される案件。ワンタップまたはルールに基づく自動受諾。
- サージ参照 →
- 近隣の供給を需要が上回るときに適用されるライブ係数。見積もりの内訳に常に表示。
- サービスエリア参照 →
- 中心、半径、独自の料金表を持つローンチ都市。全エリア外の見積もりはcheck_coverageが拒否します。
- サイズクラス参照 →
- S(封筒・袋)、M(靴箱〜リュック)、L(スーツケース)、XL(バン必要)。料金を調整し、オファーを受けるドライバーを絞ります。
- サンドボックスキー参照 →
- 料金ページまたはコンソールで発行できるテストキー。費用ゼロで全フローを試せます。
- ストップ参照 →
- 連絡先付きの集荷または配達先住所。地域配送は最大8か所、都市間は最大3か所。
- テストモード参照 →
- テストキーはis_test配送を作成し、シミュレートされたドライバーで、ウォレットは動きません。コンソールではサンドボックスバナー付きで表示。
- マイルストーン参照 →
- 集荷時の積み込みなど、配送で記録されるステップ。以降にキャンセルできる範囲が変わります。
- 確認参照 →
- 証明を承認して資金を確定する操作。呼ばなければ配達から24時間後に自動確認されます。
- 帰路手当参照 →
- 都市間配送の料金のうち、ドライバーが空車で戻る帰路をまかなう部分。片道の距離と運転時間の半分です。
- 緊急度参照 →
- asap、today、scheduledのいずれか。配車の時間枠と料金係数の一つを決めます。
- 見積もり参照 →
- POST /v1/quotesが返す、料金とルートの決まった配送のオファー。内訳とETA付き、無料、キー不要、15分間有効。
- 自動受諾参照 →
- ドライバーが設定するルール(距離、サイズ、時間帯、エリア)。条件に合うオファーを数秒で自動受諾します。
- 受取人評価参照 →
- 受け渡し後に受取人が追跡ページで付ける1〜5の評価。ドライバーは平均を確認できます。
- 申告価額参照 →
- 品物に設定するvalue_cents。配送記録に保存され、紛失や破損の申し立ての審査に使われます。
- 追跡リンク参照 →
- 配送ごとの公開ページ。ライブステータス、ドライバー位置、ETAを表示し、ロゴと色を設定できます。
- 定期配送参照 →
- 指定した曜日と時刻に自動予約されるテンプレート。コンソールと定期ワーカーが管理。
- 都市間配送参照 →
- ローンチ都市から道路距離160 km以内の近隣ローンチ都市へ、専属ドライバー1人が当日中に届ける配送。
- 当日締め切り参照 →
- 都市間配送は現地時間21:00までに到着する必要があります。それに間に合わない時間の予約は、翌朝の集荷になります。
- 配車ウェーブ参照 →
- 集荷地点付近のシフト中ドライバーへ送るオファーの1ラウンド。受諾されるまで半径がウェーブごとに広がります。
- 配送参照 →
- 集荷から1つ以上の配達先までの予約済み案件。ステータス履歴、証明、追跡リンク付き。
- 配達証明参照 →
- 受け渡し時に取得する位置情報付き写真、署名、またはワンタイムコード。get_proof_of_deliveryで取得。
- 保留と確定参照 →
- 予約時に全額をプリペイドウォレットで保留し、配送確認時に確定。キャンセルすると保留は解放されます。