developers · Sep 21, 2025
n8n을 예로 든 Quire API 외부 도구 연동 가이드
최종 업데이트: 2026년 7월 20일
이 가이드는 n8n을 예시 자동화 플랫폼으로 사용해 Quire API로 커스텀 연동을 구축하는 방법을 다룹니다. 총 6단계로 진행됩니다: Quire 앱 등록, n8n 실행, OAuth2 설정(Authentication 필드는 반드시 Body로 지정), /task/list/id/{projectId}를 통한 업무 GET, /task/id/{projectId}를 통한 업무 POST, 그리고 sourceRef를 이용한 출처 메타데이터 연결까지 포함합니다. 같은 방식은 Zapier 등 다른 로우코드 플랫폼에도 그대로 적용됩니다.
Quire는 Quire 업무를 프로그래밍 방식으로 읽고 업데이트할 수 있는 개방형 API를 제공합니다. 앱 디렉토리에 등록된 여러 앱들도 Quire API를 직접 호출해 만들어졌습니다.
기존 앱이 요구 사항에 맞지 않는다면 커스텀 연동을 직접 구축해 보세요. 이 글에서는 n8n을 예시 자동화 플랫폼으로 삼아 Quire API 사용법을 살펴보며, 같은 개념은 Zapier 같은 다른 로우코드 플랫폼에도 그대로 적용됩니다.
이런 방식은 점점 더 보편화되고 있습니다. 가트너는 2025년까지 조직이 개발하는 신규 애플리케이션의 70%가 로우코드 또는 노코드 기술을 사용할 것으로 추정했는데, 이는 2020년의 25% 미만에서 크게 늘어난 수치입니다. n8n은 이 분야에서 가장 널리 쓰이는 오픈소스 옵션 중 하나입니다.
이 가이드에서 사용하는 Quire API 엔드포인트
| 작업 | 메서드 | 엔드포인트 | 주요 필드 |
|---|---|---|---|
| 프로젝트의 루트 업무 읽기 | GET | /task/list/id/{projectId} |
— |
| 업무 생성 | POST | /task/id/{projectId} |
name, description |
| 출처 메타데이터 연결 | POST/PUT 필드 | sourceRef.text(마크다운), 기타 커스텀 키 |
업무 상세에 표시됨 |
| 활동 기록에 앱을 실행 주체로 표시 | 요청 필드 | asUser: true |
활동 기록에 앱 이름이 표시됨 |
구현 단계는 어떻게 되나요?
- Quire에서 앱을 만들어 API 자격 증명 발급받기
- n8n 인스턴스 준비하고 실행하기
- n8n에서 OAuth2로 인증하기
- 첫 API 요청 보내기(업무 읽기)
- API로 업무 생성 또는 수정하기(쓰기)
- sourceRef로 출처 참조나 커스텀 메타데이터 저장하기
1. Quire에서 앱 만들기
Quire API에 접근하려면 Quire에 앱을 등록하고, 클라이언트 ID와 클라이언트 시크릿을 발급받고, OAuth2용 리디렉션 URI를 설정해야 합니다.
Quire API로 Quire 앱을 만드는 단계별 방법은 저희 블로그 글을 참고해 주세요.
2. n8n 준비하기
테스트용으로는 n8n을 무료로 셀프 호스팅할 수 있습니다. 자세한 내용은 공식 문서를 참고하세요.
실행되면 새 워크플로를 만들고, API 요청을 수행하고 응답을 처리할 노드를 추가합니다.
3. OAuth2로 인증하기
Quire는 인증에 OAuth2를 사용합니다. 자격 증명을 생성하면 n8n이 토큰 교환을 대신 처리해 줍니다.
- 워크플로 화면에서 새 자격 증명을 추가하고 OAuth2 옵션을 선택합니다.
- Quire 앱 설정에서 클라이언트 ID, 클라이언트 시크릿, 인증 URL, 토큰 URL, 리디렉션 URI를 입력합니다. 리디렉션 URI는 n8n에서 복사해 Quire 앱 설정에 붙여넣어야 OAuth2 흐름이 제대로 작동합니다. n8n에서는 "Authentication" 필드를 반드시
Body로 설정해야 Quire가 요구하는 올바른 형식으로 자격 증명이 전송됩니다.
- Connect to my account을 클릭하면 n8n이 Quire의 인증 페이지로 이동시킵니다. 인증할 프로젝트를 선택하고 절차를 완료합니다.
4. 첫 API 요청 보내기(업무 읽기)
Quire API 문서: https://quire.io/dev/api/
n8n의 HTTP Request 노드로 API를 호출합니다. 예를 들어 프로젝트의 모든 루트 업무를 가져와 보겠습니다.
- 기본 URL:
https://quire.io/api - 엔드포인트:
/task/list/id/{projectId}({projectId}는 프로젝트 URL에 있는 프로젝트 ID로 교체하며, 보통https://quire.io/w/<projectId>형태입니다)
HTTP Request 노드에서:
- 메서드: GET
- URL:
https://quire.io/api/task/list/id/<your_project_id> - Authentication: Generic Credential Type
- Generic Auth Type: OAuth2 API
- OAuth2 API:
<방금 생성한 자격 증명>
노드를 실행하면 오른쪽 패널에서 응답 데이터를 확인할 수 있고, 이 데이터를 이후 노드로 넘겨 처리할 수 있습니다.
5. 업무 생성 또는 수정하기(쓰기)
API를 이용해 업무를 생성할 수 있습니다(문서의 새 업무 추가 참고).
- 엔드포인트:
/task/id/{projectId}
n8n의 HTTP Request 노드에서:
- 메서드: POST
- URL:
https://quire.io/api/task/id/<your_project_id> - Send Body를 활성화하고 필수 필드(예:
name)와description같은 선택 필드를 입력합니다.
Send Body를 활성화한 뒤에는 Body Content Type을 JSON으로, Specify Body를 Using JSON으로 설정해야 합니다. 이렇게 하면 아래 예시 코드처럼 JSON 형식으로 요청 본문을 입력할 수 있습니다.
{
"name": "Example task",
"description": "Created via n8n"
}
노드를 실행하면 응답에 생성된 업무의 상세 정보가 담기고, Quire 프로젝트에서도 해당 업무를 확인할 수 있습니다.
6. sourceRef로 출처 참조와 커스텀 데이터 저장하기
sourceRef를 포함한 요청 본문 예시입니다.
{
"name": "Task from n8n",
"description": "Automated task",
"sourceRef": {
"text": "[Open in MyApp](https://example.com/item/123)",
"meta": { "workflowId": "n8n-abc-123" }
}
}
sourceRef는 업무와 관련된 커스텀 데이터를 저장하기 위한 필드입니다. 미리 정의된 필드는 text 하나뿐이며, 마크다운을 지원하고 Quire 업무 상세 화면에 표시되므로 사용자가 클릭할 수 있는 링크나 짧은 설명을 넣기에 좋습니다.
sourceRef 아래에 추가하는 다른 필드는 전적으로 애플리케이션 자유입니다. 예를 들어 meta 객체나 다른 키를 넣어 식별자나 플래그를 저장할 수 있지만, 이는 어디까지나 선택 사항입니다.
API로 업무를 읽어올 때는 반환된 JSON에서 sourceRef 객체를 확인하세요. text 필드와 그 안에 저장한 커스텀 데이터에 접근할 수 있어, 자동화가 출처를 추적하고 이후 처리를 위한 추가 정보를 함께 전달하기 쉬워집니다.
업무를 생성하거나 업데이트할 때 유용한 또 하나의 필드는 asUser입니다.
asUser를 true로 설정하면, 활동 기록에 해당 업무를 생성하거나 업데이트한 사용자로 Quire 앱의 이름이 표시됩니다. 이는 사용자가 어떤 업무가 API 연동으로 만들어졌는지 파악하는 데 도움이 됩니다.
Quire API 오류는 어떻게 처리하나요?
Quire API를 호출하면서 마주치는 문제의 거의 대부분은 네 가지 HTTP 상태 코드로 설명됩니다. 각각 구체적인 해결 방법이 있습니다.
- 401 Unauthorized: OAuth2 토큰이 유효하고 만료되지 않았는지 확인하세요. 자격 증명 설정이 올바른지도 점검하세요.
- 400 Bad Request: 요청 본문과 파라미터를 다시 확인하세요. JSON 형식이 올바르고 필수 필드가 포함되어 있는지 확인하세요.
- 403 Forbidden: 앱과 사용자가 해당 프로젝트나 리소스에 접근할 권한을 가지고 있는지 확인하세요.
- 404 Not Found: 사용 중인 API 엔드포인트와 프로젝트/업무 ID를 다시 확인하세요.
오류 메시지와 필수 파라미터에 대한 자세한 내용은 항상 Quire API 문서를 참고하세요. 오류가 발생하면 응답 메시지를 꼼꼼히 읽어보세요. 대개 무엇이 잘못됐는지에 대한 힌트가 담겨 있습니다.
Quire API로 양방향 동기화는 어떻게 구현하나요?
앞서 소개한 글에서 설명한 것처럼, n8n과 Quire API를 이용해 나만의 양방향 동기화 솔루션을 직접 구축할 수도 있습니다.
실제 예시가 궁금하다면 저희 오픈소스 저장소를 확인해 보세요: n8n Quire API. 이 저장소는 단계별 가이드와 실제로 작동하는 템플릿을 제공해, 여러분의 앱과 Quire 간 양방향 동기화를 훨씬 쉽게 구현할 수 있도록 돕습니다.
Quire API로 양방향 동기화를 구축하는 단계별 방법은 저희 블로그 글을 참고해 주세요.
다음 단계는 무엇인가요?
이제 업무를 읽고, 업무를 생성하고, sourceRef로 출처 메타데이터를 연결하고, asUser로 활동 기록에 여러분의 연동을 표시하는 데 필요한 준비가 끝났습니다. 같은 패턴을 다른 Quire API 엔드포인트에도 그대로 확장할 수 있으며, 공식 API 문서가 가장 정확한 참고 자료입니다.
문제가 생긴다면 위의 오류 처리 섹션에서 가장 흔한 네 가지 HTTP 응답을 다루고 있습니다. 그 외의 사항은 feedback@quire.io로 문의해 주세요.
관련 글: 5분 만에 끝내는 Quire MCP 설정: Claude, ChatGPT 등 AI 클라이언트 연결하기 — 커스텀 API 호출을 직접 작성하는 대신 AI 클라이언트가 Quire와 곧바로 연동되길 원한다면, MCP가 더 빠른 방법입니다.
관련 글: Quire 웹훅 설정 단계별 가이드 — 웹훅은 워크플로가 API를 일일이 폴링할 필요 없이, Quire에서 무언가 바뀌는 순간 곧바로 자동화 도구에 업데이트를 전달합니다.
자주 묻는 질문
Quire API란 무엇이고, 무엇을 할 수 있나요?
Quire 업무를 프로그래밍 방식으로 읽고 업데이트할 수 있는 개방형 API입니다. 앱 디렉토리에 있는 기존 앱이 요구 사항에 맞지 않을 때 커스텀 연동을 구축하는 데 활용할 수 있습니다.
Quire API 인증은 어떻게 하나요?
Quire는 OAuth2를 사용합니다. Quire 앱을 등록하고 클라이언트 ID와 시크릿을 발급받은 뒤, n8n의 authentication 필드를 Body로 설정하면 Quire가 요구하는 형식으로 자격 증명이 전송됩니다.
n8n으로 Quire와 연동할 수 있나요?
네, 가능합니다. n8n을 무료로 셀프 호스팅하거나 n8n.cloud를 이용한 다음, OAuth2 자격 증명을 갖춘 HTTP Request 노드로 업무를 읽고 씁니다. 같은 패턴은 Zapier 등 유사한 플랫폼에도 그대로 적용됩니다.
Quire API의 sourceRef는 무엇인가요?
sourceRef는 업무에 커스텀 데이터를 저장하는 필드입니다. 미리 정의된 text 필드는 마크다운을 지원하고 업무 상세 화면에 표시되며, meta 같은 다른 키를 추가해 출처를 추적하거나 자동화 메타데이터를 함께 담을 수 있습니다.
Quire API가 오류를 반환하면 무엇을 확인해야 하나요?
401은 토큰 문제, 400은 잘못된 요청 본문, 403은 권한 문제, 404는 잘못된 엔드포인트나 ID를 의미합니다. 응답 메시지를 읽어보세요. 대개 해결 방법을 알려줍니다.
