名刺交換の状態

GET/card-exchanges/:exchangeId

当事者から見た交換の状態を返します。申し込んだ側は相手の承認を待つ間これをポーリングし、status が ACCEPTED になったら result を使って次へ進みます。result.candidateEvents が 1 件以上なら会ったイベントを選ぶ画面を表示し、PATCH /meet-logs/:meetLogId で eventId を記録してください（1 件のときは result.eventId に自動で入っているので、選んだ状態で表示し、外されたら eventId: null を送ります）。

認証	要ログイン

パスパラメータ

exchangeIdstring必須

交換 ID。

補足

見送られた・取り消された・別の交換に置き換えられた交換は削除されるため 404（errorCode 40203）になります。当事者以外も 404 です。

レスポンス

CardExchange を返します。

リクエスト

curl https://api.4s.link/card-exchanges/EXCHANGE_ID \
  -H "Authorization: Bearer 4s_at_..."

レスポンス例

{
  "id": "6f1c2d3e-...",
  "status": "ACCEPTED",
  "role": "REQUESTER",
  "counterpart": {
    "id": "u-taro",
    "slug": "taro",
    "firstName": "Taro",
    "lastName": "Yamada",
    "nativeName": "山田 太郎",
    "avatarUrl": "https://...",
    "title": "代表取締役",
    "bio": "企業の新規事業を支えるサービスを開発しています。",
    "cardDesign": "gradient-01-cobalt-mint",
    "cardPhoto": null,
    "organization": {
      "id": "org-1",
      "name": "株式会社HORIZON",
      "slug": "horizon",
      "logoUrl": null,
      "title": "ビジネス開発チーム"
    }
  },
  "counterpartCommunity": null,
  "myCommunity": null,
  "expiresAt": "2026-07-10T06:33:00.000Z",
  "createdAt": "2026-07-10T06:29:40.000Z",
  "requestedAt": "2026-07-10T06:30:00.000Z",
  "respondedAt": "2026-07-10T06:30:12.000Z",
  "myShareEmail": true,
  "mySubscribeNewsletter": null,
  "result": {
    "exchangedAt": "2026-07-10T06:30:12.000Z",
    "meetLogId": "ml-1",
    "eventId": null,
    "candidateEvents": [
      { "id": "ev-1", "slug": "ivs-2026", "title": "IVS 2026", "languages": null, "startTime": "2026-07-08T10:00:00.000Z", "endTime": "2026-07-10T18:00:00.000Z", "timezone": "Asia/Tokyo", "thumbnailUrl": null, "mainImageUrl": null },
      { "id": "ev-2", "slug": "ivs-side-a", "title": "サイドイベントA", "languages": null, "startTime": "2026-07-10T15:00:00.000Z", "endTime": "2026-07-10T20:00:00.000Z", "timezone": "Asia/Tokyo", "thumbnailUrl": null, "mainImageUrl": null }
    ]
  }
}