Airparser 웹훅 및 API
웹훅으로 추출된 문서 데이터를 모든 시스템으로 전송하세요. 실시간 알림, 즉각적인 통합, 완전한 개발자 제어.

모든 시스템과 연결하세요
웹훅을 사용하면 문서가 처리될 때 실시간 알림을 받을 수 있습니다. 추출된 데이터를 맞춤 애플리케이션, 내부 시스템 또는 HTTP POST 요청을 받는 모든 서비스로 직접 전송하세요.
문서 처리 워크플로우에 대한 완전한 제어가 필요하고 Airparser를 독점 시스템, 맞춤 데이터베이스 또는 마이크로서비스 아키텍처와 통합하고자 하는 개발자에게 완벽합니다.
왜 웹훅을 사용해야 하나요?
작동 방식
1. 문서 수신
이메일, 업로드 또는 API를 통해 Airparser로 문서가 전송됩니다
2. AI가 데이터 추출
Airparser AI가 문서에서 구조화된 데이터를 추출합니다
3. 웹훅 트리거
JSON 데이터와 함께 엔드포인트로 HTTP POST가 전송됩니다
4. 시스템 처리
애플리케이션이 데이터를 받아 처리합니다
Airparser에서 웹훅을 만드는 방법
실시간 데이터 알림을 받기 시작하려면 Airparser에서 웹훅을 설정하는 이 간단한 가이드를 확인하세요.
웹훅 페이로드 예시
문서가 처리되면 Airparser는 웹훅 URL로 JSON 페이로드를 전송합니다:
{
"parser_id": "parser_abc123",
"document_id": "doc_xyz789",
"timestamp": "2024-01-15T10:30:00Z",
"extracted_data": {
"invoice_number": "INV-2024-001",
"invoice_date": "2024-01-10",
"vendor": "Acme Corporation",
"total_amount": 1250.00,
"currency": "USD",
"line_items": [
{
"description": "Professional Services",
"quantity": 10,
"unit_price": 125.00,
"total": 1250.00
}
]
},
"document_url": "https://airparser.com/documents/doc_xyz789",
"confidence": 0.98
}웹훅 사용 사례
맞춤 데이터베이스
추출된 데이터를 PostgreSQL, MySQL, MongoDB 또는 모든 맞춤 데이터베이스 시스템으로 직접 전송하세요.
내부 시스템
독점 ERP, CRM 또는 내부 비즈니스 애플리케이션과 통합하세요.
마이크로서비스
마이크로서비스 워크플로우와 분산 처리 파이프라인을 트리거하세요.
실시간 알림
맞춤 알림 시스템, 모바일 앱 또는 대시보드로 즉각적인 알림을 전송하세요.
분석 및 보고
추출된 데이터를 비즈니스 인텔리전스 도구와 분석 플랫폼에 공급하세요.
맞춤 자동화
특정 비즈니스 로직에 맞춘 복잡하고 맞춤화된 자동화 워크플로우를 구축하세요.
웹훅 기능
안전한 전달
HTTPS 암호화, 검증을 위한 선택적 웹훅 서명, IP 화이트리스트 지원.
자동 재시도
실패한 웹훅 전달은 지수 백오프로 자동으로 재시도됩니다.
전달 로그
모든 웹훅 전달, 응답, 재시도 시도의 상세 로그를 확인하세요.
테스트 모드
실제 문서를 처리하기 전에 샘플 데이터로 웹훅 엔드포인트를 테스트하세요.
맞춤 헤더
인증, 라우팅 또는 메타데이터를 위한 맞춤 HTTP 헤더를 추가하세요.
JSON 형식
분석과 통합이 쉬운 깨끗하고 구조화된 JSON 페이로드입니다.
웹훅 설정하기
웹훅 엔드포인트 생성
애플리케이션에서 POST 요청을 받는 HTTP 엔드포인트를 설정하세요. 웹 서버, 서버리스 함수, API 엔드포인트 무엇이든 가능합니다.
Airparser에서 설정
파서 설정에서 웹훅 URL을 추가하세요. 선택적으로 맞춤 헤더와 인증을 설정할 수 있습니다.
https://yourdomain.com/webhook/airparser통합 테스트
테스트 기능을 사용하여 엔드포인트로 샘플 페이로드를 전송하고 올바르게 작동하는지 확인하세요.
수신 데이터 처리
애플리케이션에서 JSON 페이로드를 분석하고 비즈니스 로직에 따라 추출된 문서 데이터를 처리하세요.
200 OK 응답 반환
엔드포인트는 수신을 확인하기 위해 200 상태 코드를 반환해야 합니다. 200이 아닌 응답은 자동 재시도를 트리거합니다.
웹훅 핸들러 예시
Airparser 웹훅을 처리하는 간단한 Node.js/Express 예시:
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhook/airparser', (req, res) => {
const data = req.body;
console.log('Received data:', data.extracted_data);
// Process the extracted data
// e.g., save to database, trigger workflow, etc.
// Return 200 to acknowledge receipt
res.status(200).json({ received: true });
});
app.listen(3000, () => {
console.log('Webhook server running on port 3000');
});RESTful API 접근
웹훅 외에도 Airparser는 모든 기능에 프로그래밍 방식으로 접근할 수 있는 포괄적인 RESTful API를 제공합니다.
문서 업로드
API 엔드포인트를 통해 분석할 문서를 제출하세요
결과 조회
GET 요청으로 추출된 데이터를 가져오세요
파서 관리
프로그래밍 방식으로 파서를 생성하고 설정하세요
상태 확인
처리 상태와 이력을 모니터링하세요
자주 묻는 질문
어떤 HTTP 메서드를 지원하나요?
웹훅은 JSON 페이로드가 포함된 HTTP POST 요청을 사용합니다. 엔드포인트는 POST 요청을 받고 2xx 상태 코드를 반환해야 합니다.
웹훅 엔드포인트는 어떻게 보안을 유지하나요?
HTTPS를 사용하고, 웹훅 서명을 검증하고, IP 화이트리스트를 구현하거나, 맞춤 헤더에 API 키를 요구하세요. Airparser는 이러한 모든 인증 방법을 지원합니다.
제 엔드포인트가 다운되면 어떻게 되나요?
Airparser는 지수 백오프로 실패한 전달을 최대 5회 자동으로 재시도합니다. 웹훅 로그에서 모든 전달 시도를 확인할 수 있습니다.
파서당 여러 웹훅을 가질 수 있나요?
네! 여러 웹훅 URL을 설정하여 추출된 데이터를 동시에 여러 시스템으로 전송하세요.
웹훅 전달에 시간 제한이 있나요?
웹훅 요청은 30초 후에 시간 초과됩니다. 엔드포인트는 빠르게 응답하고 필요한 경우 데이터를 비동기적으로 처리해야 합니다.
어떤 문서가 웹훅을 트리거할지 필터링할 수 있나요?
네! 추출된 데이터 값, 문서 유형 또는 맞춤 기준에 따라 조건부 웹훅을 설정하세요.
웹훅 문제를 디버그해야 한다면 어떻게 하나요?
요청/응답 데이터, 타이밍, 오류 메시지를 보여주는 상세 전달 로그를 확인하세요. 개발 중에는 테스트 기능을 사용하여 샘플 페이로드를 전송하세요.