開発者プラットフォーム

CouthActs で
開発しよう。

AI アシスタント向けのエージェント API と MCP サーバー、配車・テレマティクスシステム向けのプロバイダー API、署名付き管理記録を検証する公開エンドポイント。Bearer キーを使った HTTPS 上のシンプルな JSON です。

API キーを取得お問い合わせ

キーと上限

キーを選ぶ。

エージェントキー

プラン料金なし

お客様のアカウントに代わって操作する AI エージェントやアシスタント向け。

権限は自分で選択：見積もり、案件、予約、ウォレット、トラスト
案件ごと・月ごとの支出上限と承認しきい値
キーごとに毎分最大 120 リクエスト
「設定 → AI エージェント」で作成、または OAuth でアシスタントを接続

エージェントキーを作成

プロバイダー API

Basic プラン

自社の配車・テレマティクスシステムを接続するプロバイダー向け。

Basic：月 500 回まで。超えると呼び出しは拒否されます
公開中の案件、自分の予約、ウォレット、位置情報の更新
Professional（月 5,000 回）と Enterprise：近日提供
「設定 → プロバイダー API キー」でキーを作成

プロバイダーキーを管理

カスタマー API

個別契約

お客様自身の案件、入札、ウォレット用の REST エンドポイント。

Starter：月 1,000 回まで。超えると呼び出しは拒否されます
Growth：月 5,000 回まで。超過分は 1 回 US$0.20 で、翌月ウォレットから引き落とし
Enterprise：上限は個別に合意
キーはまだセルフサービスではありません。ほとんどのお客様にはエージェントキーをおすすめします

お問い合わせ

プロバイダー API の有料プラン（Professional と Enterprise）は近日提供予定です。今すぐ上限を引き上げたい場合はお問い合わせください。現在のプランと利用状況は「設定」に表示されます。API にはサービスレベルの保証はありません。

クイックスタート

最初の呼び出しまで 3 ステップ。

ステップ 01

キーを取得する

お客様と AI エージェント：設定 → AI エージェント。プロバイダー：設定 → プロバイダー API キー。キー全体は作成時に一度だけ表示されます。

ステップ 02

最初のリクエストを送る

キーを Authorization: Bearer で送信します。プロバイダーは GET /api/provider/v1/jobs から始められます。

ステップ 03

エージェントツールを確認する

エージェントキー：/api/agent/openapi.json の OpenAPI 記述を参照するか、MCP クライアントを /api/mcp に接続します。

リクエスト例

curl -X GET https://couthacts.com/api/provider/v1/jobs \
  -H "Authorization: Bearer ca_provider_your_key_here" \
  -H "Content-Type: application/json"

# Response
{
  "success": true,
  "data": [
    {
      "id": "clx...",
      "mode": "FREIGHT_TRUCKING",
      "title": "Freight: Dallas, TX → Houston, TX",
      "status": "OPEN",
      "originAddress": "Dallas, TX",
      "destinationAddress": "Houston, TX",
      "pickupDate": "2026-11-05T08:00:00.000Z",
      "budgetUsd": "2500",
      "insuranceTier": "NONE",
      "_count": { "bids": 3 }
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "pages": 1, "requestId": "…", "timestamp": "…" }
}

エンドポイント

完全リファレンス。

API、エージェント、MCP のレスポンスに含まれる金額はすべて米ドル建てです（Usd で終わるフィールド）。CouthActs の請求と支払いは米ドルのみです。現地通貨の目安を表示するには、画面ごとに GET /api/currency/display を 1 回呼び出し、local ≈ amountUsd × rate で計算してください。米ドルの金額を先に、現地通貨は概算として表示します。

エージェント API と MCP

GET/api/agent/v1/tools
エージェントキーで実行できるアクションを、入力スキーマとともに一覧表示します。
エージェントキー
POST/api/agent/v1/tools/{name}
キーの権限、支出上限、承認ルールの範囲内でアクション（get_quote や post_job など）を実行します。
エージェントキー
GET/api/agent/openapi.json
エージェントツールの OpenAPI 3.1 記述。
なし
POST/api/mcp
同じアクションを Model Context Protocol で。Claude、ChatGPT などの MCP 対応アシスタント向け。
エージェントキー / OAuth

プロバイダー API

GET/api/provider/v1/jobs
登録済みの輸送モードの公開中案件（モードで絞り込み可、ページ分割）。
プロバイダー API キー
GET/api/provider/v1/bookings
自分の予約のステータス、追跡コード、支払い保留の状態。
プロバイダー API キー
POST/api/provider/v1/tracking
進行中の予約の位置を報告します。お客様に表示され、管理記録に記録されます。
プロバイダー API キー
GET/api/provider/v1/wallet
ウォレット残高と最近の取引。
プロバイダー API キー

カスタマー API

GET · POST/api/v1/jobs
自分の案件を一覧表示、または案件を投稿（手数料を引き落とし、予算をウォレットで保留）。
カスタマー API キー
GET · PATCH/api/v1/jobs/{id}
案件を 1 件取得、予算や説明を更新、またはキャンセル。
カスタマー API キー
GET · POST/api/v1/bids
自分の案件への入札を一覧表示、または入札を承諾・拒否。
カスタマー API キー
GET/api/v1/wallet
ウォレット残高。
カスタマー API キー

公開（キー不要）

GET/api/track/{code}
追跡コードで予約のステータス、ルート、追跡イベントを取得。金銭情報は含みません。
なし
GET/api/custody/public/{trackingCode}
予約の管理記録が改ざんされていないことの公開証明（イベント種別、時刻、ハッシュ、署名）。
なし
GET/api/credentials/provider/{id}
プロバイダーの署名付き資格情報（確認状況と実績）。
なし
GET/.well-known/couthacts-keys.json
署名を確認するための CouthActs の Ed25519 公開鍵。
なし
POST/api/trust/verify
管理記録証明書またはプロバイダー資格情報を検証します。
なし
GET/api/currency/display
ユーザーの表示通貨と対米ドルレート（リアルタイムのレートがない場合 rate は null：米ドルのみ表示）。
なし
GET/api/currency/supported
選択肢用の表示通貨一覧：コード、名称、記号、小数桁数。
なし

プロバイダーの追跡

自社システムから位置を報告。

確定済みまたは進行中の予約の位置を送信します。お客様にリアルタイムで表示され、署名付き管理記録にチェックポイントとして記録されます。各データの取得元はレイヤー名でタグ付けできます。CouthActs はタグを記録しますが、AIS、フライト、ELD、センサー、衛星のデータに自ら接続したり検証したりはしません。データは報告された内容そのものです。

使用できるレイヤータグ

MOBILE_GPS

モバイル GPS

スマートフォンまたは車載 GPS の位置（初期値）。

AIS_MARITIME

AIS（海上）

お使いの AIS データ源からの船舶の位置。

FLIGHT_TRACKING

フライト追跡

お使いのフライト追跡データ源からの航空機の位置。

ELD_INTEGRATION

ELD

電子運行記録装置からのトラックの位置。

QR_PIN_CONFIRMATION

PIN による引き渡し

引き渡し時の位置。配達 PIN 自体はアプリで入力します。

IOT_DEVICE

IoT デバイス

お使いのトラッカーからの位置。センサーの測定値は保存されません。

SATELLITE

衛星

衛星トラッカーからの位置。

DOCUMENT_POD_AI

配達証明

位置のタグのみ。CouthActs は書類を解析しません。

BIOMETRIC

生体認証

位置のタグのみ。CouthActs は引き渡し時に生体認証を行いません。

位置を報告する

POST /api/provider/v1/tracking
Authorization: Bearer ca_provider_your_key_here
Content-Type: application/json

{
  "bookingId": "clx...",
  "lat": 32.7767,
  "lng": -96.7970,
  "layer": "MOBILE_GPS",
  "status": "IN_TRANSIT",
  "note": "Departed Dallas warehouse"
}

認証とセキュリティ

アクセスの管理方法。

Bearer キー

すべてのリクエストに Authorization: Bearer が必要です。キーは「設定」で作成し、一度だけ表示され、いつでも無効化できます。

HTTPS のみ

キーは HTTPS でのみ送信してください。公開コードやクライアント側のアプリに埋め込まないでください。

上限

エージェントキー：毎分 120 リクエスト。プロバイダー API キーとカスタマー API キー：プランの月間呼び出し回数で、X-RateLimit-Limit と X-RateLimit-Remaining ヘッダーで通知されます。

アクティビティログ

エージェントのアクションはすべて、ツール、ステータス、金額、入力、結果とともに記録され、「設定」に表示されます。プロバイダーキーはリクエスト数と最終利用日時を表示します。

支出上限と承認

エージェントキーは案件ごと・月ごとの上限を超えられず、承認しきい値を超えるアクションはアカウント所有者の承認を待ちます（リクエストは 72 時間で失効）。

署名するのは記録であり、リクエストではありません

管理記録とプロバイダー資格情報は CouthActs の Ed25519 キーで署名されているため、誰でも検証できます。API のリクエストとレスポンスには署名はなく、CouthActs はアウトバウンド Webhook を送信しません。

レスポンス形式

一貫性があり、予測可能。

プロバイダー API とカスタマー API のレスポンスは以下の形式です。エージェント API のレスポンスには代わりに status、actionId、result フィールドがあります。OpenAPI 記述をご覧ください。

成功（2xx）

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

エラー（4xx/5xx）

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "bookingId, lat, lng required"
  },
  "meta": {
    "requestId": "req_...",
    "timestamp": "2026-04-01T..."
  }
}

開発者歓迎

さあ、連携しましょう。

「設定」でキーを作成すれば、数分で最初の呼び出しができます。上限の引き上げや Enterprise プランについてはお問い合わせください。

API キーを取得お問い合わせ

CouthActs で開発しよう。

キーを選ぶ。

エージェントキー

プロバイダー API

カスタマー API

最初の呼び出しまで 3 ステップ。

キーを取得する

最初のリクエストを送る

エージェントツールを確認する

完全リファレンス。

エージェント API と MCP

プロバイダー API

カスタマー API

公開（キー不要）

自社システムから位置を報告。

使用できるレイヤータグ

モバイル GPS

AIS（海上）

フライト追跡

ELD

PIN による引き渡し

IoT デバイス

衛星

配達証明

生体認証

アクセスの管理方法。

Bearer キー

HTTPS のみ

上限

アクティビティログ

支出上限と承認

署名するのは記録であり、リクエストではありません

一貫性があり、予測可能。

さあ、 連携しましょう。

CouthActs で
開発しよう。

さあ、連携しましょう。