API 인증하기

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

API Base URLs

환경	Base URL
Demo	https://demo-afs-api.airfob.com/v1/
Production - Europe	https://e-afs-api.airfob.com/v1/
Production - Korea	https://a-afs-api.airfob.com/v1/ (EU가 아닌 모든 고객 전용)

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에서 재사용할 수 있습니다. 항상 최신 토큰을 사용하세요.