쿼리 데이터(테이블) API

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

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

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

쿼리 매개 변수

매개 변수	설명
host	환경 URL, 예: `https://bots.kore.ai`
tableName	데이터를 가져올 테이블의 이름
sys_limit	가져올 최대 레코드 수입니다. 기본적으로 이 값은 10으로 설정되고 허용되는 최대값은 100입니다.
sys_offset	결과 데이터 세트의 시작 부분에서 건너뛴 레코드 수입니다.

본문 매개 변수

매개 변수	설명
query	가져올 행을 식별하는 필터 기준 "query":{ "expressions": [ {"field": "<col1_name>", "operand": "=/!=/</>", "value": "<value1>"}, {"field": "<col2_name>", "operand": "=/!=/</>", "value": "<value2>"} ], "operator": "and/or" }

매개 변수

설명

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/tables/{{tableName}}/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,
        }
    ]
}

On this Page