API 토큰 및 API 액세스

FirstLook의 외부 API를 사용하면 플레이어 데이터를 기반으로 커스텀 통합을 구축할 수 있습니다. 액세스는 API 토큰으로 인증되며, Settings → Developer 에서 생성할 수 있습니다. 토큰 관리는 조직의 Owner 및 Developer만 할 수 있습니다.

토큰 생성

각 토큰에는 용도를 설명하는 메모와 하나 이상의 범위(scope)가 있습니다. 토큰 값은 생성 시 단 한 번만 표시되므로, 이후에는 다시 확인할 수 없습니다. 안전한 곳에 보관하세요.

범위(Scopes)

• Query players - 필터를 사용해 플레이어를 검색합니다.
• Look up a player - 단일 플레이어를 조회하거나, 없으면 생성합니다.
• Record analytics events - 세션, 카운터, 지속 시간을 전송합니다.
• Surveys - 설문을 목록 조회 및 내보내기합니다.
• Creators - 크리에이터를 검색하고 공개 리더보드를 확인합니다.
• Keys - 키 인벤토리를 조회합니다.
• Entitlements - 플레이어의 자격 권한을 조회하고, 인게임에서 부여된 후 확인(acknowledge) 처리합니다.
• Rewards - 플레이어의 퀘스트 완료 현황을 조회합니다.

API 레퍼런스

전체 엔드포인트 레퍼런스는 Swagger UI에서 확인할 수 있습니다: https://api.firstlook.gg/external/swagger-ui/

MCP

코드 작성 대신 AI 어시스턴트를 연결하고 싶다면, FirstLook은 Claude, ChatGPT와 같은 어시스턴트가 플레이어 데이터에 대화형으로 액세스할 수 있도록 MCP 서버도 제공합니다.

문제 해결

API 호출 시 비활성화된 기능을 언급하는 403 오류가 반환된다면, 문제 해결 항목을 참고하세요.