API 문서

SignFlow API를 사용하여 견적서, 계약서, 전자서명 기능을 여러분의 서비스에 통합하세요. RESTful API로 설계되어 어떤 언어에서든 쉽게 연동할 수 있습니다.

인증 방식

모든 API 요청에는 JWT Bearer 토큰이 필요합니다. 대시보드의 설정 > API 키 메뉴에서 토큰을 발급받을 수 있습니다.

Authorization: Bearer <YOUR_API_TOKEN>

Base URL

https://api.signflow.co.kr

Rate Limiting

API 요청은 플랜에 따라 제한됩니다. 프로 플랜은 분당 60회, 엔터프라이즈 플랜은 분당 300회까지 요청할 수 있습니다. 제한 초과 시 429 Too Many Requests 응답이 반환됩니다.

주요 API 엔드포인트

카테고리	엔드포인트	설명
견적서	POST /api/v1/quotes	새 견적서 생성
견적서	GET /api/v1/quotes/{id}	견적서 상세 조회
견적서	PUT /api/v1/quotes/{id}	견적서 수정
계약서	POST /api/v1/contracts	계약서 생성
계약서	GET /api/v1/contracts/{id}	계약서 상세 조회
전자서명	POST /api/v1/signatures/request	서명 요청 전송
전자서명	GET /api/v1/signatures/{id}/status	서명 상태 확인
거래처	GET /api/v1/clients	거래처 목록 조회
거래처	POST /api/v1/clients	거래처 등록
결제	POST /api/v1/payments/invoice	결제 요청 생성

요청 예시

curl -X POST https://api.signflow.co.kr/api/v1/quotes \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "cl_abc123",
    "title": "웹사이트 개발 견적서",
    "items": [
      {
        "name": "프론트엔드 개발",
        "quantity": 1,
        "unit_price": 5000000
      },
      {
        "name": "백엔드 개발",
        "quantity": 1,
        "unit_price": 7000000
      }
    ],
    "due_date": "2026-04-30"
  }'

ℹ️

엔터프라이즈 플랜 전용

API 기능은 엔터프라이즈 플랜에서 이용 가능합니다. 프로 플랜 사용자는 제한된 읽기 전용 API만 사용할 수 있습니다. 플랜 업그레이드 또는 맞춤 연동이 필요하시면 영업팀에 문의해 주세요.