Getting Started

시작하기

FIDOX 콘솔에 가입하고 첫 번째 API 호출까지 5분 안에 완료하세요.

1. 회원가입

1

fidox.co 접속

우상단 시작하기 버튼을 클릭합니다.
2

정보 입력

이름, 회사명, 채널 코드(영문/숫자/-), 채널 이름, 이메일, 비밀번호를 입력합니다. 채널 코드 중복 확인 후 약관에 동의하고 가입하기를 클릭합니다.
3

가입 완료 → 인증 메일 확인

가입 후 입력한 이메일로 인증 메일이 발송됩니다. 메일의 이메일 인증하기 버튼을 클릭해 인증을 완료하세요. 인증 전에도 로그인·API 사용은 가능하지만, 대시보드에 인증 안내 배너가 표시됩니다.
무료 플랜은 신용카드 없이도 바로 사용할 수 있습니다. 월 API 호출 100건까지 무료입니다.

2. 채널 확인

가입 시 입력한 채널 코드로 첫 번째 채널이 자동 생성됩니다. 대시보드 좌측 채널 목록에서 확인하고, 추가 채널이 필요하면 새 채널 버튼으로 생성합니다.

채널은 API를 운영하는 독립 단위입니다. 서비스별·환경별(dev/prod)로 분리해 관리하는 것을 권장합니다.

3. API 키 발급

1

채널 선택 → 사이드바의 'API 키' 메뉴 클릭

2

API 키 섹션에서 키 생성 클릭

ak_ (Access Key)와 sk_ (Secret Key) 한 쌍이 발급됩니다.
3

Secret Key 복사 후 안전한 곳에 저장

Secret Key는 최초 발급 시에만 전체가 노출됩니다. 이후에는 앞 일부만 표시됩니다.
API 키를 소스 코드에 직접 삽입하지 마세요. 환경변수(FIDOX_ACCESS_KEY, FIDOX_SECRET_KEY)로 관리하세요.

4. 첫 API 호출

채널이 정상적으로 동작하는지 확인합니다.

curl
curl -X POST https://api.fidox.co/v1/auth/client/token \
  -H "Content-Type: application/json" \
  -d '{"accessKey": "ak_...", "secretKey": "sk_..."}'

200 응답에 accessToken이 포함되면 정상입니다.

다음 단계

  • Playground — 코드 없이 콘솔에서 바로 얼굴 등록·인증을 테스트할 수 있습니다. 대시보드 → Playground 메뉴를 이용하세요.
  • 얼굴 등록(register) / 인증(verify)을 시작하려면 API 문서를 참고하세요.
  • 채널 설정, FR 옵션은 FR 설정 가이드를 참고하세요.
  • 팀원을 초대하려면 팀 관리 가이드를 참고하세요.