← 노드 한 장 전체#46 · GraphQL
GraphQL
국가 정보, 필요한 칸만 골라 받기
이 글은 이런 분께GraphQL API에서 필요한 필드만 지정해 데이터를 받아보고 싶은 분
1분 영상은 @workflow.hanjang 에 순서대로 공개돼요
국가 정보, 필요한 칸만 골라 받기.
노드 한 장 #46 · GraphQL
먼저 결과부터
GraphQL은 API에서 받을 필드를 query로 적어 요청하는 방식이에요. 국가 코드 KR에서 name·currency·languages.name만 요청하니 실제 API 응답은 South Korea·KRW·Korean이었어요. n8n 성공 실행 #74831은 1 item을 반환했고 GraphQL 노드 시간은 319ms예요. 별도 API 테스트에서는 잘못된 필드 요청이 HTTP 200과 errors를 함께 반환했으므로 HTTP 상태와 GraphQL 결과를 구분해야 해요. POST 읽기 query만 썼고 mutation·계정 키·메시지 발송은 없어요.
우리가 실제로 돌린 기록 · 실행 #74831 · 2026-10-30
우리가 실제로 돌린 기록 · 실행 #74831 · 2026-10-30
- name → South Korea
- currency → KRW
- languages.name → Korean
따라 하기
실제로 실행한 워크플로우를 바탕으로 정리했어요. 계정·식별자는 공개용 값으로 치환했고, 그 밖의 차이는 아래 주의사항에 표시했어요. n8n 캔버스에서 +를 눌러 노드를 순서대로 추가하고 같은 값을 넣으면 돼요. 빨간 제목이 이번 편의 주인공 노드예요. 표 왼쪽은 n8n 편집기에 보이는 칸 이름, 오른쪽은 다운로드 JSON의 설정값이에요. 직접 입력하기 번거로우면 JSON을 받아 ⋯ → Import from File로 가져오세요.
Step 1. Manual Trigger 노드 추가이름: Run manually
설정 없이 그대로 추가해요.
Step 2. GraphQL 노드 추가이름: GraphQL - KR selected fields
| Authentication | None |
| HTTP Request Method | POST |
| Endpoint | https://countries.trevorblades.com/ |
| Ignore SSL Issues (Insecure) | 꺼짐 |
| Request Format | JSON (Recommended) |
| Query | query GetKorea {
country(code: "KR") {
name
currency
languages {
name
}
}
} |
| Response Format | JSON |
가져와서 쓸 때 확인할 것
- YOUR_… 표시를 내 값으로 바꾸고, 계정이 필요한 서비스 노드만 자격 증명을 연결하세요. 그런 칸이나 노드가 없는 예제는 추가 계정 없이 실행할 수 있어요.
노드의 모든 옵션은 n8n 공식 문서에서 볼 수 있어요.