Nitte 人材紹介 API
  1. 日程調整
Nitte 人材紹介 API
  • API
    • 認証
    • エラー
    • 企業担当者
      • 作成
      • 取得
      • 一覧
      • 更新
      • 削除
    • 求職者
      • 作成
      • 取得
      • 一覧
      • 更新
      • 削除
    • 日程調整
      • 作成
        POST
      • 取得
        GET
      • 一覧
        GET
      • 更新
        PATCH
      • 削除
        DELETE
  • Webhook
    • Webhook
  1. 日程調整

更新

PATCH
/mediatories/{teamId}/bookings/{id}
日程調整を更新します。
調整に不整合が生じないようにするために、更新できるプロパティは一部のプロパティに制限されています。

Requestパラメータ

Authorization
Headerにパラメータ
Authorization
を追加し、その値にはBearerの後にTokenを連結します
例：
Authorization: Bearer ********************
Pathパラメータ
teamId
string 
必須
id
string 
必須
Request Bodyパラメータapplication/json
name
string 
可選
名前
deadline
string <date-time>
可選
期日。ISO8601
place
string 
可選
場所
metadata
object 
可選
任意のJSON形式のメタデータ
例
{
  "name": "string",
  "deadline": "2019-08-24T14:15:22Z",
  "place": "string",
  "metadata": {}
}

サンプルコード

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.nitte.app/mediatories//bookings/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "deadline": "2019-08-24T14:15:22Z",
    "place": "string",
    "metadata": {}
}'

Response

🟢200成功
application/json
Body
name
string 
必須
名前
lengthMin
number 
必須
所要時間
client
object (企業担当者) 
必須
企業担当者のID
id
string 
必須
ID
サンプル値:
c1be87a5-d8ff-4338-a60a-ad8792b99ee6
email
string 
必須
メールアドレス
サンプル値:
nitte@exmaple.com
publicName
string 
必須
公開名
サンプル値:
Nitte株式会社
privateName
string 
必須
管理名
サンプル値:
client-12345
tel
string  | null 
必須
電話番号
サンプル値:
08012341234
lineUserId
string  | null 
必須
LINE UserID
blockedPeriods
array[object (時間帯) {2}] 
必須
調整不可の時間帯
preProposedPeriods
array[object (時間帯) {2}] 
必須
登録された候補日時
candidate
object (求職者) 
必須
求職者のID
id
string 
必須
ID
サンプル値:
c1be87a5-d8ff-4338-a60a-ad8792b99ee6
email
string 
必須
メールアドレス
サンプル値:
nitte@exmaple.com
publicName
string 
必須
公開名
サンプル値:
Nitte株式会社
privateName
string 
必須
管理名
サンプル値:
client-12345
tel
string  | null 
必須
電話番号
サンプル値:
08012341234
lineUserId
string  | null 
必須
LINE UserID
blockedPeriods
array[object (時間帯) {2}] 
必須
調整不可の時間帯
preProposedPeriods
array[object (時間帯) {2}] 
必須
登録された候補日時
proposablePeriods
array[object (時間帯) {2}] 
可選
候補日時として選択できる時間帯。proposedPeriodsとの併用は不可。
start
string <date-time>
必須
開始時刻(ISO8601)
end
string <date-time>
必須
終了時刻(ISO8601)
proposableWeeklyAvailableTimes
必須
Any of
mon
object (曜日毎の調整可能時刻) 
必須
tue
object (曜日毎の調整可能時刻) 
必須
wed
object (曜日毎の調整可能時刻) 
必須
thu
object (曜日毎の調整可能時刻) 
必須
fri
object (曜日毎の調整可能時刻) 
必須
sat
object (曜日毎の調整可能時刻) 
必須
sun
object (曜日毎の調整可能時刻) 
必須
hol
object (曜日毎の調整可能時刻) 
必須
place
string  | null 
必須
場所
placeInfo
enum<string> 
可選
場所の事前情報(online/offline)
列挙型:
offlineonline
information
string  | null 
必須
連絡事項
deadline
string <date-time>
可選
期日。ISO8601
cc
array[string]
必須
cc通知対象ユーザーのメールアドレス
status
enum<string> 
必須
調整ステータス
列挙型:
startedproposedselectedconfirmedcanceled
proposedPeriods
array[object (時間帯) {2}]  | null 
必須
候補日時
start
string <date-time>
必須
開始時刻(ISO8601)
end
string <date-time>
必須
終了時刻(ISO8601)
selectedPeriod
必須
希望日時
Any of
時間帯
start
string <date-time>
必須
開始時刻(ISO8601)
end
string <date-time>
必須
終了時刻(ISO8601)
approvedPeriod
必須
確定した日時
Any of
時間帯
start
string <date-time>
必須
開始時刻(ISO8601)
end
string <date-time>
必須
終了時刻(ISO8601)
links
object 
必須
URL
candidateBookingUrl
string 
必須
求職者用の調整URL
clientBookingUrl
string 
必須
企業担当者用の調整URL
detailUrl
string 
必須
管理者向けの進捗確認用のURL
createdAt
string <date-time>
必須
作成日時
metadata
object 
可選
メタデータ
例
{
  "name": "string",
  "lengthMin": 0,
  "client": {
    "id": "c1be87a5-d8ff-4338-a60a-ad8792b99ee6",
    "email": "nitte@exmaple.com",
    "publicName": "Nitte株式会社",
    "privateName": "client-12345",
    "tel": "08012341234",
    "lineUserId": "string",
    "blockedPeriods": [
      {
        "start": "2019-08-24T14:15:22Z",
        "end": "2019-08-24T14:15:22Z"
      }
    ],
    "preProposedPeriods": [
      {
        "start": "2019-08-24T14:15:22Z",
        "end": "2019-08-24T14:15:22Z"
      }
    ]
  },
  "candidate": {
    "id": "c1be87a5-d8ff-4338-a60a-ad8792b99ee6",
    "email": "nitte@exmaple.com",
    "publicName": "Nitte株式会社",
    "privateName": "client-12345",
    "tel": "08012341234",
    "lineUserId": "string",
    "blockedPeriods": [
      {
        "start": "2019-08-24T14:15:22Z",
        "end": "2019-08-24T14:15:22Z"
      }
    ],
    "preProposedPeriods": [
      {
        "start": "2019-08-24T14:15:22Z",
        "end": "2019-08-24T14:15:22Z"
      }
    ]
  },
  "proposablePeriods": [
    {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z"
    }
  ],
  "proposableWeeklyAvailableTimes": {
    "mon": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    },
    "tue": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    },
    "wed": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    },
    "thu": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    },
    "fri": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    },
    "sat": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    },
    "sun": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    },
    "hol": {
      "available": true,
      "times": [
        {
          "startTime": {
            "hour": 0,
            "min": 0
          },
          "endTime": {
            "hour": 0,
            "min": 0
          }
        }
      ]
    }
  },
  "place": "string",
  "placeInfo": "offline",
  "information": "string",
  "deadline": "2019-08-24T14:15:22Z",
  "cc": [
    "string"
  ],
  "status": "started",
  "proposedPeriods": [
    {
      "start": "2019-08-24T14:15:22Z",
      "end": "2019-08-24T14:15:22Z"
    }
  ],
  "selectedPeriod": {
    "start": "2019-08-24T14:15:22Z",
    "end": "2019-08-24T14:15:22Z"
  },
  "approvedPeriod": {
    "start": "2019-08-24T14:15:22Z",
    "end": "2019-08-24T14:15:22Z"
  },
  "links": {
    "candidateBookingUrl": "string",
    "clientBookingUrl": "string",
    "detailUrl": "string"
  },
  "createdAt": "2019-08-24T14:15:22Z",
  "metadata": {}
}
🟠401Unauthorized
🟠404NotFound
🟠422Unprocessable Entity
🔴500InternalServerError
更新日時 2025-02-25 06:13:53
前へ
一覧
次へ
削除
Built with