데이터 업데이트 API

데이터를 데이터 테이블로 업데이트하는 데 사용됩니다.

앱에서 이 API를 사용하려면 DaaS의 데이터 정의에서 데이터 테이블에 대한 읽기 및 쓰기 액세스 권한이 부여되어야 합니다(자세한 내용은 여기 참조).

PUT https://{{host}}/api/public/tables/{{tableName}}

Kore.ai 봇 플랫폼은 보안 API를 사용하여 봇 개발에 대한 액세스를 제공합니다. 이 API 사용 방법에 대한 자세한 내용은 여기를 참조하세요.

쿼리 매개 변수

매개 변수 설명
host 환경 URL, 예: https://bots.kore.ai
tableName 데이터를 업데이트할 테이블의 이름

본문 매개 변수

매개 변수 설명
query

업데이트할 행을 식별하는 필터 기준

 "query":{
	"expressions": [
	   {"field": "<col1_name>", "operand": "=/!=/</>", "value": "<value1>"},
	   {"field": "<col2_name>", "operand": "=/!=/</>", "value": "<value2>"}
	],
	"operator": "and/or"
	   }
data

업데이트할 칼럼에 대한 column_name: 값 쌍을 가진 객체

"data": {
        "<col1_name>": "<value1>",
        "<col2_name>": "<value2>",
   }

권한 부여

다음 구문을 포함한 헤더에 JWT를 포함한 API를 호출합니다. auth: {{JWT}}

콘텐츠 유형 응답

application/json

샘플 요청

curl -X PUT \
  http://{{host}}/api/public/tables/{{tableName}} \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -H 'content-type: application/json' \
  -d '{
      "query":{
 	"expressions": [
        	{"field": "firstName", "operand": "=", "value": "Jane"},
		{"field": "lastName", "operand": "=", "value": "Doe"}
		],
		"operator": "and"
	   },
      "data": {
        "First_Name": "Jane",
        "Last_Name": "Smith",
        "Number": 3453
    }
}'

샘플 응답

{
 "records": [
    {
     "_id": "5e7ef67172034b399ace6b03",
     "First_Name": "Jane",
     "Last_Name": "Smith",
     "Gender": "Female",
     "Number": 3453,
     "Updated_On": "2020-03-28T07:51:32.502Z",
     "Created_On": "2019-03-28T07:02:09.652Z",
     "Updated_By": "st-98e05480-0257-5e35-b6d2-66a323834f9d",
     "Created_By": "st-98e05480-0257-5e35-b6d2-66a323834f9d",
     "sys_Id": "sys-545dae21-8675-5a95-9c1b-a223bc6f4bc8"
     }
    ]
}

Data Update API

データテーブルにデータを更新する際に使用。

このAPIを使用するためには、 DaaSにおけるデータ定義からデータテーブルへの読み取りおよび書き込みのアクセス権をアプリに与える必要があります(詳細についてはこちらをご参照ください)。

PUT https://{{host}}/api/public/tables/{{tableName}}

Kore.aiボットプラットフォームは、セキュリティ保護されたAPIを使用して、ボット開発へのアクセス権を提供します。これらのAPIの使用方法については、こちらを参照ください

クエリパラメータ

パラメータ 説明
host 環境URL、例: https://bots.kore.ai
tableName データを更新するテーブルの名前

本文パラメータ

パラメータ 説明
query

更新される行を更新するフィルター基準

 "query":{
  "expressions": [
     {"field": "<col1_name>", "operand": "=/!=/</>", "value": "<value1>"},
     {"field": "<col2_name>", "operand": "=/!=/</>", "value": "<value2>"}
  ],
  "operator": "and/or"
     }
data

Object with the column_name: value pairing for the columns to be updated

"data": {
        "<col1_name>": "<value1>",
        "<col2_name>": "<value2>",
   }

認証

ヘッダー内のJWTを含むAPIを、以下の構文で呼び出します。 auth: {{JWT}}

応答コンテンツタイプ

application/json

サンプルのリクエスト

curl -X PUT \
  http://{{host}}/api/public/tables/{{tableName}} \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -H 'content-type: application/json' \
  -d '{
      "query":{
  "expressions": [
          {"field": "firstName", "operand": "=", "value": "Jane"},
    {"field": "lastName", "operand": "=", "value": "Doe"}
    ],
    "operator": "and"
     },
      "data": {
        "First_Name": "Jane",
        "Last_Name": "Smith",
        "Number": 3453
    }
}'

サンプルのレスポンス

{
 "records": [
    {
     "_id": "5e7ef67172034b399ace6b03",
     "First_Name": "Jane",
     "Last_Name": "Smith",
     "Gender": "Female",
     "Number": 3453,
     "Updated_On": "2020-03-28T07:51:32.502Z",
     "Created_On": "2019-03-28T07:02:09.652Z",
     "Updated_By": "st-98e05480-0257-5e35-b6d2-66a323834f9d",
     "Created_By": "st-98e05480-0257-5e35-b6d2-66a323834f9d",
     "sys_Id": "sys-545dae21-8675-5a95-9c1b-a223bc6f4bc8"
     }
    ]
}

Data Update API

Used to update data into Data Table.

To use this API, the app needs to be given Read and Write access to the Data Table from the Data Definition in DaaS (see here for details)

PUT https://{{host}}/api/public/tables/{{tableName}}

Kore.ai Bots Platform provides access to bot development using secured APIs. Refer here to learn more on how to use these APIs.

Query Parameters

Parameter Description
host Environment URL, for example, https://bots.kore.ai
tableName Name of the table to update data

Body Parameters

Parameter Description
query Filter criteria identifying the row to be updated

 "query":{
	"expressions": [
	   {"field": "<col1_name>", "operand": "=/!=/</>", "value": "<value1>"},
	   {"field": "<col2_name>", "operand": "=/!=/</>", "value": "<value2>"}
	],
	"operator": "and/or"
	   }
data Object with the column_name: value pairing for the columns to be updated

"data": {
        "<col1_name>": "<value1>",
        "<col2_name>": "<value2>",
   }

Authorization

Invoke the API with JWT in the header with the following syntax:

auth: {{JWT}}

Response content type

application/json

Sample Request

curl -X PUT \
  http://{{host}}/api/public/tables/{{tableName}} \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -H 'content-type: application/json' \
  -d '{
      "query":{
 	"expressions": [
        	{"field": "firstName", "operand": "=", "value": "Jane"},
		{"field": "lastName", "operand": "=", "value": "Doe"}
		],
		"operator": "and"
	   },
      "data": {
        "First_Name": "Jane",
        "Last_Name": "Smith",
        "Number": 3453
    }
}'

Sample Response

{
 "records": [
    {
     "_id": "5e7ef67172034b399ace6b03",
     "First_Name": "Jane",
     "Last_Name": "Smith",
     "Gender": "Female",
     "Number": 3453,
     "Updated_On": "2020-03-28T07:51:32.502Z",
     "Created_On": "2019-03-28T07:02:09.652Z",
     "Updated_By": "st-98e05480-0257-5e35-b6d2-66a323834f9d",
     "Created_By": "st-98e05480-0257-5e35-b6d2-66a323834f9d",
     "sys_Id": "sys-545dae21-8675-5a95-9c1b-a223bc6f4bc8"
     }
    ]
}