API 도구 생성 - 고급

목표
GET/POST/PUT/DELETE 등 다양한 HTTP 메서드를 자세히 이해하고, 각 메서드별 특징과 쓰임새를 배우기
JSON Body를 전송해 데이터를 생성(CREATE) 및 수정(UPDATE)하고, DELETE로 제거하는 과정을 직접 실습하며, CRUD 개념을 온전히 파악하기
어시웍스에서 Body/Headers/메서드 설정을 자유롭게 구성해, 실제 사내 API나 외부 API에도 쉽고 빠르게 노코드 연동을 적용할 수 있는 역량 기르기

1. 왜 다양한 HTTP 메서드를 다뤄야 할까?

1.1 GET만으로는 데이터 조회만 가능

초급·중급 가이드를 통해 GET 메서드를 사용하면 서버에 있는 데이터를 조회할 수 있다는 점을 이미 배우셨을 겁니다. 하지만 실제 서비스나 업무 프로세스를 살펴보면, 새로운 데이터를 생성(POST) 하거나, 기존 데이터를 수정(PUT 혹은 PATCH) 하고, 삭제(DELETE) 하는 로직이 반드시 필요합니다.

1.2 CRUD: 실무에서 필수

이렇게 생성(Create), 조회(Read), 수정(Update), 삭제(Delete)를 모두 아우르는 CRUD는, 대부분의 웹·모바일·사내 시스템에서 기본 골격을 이룹니다.

C → POST
R → GET
U → PUT/PATCH
D → DELETE

단순히 조회(GET)만 할 수 있어서는 불충분하고, 업무를 자동화하려면 꼭 POST/PUT/DELETE도 자유롭게 다룰 수 있어야 합니다.

1.3 플로우(Flow)나 에이전트(Agent)에도 필요

플로우(Flow):
- 여러 단계로 “새 데이터를 만들고(POST) → 필요한 부분을 수정(PUT) → 필요한 시점에 삭제(DELETE)” 같은 연쇄적인 작업을 구성할 수 있습니다.
- 이 흐름을 노코드로 구현해두면, 사람이 하나하나 수동으로 처리하지 않아도 자동화가 완성됩니다.
에이전트(Agent):
- 대화형으로 “게시물을 등록해줘” → “제목만 수정해줘” → “그 게시물 삭제해줘” 같은 명령을 하면, 에이전트가 각 단계에서 POST/PUT/DELETE 도구를 적절히 호출하여 업무를 처리할 수 있게 됩니다.

2. JSONPlaceholder로 실습하기

이번 고급 가이드에서는 JSONPlaceholder라는 무료 테스트용 REST API를 통해 실습해 보겠습니다. JSONPlaceholder는:

인증 없이 GET/POST/PUT/DELETE 요청을 모두 허용
게시물(Post), 댓글(Comment), 사용자(User) 등 가상 데이터를 제공
실제 DB에 반영되지 않고 “가상의” 생성·수정·삭제 결과만 반환하므로, 마음 편히 테스트할 수 있음

이후, 여러분이 사내 API나 상용 API를 사용할 때도 원리는 똑같이 적용됩니다. “도구 유형: API”, “HTTP 메서드 선택”, “Body/Headers 설정” 등만 제대로 익혀두면, 어시웍스에서 다양한 자동화를 쉽고 빠르게 구현할 수 있습니다.

3. GET: 서버로부터 데이터 가져오기 (Read)

GET은 서버에 있는 데이터를 읽어오기만 하는 용도로 쓰입니다. 예를 들어, “게시물 목록 보여줘”라든지, “ID가 1인 게시물을 불러와” 같은 시나리오에 적합합니다.

3.1 JSONPlaceholder 예시: 모든 게시물 조회

GET https://jsonplaceholder.typicode.com/posts

위 주소를 호출하면, 가상 게시물(Posts) 목록이 JSON 배열 형태로 반환됩니다.

3.2 어시웍스 실습 예시: “포스트 보기 도구 (GET)”

도구를 아래와 같이 설정합니다.

도구 이름: 포스트 보기 도구
도구 설정: API, GET

파라미터를 아래와 같이 구성합니다.

url: https://jsonplaceholder.typicode.com/posts

이렇게 설정한 뒤 Call API 버튼을 누르면, 전체 게시물 목록이 JSON 형태로 응답됩니다. 별도 Body나 파라미터가 필요 없으며, 조회(READ) 전용이므로 GET 메서드가 가장 적합하죠.

4. POST: 서버에 새 데이터 생성 (Create)

POST는 새로운 리소스를 서버에 추가할 때 사용합니다. 예컨대, “새로운 글을 작성하기”나 “신규 고객 정보를 등록하기” 같은 경우가 여기에 해당합니다.

4.1 JSONPlaceholder 예시: 새 게시물 등록

POST https://jsonplaceholder.typicode.com/posts

요청 본문(Body)에 title, body, userId 같은 필드를 담아 보내면, 서버 측에서 가상의 “새 글”을 생성한 것처럼 응답을 반환합니다.

4.2 어시웍스 실습 예시: “포스트 등록 도구 (POST)”

도구를 아래와 같이 설정합니다.

도구 이름: 포스트 등록 도구
도구 설정: POST

파라미터를 아래와 같이 구성합니다.

url: https://jsonplaceholder.typicode.com/posts
json:

{
	"title": "{title}",  
	"body": "{content}",  
	"userId": {user_id}
}

{title}: "인사"
{content}: "안녕하세요. 김태영입니다. 반갑습니다."
{user_id}: 999

이 도구를 실행하면, JSONPlaceholder가 {"id": 101, "title": "...", "body": "...", "userId": 999} 같은 응답을 주며, 새 게시물이 생성된 것처럼 처리합니다.

API 도구에서 지정된 파라미터는 url, headers, json, data가 있습니다. 이 예제에서는 url과 json을 사용했습니다.

POST 메소드는 url외에도 메시지의 내용을 보내야하는데요. json 라는 파라미터가 바로 API 메시지의 내용입니다. 파라미터의 이름에서도 알 수 있듯이 그 내용 형식은 json입니다. 만약 json 형식이 아니라면 data 라고 기입해야 합니다.

5. PUT(혹은 PATCH): 기존 데이터 수정 (Update)

데이터를 수정(UPDATE)하는 대표 메서드는 PUT과 PATCH로 나뉩니다:

PUT: 보통 전체 리소스를 덮어써서 교체
PATCH: 자주 일부 필드만 변경하는 데 이용

5.1 JSONPlaceholder 예시: 게시물 수정(PUT)

PUT https://jsonplaceholder.typicode.com/posts/{postId}

Body 안에 id, title, body, userId 등 수정 후의 전체 데이터를 넣어서 보냅니다.

5.2 어시웍스 실습 예시: “포스트 수정 도구 (PUT)”

도구를 아래와 같이 설정합니다.

도구 이름: 포스트 수정 도구
도구 설정: API, PUT

파라미터를 아래와 같이 구성합니다.

url: https://jsonplaceholder.typicode.com/posts/{id}
json:

{  
	"id": "{id}",  
	"title": "{title}",  
	"body": "{content}",  
	"userId": "{user_id}" 
}

{id}: 100
{title}: "hello~"
{content}: "I'm Taeyoug Kim."
{user_id}: 999

이를 실행하면, JSONPlaceholder에서 “게시물 ID=100을 새로 덮어쓴 것처럼” 응답이 돌아옵니다. 실제로는 데이터베이스가 바뀌지 않지만, 수정 로직 자체는 제대로 연습할 수 있습니다.

6. DELETE: 서버에서 데이터 제거 (Delete)

DELETE는 말 그대로 특정 리소스를 서버에서 영구 삭제하는 요청입니다.

6.1 JSONPlaceholder 예시: 게시물 삭제

DELETE https://jsonplaceholder.typicode.com/posts/{postId}

호출 시, 해당 게시물을 삭제한 것으로 응답합니다.

6.2 어시웍스 실습 예시: “포스트 삭제 도구 (DELETE)”

도구를 아래와 같이 설정합니다.

도구 이름: 포스터 삭제 도구
도구 설정: API, DELETE

파라미터를 아래와 같이 구성합니다.

url: https://jsonplaceholder.typicode.com/posts/{id}
{id}: 1

Body는 필요 없으며, URL에 어떤 게시물을 삭제할지(postId=1) 나타내면 됩니다.

8. 플로우(Flow) & 에이전트(Agent) 활용 시나리오

8.1 플로우

예를 들어 한 번의 플로우 안에:

트렌드 검색을 통해 키워드를 선정한 다음
해당 키워드로 게시물을 만든 뒤에
POST 도구로 새 게시물 생성할 수 있습니다.

이런 연속적인 작업을 노코드로 연결할 수 있습니다. 이후 특정 시간 스케줄러나 이벤트에 의해 플로우가 실행되면, 사람 개입 없이 게시물이 생성됩니다.

8.2 에이전트: 자연어 명령 → API 도구 호출

사용자가 “게시물 목록 보여줘”라고 말하면 GET 도구를 호출해 결과를 받아오고,
“3번 게시물 제목을 ‘새로운 제목’으로 바꿔줘”라고 하면 PUT 도구로 수정,
“3번 게시물은 이제 필요 없으니 지워줘” 하면 DELETE 도구로 삭제를 진행.

이렇게 대화형으로 CRUD를 처리하면, 현업 사용자도 부담 없이 업무 데이터를 조작할 수 있습니다.

9. 정리와 결론

GET은 읽기, POST는 생성, PUT/PATCH는 수정, DELETE는 삭제라는 CRUD 개념을 통해, API 도구가 훨씬 강력해집니다.
이번 가이드에서 사용한 JSONPlaceholder는 실제로 DB가 바뀌진 않지만, 요청-응답 과정이 실무 API와 동일해, 연습하기에 최적입니다.
더 나아가 플로우(Flow)와 에이전트(Agent)를 결합해, 완전한 CRUD 시나리오를 시각적으로 연결하거나 자연어 명령으로 실행할 수도 있습니다.