한국과 일본의 소비자 플랫폼 다수는 공개 API를 제공하지 않습니다. 예약, 배달, 모빌리티, 티켓팅, 결제가 각각 다른 앱과 다른 계약 뒤에 있습니다. APIFuse은 이 서비스들을 하나의 게이트웨이 뒤에서 정규화합니다. 발급받는 것은 하나의 managed key이고, 호출하는 것은 하나의 인터페이스입니다.

구조

모든 요청은 https://api.frism.dev/v1 게이트웨이로 향합니다. 경로의 첫 세그먼트가 서비스를 지정하고, 그 뒤가 그 서비스에서 호출할 API입니다. 서비스별 credential, 세션, 재협상은 APIFuse이 대신 유지합니다.

GET /v1/catch-table/restaurants?area=seongsu HTTP/1.1
Host: api.frism.dev
Authorization: Bearer frism_test_k3xample

어떤 서비스가 열려 있는지는 서비스 카탈로그에서 확인합니다. 각 서비스의 API 레퍼런스는 fixture에서 생성된 OpenAPI 문서이며, 같은 문서를 openapi.json으로 내려받을 수 있습니다.

설계 원칙

• 하나의 key: 서비스마다 계정을 만들지 않습니다. scope로 범위를 좁힙니다.
• 하나의 에러 모델: 서비스 장애와 게이트웨이 에러가 같은 envelope로 돌아옵니다.
• 푸시 우선: 상태 변화는 폴링 대신 webhook으로 받습니다.

다음 단계

빠른 시작에서 sandbox key 발급부터 첫 예약 생성까지 진행합니다. 첫 호출 대상으로는 Search restaurants가 적당합니다.