문서
ApiCook SDK로 공개 API를 호출하고 응답을 가공하는 방법을 정리했습니다. 처음이라면 ApiCook이란부터 읽는 것을 권합니다.
시작하기
ApiCook이 무엇을 해결하는지, 첫 호출까지 어떻게 가는지.
SDK
@apicook/sdk의 설치·호출·인증·에러 처리.
- 설치와 초기화SDK 설치와 ApiCook 생성자 옵션 전체를, 각 옵션을 언제 써야 하는지와 함께 설명합니다.
- 엔드포인트 호출fetch()로 데이터를 가져오는 방법과 파라미터·요청 본문·반환 타입을 다룹니다.
- 인증 파라미터 관리공개 API의 서비스 키를 setAuth()로 한 번만 설정하고 안전하게 관리하는 방법.
- direct 모드와 proxy 모드CORS 때문에 브라우저에서 API 호출이 막히는 이유와, SDK가 두 모드를 어떻게 자동 선택하는지.
- 에러 처리ApiCookError와 TransformError를 구분해 처리하는 방법과 각 에러의 실제 발생 조건.
데이터 가공
응답을 원하는 모양으로 바꾸는 규칙과 병렬 호출.
운영
런타임 지원 범위, 보안, 문제 해결.