소개

이 기사는 CURL에서 기본적인 kintone REST API를 두드리는 방법을 소개합니다.
사전 지식으로 kintone 앱을 만드는 방법, 필드 코드를 편집하는 방법, API 토큰을 생성하는 방법, 앱 ID를 확인하는 방법, 레코드 ID를 확인하는 방법, CURL을 두드리는 방법을 알아야합니다.

사전 준비

문자열(1행), 숫자, 드롭다운으로 구성된 아래와 같은 앱을 준비합니다.
필드 코드는 필드 이름과 동일했습니다. 이 예에서는 앱 ID가 111로 설정되어 있다고 가정합니다.


CURL을 두드리기 전에 레코드 데이터를 적용에 추가합니다.

CURL로 두드려보세요

레코드 등록

Name에 Andrew, Age에 77, Skill에 Python을 포함한 데이터 등록 예:

post

curl -X POST 'https://{subdomain}.cybozu.com/k/v1/record.json' \
 -H 'X-Cybozu-API-Token: {API_TOKEN}' \
 -H 'Content-Type: application/json' \
 -d '{"app": 111,"record": {"Name":{"value":"Andrew"},"Age":{"value":77},"Skill":{"value":"Python"}}}'

API에 대한 정보는 여기 : 레코드 등록

레코드 취득(1건)

레코드 ID가 3인 레코드 정보를 얻는 예:

getrecord

curl -G 'https://{subdomain}.cybozu.com/k/v1/record.json?app=111&id=3' \
 -H 'X-Cybozu-API-Token: {API_TOKEN}'

API에 대한 정보는 여기 : 레코드 취득 (1 건)

레코드 가져 오기 (쿼리를 지정하여 여러 번 검색)

Skill에 Ruby가 설정된 레코드를 여러 개 가져오고 응답에 포함된 필드 정보를 Name과 Age로만 만드는 예:

getrecords

curl -G 'https://{subdomain}.cybozu.com/k/v1/records.json' \
 -H 'X-Cybozu-API-Token: {API_TOKEN}' \
 --data-urlencode 'app=111' \
 --data-urlencode 'fields[0]=Name' \
 --data-urlencode 'fields[1]=Age' \
 --data-urlencode 'query=Skill in ("Ruby")'

API에 대한 정보는 여기 : 레코드 일괄 획득(쿼리에서 조건 지정)

마지막으로

여러 레코드 검색 쿼리에 지정하는 방법은 까다로울 수 있지만 위의 예제를 참조하고 필요한 쿼리를 던져 보자!
문제가 해결되지 않으면 CURL 옵션에 --verbose 를 추가하고 요청 내용을 확인하면서 디버깅해 봅시다.