API 인증하기

BioStar Air Cloud API는 Bearer 토큰(JWT) 기반 인증을 사용합니다. API를 호출하기 전에 로그인 절차를 통해 토큰을 발급받아야 하며, 모든 요청의 Authorization 헤더에 토큰을 포함해야 합니다.

API Base URLs

환경	Base URL	설명
Demo(TEST)	https://sp-demo-api.airfob.com/v1	애플리케이션 유형을 'Demo'로 등록하면 데모 환경 사이트와 사이트 마스터 계정 정보를 csv 파일로 다운로드할 수 있습니다.
Production (LIVE)	https://sp-api.airfob.com/v1	(자동 라우팅) 클라이언트 지역에 따라 글로벌 또는 EU 서버를 자동 선택합니다.
	https://sp-a-api.airfob.com/v1	(글로벌 전용) 글로벌 서버 환경으로 연결됩니다.
	https://sp-e-api.airfob.com/v1	(EU 전용) EU 서버 환경으로 연결됩니다.

자동 라우팅 환경은 지역 감지에 따라 예상치 못한 라우팅(routing)이 발생할 수 있습니다.

API 로그인 절차

Postman 또는 프로그래밍 방식으로 API 호출을 수행할 수 있습니다.

로그인

• Endpoint: login

• Payload:

  {
    "username": "your_email",
    "password": "your_password"
  }

Bearer 토큰(JWT)을 반환합니다.

계정 정보 조회

• Endpoint: getSelfAccounts

• Authorization: Bearer Token

접근 가능한 사이트 및 계정 목록을 반환합니다.

계정에 로그인

• Endpoint: loginAccount

• Authorization: Bearer Token

특정 사이트 토큰을 반환합니다.

웹 브라우저에서 Bearer 토큰 얻는 방법

Postman 없이 브라우저 개발자 도구를 사용해 Bearer 토큰을 직접 얻을 수 있습니다.

Chrome/Edge (Windows 또는 Mac)

1. 웹 브라우저에서 F12 또는 Ctrl/Cmd + Shift + I를 누르세요.

2. Network 탭으로 이동하세요.

3. 페이지를 새로 고침하세요.

4. API 호출을 검색하세요.

   예, groups, login

5. 목록에서 요청을 클릭하세요.

6. Headers 탭으로 이동하세요.

7. 요청 헤더에서 Authorization: Bearer ...를 찾으세요.

8. 오른쪽 마우스를 클릭하여 토큰을 복사하세요.

Safari (Mac)

1. 개발자 메뉴를 활성화하세요. Safari → Preferences → Advanced → Show Develop menu를 체크하세요.

2. Develop → Show Web Inspector으로 이동하세요.

3. Network 탭으로 이동하세요.

4. 페이지를 새로 고침하세요.

5. API 호출을 필터링하고 검사하세요.

6. 요청 헤더에서 Authorization: Bearer 토큰을 복사하세요.

알아두기

브라우저에서 복사한 Bearer 토큰은 Postman에서 재사용할 수 있습니다. 항상 최신 토큰을 사용하세요.