Getting Started
시작하기
FIDOX 콘솔에 가입하고 첫 번째 API 호출까지 5분 안에 완료하세요.
1. 회원가입
1
fidox.co 접속
우상단 시작하기 버튼을 클릭합니다.
2
정보 입력
이름, 회사명, 이메일, 비밀번호를 입력합니다. 이메일 중복 확인 후 약관에 동의하고 가입하기를 클릭합니다. 첫 번째 채널은 자동으로 생성되며, 채널 이름·코드는 가입 후 콘솔에서 추가/관리할 수 있습니다.
3
가입 완료 → 인증 메일 확인
가입 후 입력한 이메일로 인증 메일이 발송됩니다. 메일의 인증 링크를 클릭해 인증을 완료하세요. 인증 전에도 로그인·API 사용은 가능하지만, 대시보드에 인증 안내 배너가 표시됩니다.
무료 플랜은 신용카드 없이도 바로 사용할 수 있습니다. 월 API 호출 100건까지 무료입니다.
2. 채널 확인
가입 시 첫 번째 채널이 자동 생성됩니다(채널 이름: 기본 채널, 코드는 자동 부여). 대시보드 좌측 채널 목록에서 확인하고, 추가 채널이 필요하면 채널 관리 화면의 새 채널 버튼으로 생성합니다.
채널은 API를 운영하는 독립 단위입니다. 서비스별·환경별(dev/prod)로 분리해 관리하는 것을 권장합니다.
3. API 키 확인
1
채널 선택 → 사이드바의 'API 키' 메뉴 클릭
채널 생성 시 자동으로 발급된
ak_ (Access Key)와 sk_ (Secret Key) 한 쌍을 확인할 수 있습니다.2
Secret Key는 '키 갱신' 시에만 전체 값을 확인할 수 있습니다.
가입 직후에는 콘솔에서 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이 포함되면 정상입니다.