1. Docs
  2. Virtual Assistants
  3. API Guide
  4. 쿼리 데이터(보기) API

쿼리 데이터(보기) API

테이블 뷰에서 데이터를 가져오는 데 사용됩니다.

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

POST https://{{host}}/api/public/views/{{viewName}}/query?sys_limit={{limit_value}}&sys_offset={{offset_value}}

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

쿼리 매개 변수

매개 변수 설명
host 환경 URL, 예: https://bots.kore.ai
viewName 데이터를 가져올 테이블 보기 양식입니다.
sys_limit 가져올 최대 레코드 수입니다.
sys_offset 결과 데이터 세트의 시작 부분에서 건너뛴 레코드 수입니다.

본문 매개 변수

매개 변수 설명
query

가져올 행을 식별하는 필터 기준

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

권한 부여

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

콘텐츠 유형 응답

application/json

샘플 요청

curl -X POST \
  http://{{host}}/api/public/views/{{viewName}}/query?sys_limit=4&sys_offset=0 \
  -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": "or"
	   }
}'

샘플 응답

{
    "metaInfo": [
        {
            "name": "gender",
            "type": "string"
        },
        {
            "name": "lastName",
            "type": "string"
        }
    ],
    "queryResult": [
        {
            "age": male,
            "last_name":tony,
        }
    ]
}
메뉴