공개 API V1

FareTag 엔진 통합

API를 통해 판정 엔진과 편집 데이터베이스에 접근하세요. 귀사의 운임 데이터를 채점하거나 검증된 조건 데이터베이스를 조회하세요.

인증

모든 요청에는 X-Api-Key 헤더가 필요합니다. 테스트용 데모 키를 사용할 수 있습니다:

X-Api-Key: faretag-demo-key-2026

데모 키: 25 요청/일. 프로덕션 사용의 경우 아래에서 문의해 주세요.

데이터 경계

API는 서드파티 예약 데이터(가격, 가용성, 오퍼)를 절대 노출하지 않습니다. 엔진은 귀사의 데이터를 채점하며, 편집 데이터는 당사의 것입니다.

POST /api/v1/verdict

구조화된 운임 조건을 전송하고 완전한 판정을 받으세요. 외부 네트워크 없음, 서드파티 의존성 없음.

POST /api/v1/verdict

{
  "refund": { "status": "allowed_with_fee", "fee": { "amount": 50, "currency": "EUR" } },
  "change": { "status": "not_allowed" },
  "baggage": { "checked_included": 1, "status": "known" },
  "fare_total": 400
}

응답:

{
  "grade": "C",
  "score": 53,
  "capApplied": null,
  "unknownCount": 0,
  "axes": [
    { "id": "refund", "label": "refundPenalty", "points": 31, "maxPoints": 40 },
    { "id": "change", "label": "changeNone", "points": 0, "maxPoints": 30 },
    { "id": "baggage", "label": "baggageIncluded", "points": 15, "maxPoints": 15 },
    { "id": "data", "label": "dataComplete", "points": 15, "maxPoints": 15 }
  ],
  "engineVersion": "v2"
}

GET /api/v1/editorial/{iata}/{fareBrand}

항공사와 운임 패밀리에 대한 FareTag 편집 정보를 반환합니다. 계산된 판정과 날짜가 기재된 출처 포함.

GET /api/v1/editorial/AF/light

항공사 또는 패밀리가 포함되지 않은 경우 404를 반환합니다.

GET /api/v1/editorial

커버리지 목록: 문서화된 모든 항공사와 패밀리, 마지막 검증 날짜 포함.

GET /api/v1/editorial

임베드 가능한 배지

항공권이 판매되는 모든 곳에 FareTag 등급을 표시하세요. 서버 생성 SVG 배지, 캐시 적용, 항공사 정보와 연결.

<a href="https://faretag.com/compagnies/AF/light">
  <img src="https://faretag.com/api/badge/AF/light.svg"
       alt="Conditions verified by FareTag" />
</a>

오류 코드

코드	HTTP	의미
UNAUTHORIZED	401	API 키 누락 또는 유효하지 않음
FORBIDDEN	403	키 취소됨
NOT_FOUND	404	편집 정보를 찾을 수 없음
RATE_LIMITED	429	일일 할당량 초과

플레이그라운드

데모 키로 엔진을 테스트하세요. 조건을 선택하고 채점을 실행하세요.

환불

변경

수하물

라이선스

150 EUR/월부터. 맞춤형 할당량, 기술 지원, SLA. 사용 사례에 대해 논의하려면 문의해 주세요.

홈으로 돌아가기