作成 - Nitte 人材紹介 API

Requestパラメータ

Authorization

Headerにパラメータ

Authorization

を追加し、その値にはBearerの後にTokenを連結します

例：

Authorization: Bearer ********************

Pathパラメータ

teamId

string

必須

Request Bodyパラメータapplication/json

email

string <email>

必須

メールアドレス

サンプル値:

nitte@exmaple.com

privateName

string

必須

管理名

サンプル値:

client-12345

publicName

string

必須

公開名

サンプル値:

Nitte株式会社

tel

string | null

可選

電話番号

デフォルト値:

null

サンプル値:

08012341234

lineUserId

string | null

可選

LINE ユーザーID

デフォルト値:

null

blockedPeriods

array[object (時間帯) {2}]

可選

ブロックされた時間帯

start

string <date-time>

必須

開始時刻(ISO8601)

end

string <date-time>

必須

終了時刻(ISO8601)

preProposedPeriods

array[object (時間帯) {2}]

可選

事前に受け取った候補日時

start

string <date-time>

必須

開始時刻(ISO8601)

end

string <date-time>

必須

終了時刻(ISO8601)

id

string

可選

指定したIDで企業担当者を作成できます。指定しない場合は、ランダムに設定されます。

例

{
  "email": "nitte@exmaple.com",
  "privateName": "client-12345",
  "publicName": "Nitte株式会社",
  "tel": null,
  "lineUserId": null,
  "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"
    }
  ],
  "id": "string"
}

サンプルコード

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.nitte.app/mediatories//clients' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "nitte@exmaple.com",
    "privateName": "client-12345",
    "publicName": "Nitte株式会社",
    "tel": null,
    "lineUserId": null,
    "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"
        }
    ],
    "id": "string"
}'

Response

🟢200成功

application/json

Body

企業担当者

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}]

必須

調整不可の時間帯

start

string <date-time>

必須

開始時刻(ISO8601)

end

string <date-time>

必須

終了時刻(ISO8601)

preProposedPeriods

array[object (時間帯) {2}]

必須

登録された候補日時

start

string <date-time>

必須

開始時刻(ISO8601)

end

string <date-time>

必須

終了時刻(ISO8601)

例

{
  "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"
    }
  ]
}

🟠401Unauthorized

🟠404NotFound

🟠422Unprocessable Entity

🔴500InternalServerError