신청 전에 API 전체를 읽어 보세요

Engine 레퍼런스는 공개되어 있습니다. 리소스, 필드, 오류가 예제와 함께 문서화되어 있으며, 어느 것도 양식 뒤에 가려져 있지 않습니다. 호출을 시험해 보고 싶다면 계정을 신청하고 샌드박스 키를 만드세요.

열람
계정 불필요
형식
예제가 포함된 REST 레퍼런스
샌드박스 키
승인된 계정으로

요청부터 시작하세요

API를 이해하는 가장 빠른 방법은 직접 호출해 보는 것입니다. 키가 작동하는지 확인하고, 목록을 조회하고, 릴리스를 만들고, 이벤트를 구독하는 이 네 가지 요청이면 첫 한 시간이 충분합니다.

  • 모든 엔드포인트에 요청과 응답이 함께 표시됩니다
  • 오류는 원인과 해결 방법과 함께 정리되어 있습니다
  • 예제는 작성된 그대로 샌드박스에서 실행됩니다

첫 요청

요청 예시

GET/v1/me

응답

{  "id": "acc_5t1m9",  "name": "Northfield Audio",  "environment": "sandbox"}

리소스별 레퍼런스

릴리스
지역과 날짜를 포함해 릴리스를 만들고, 수정하고, 제출하고, 테이크다운합니다.
트랙과 에셋
트랙을 추가하고, 오디오와 아트워크를 업로드하고, 크레딧, 코드, 분배 비율을 설정합니다.
전송
릴리스를 스토어로 보내고, 대기 중에서 공개 또는 거절까지 각 대상을 추적합니다.
분석
스토어, 지역, 릴리스, 트랙, 일자별로 스트림과 다운로드를 조회합니다.
로열티
정산서 목록을 조회하고, 항목을 읽고, 각 수취인에게 지급할 금액을 확인합니다.
웹훅
엔드포인트를 등록하고, 수신할 이벤트를 선택하고, 발송된 내역을 확인합니다.

샌드박스 기반 빠른 시작

  1. 1

    샌드박스 키 만들기

    계정을 신청하고, 승인되면 계정에서 키를 복사하세요.

  2. 2

    첫 요청 보내기

    Authorization 헤더에 키를 넣어 /v1/me를 호출하면 키가 작동하는지 확인할 수 있습니다.

  3. 3

    테스트 릴리스 만들기

    제목과 아티스트를 지정해 릴리스를 등록한 뒤 트랙을 추가하세요.

  4. 4

    전송 시뮬레이션

    샌드박스에서 전송하고 스토어 없이 상태가 바뀌는 모습을 확인하세요.

헤더 하나면 바로 시작됩니다

인증은 API 키를 베어러 토큰으로 보내는 방식입니다. 핸드셰이크도, 유지해야 하는 세션도 없습니다. 이 코드를 복사해 키를 바꿔 넣고 실행해 보세요.

  • 샌드박스와 운영 환경은 별도의 키를 사용합니다
  • 키는 언제든 폐기할 수 있습니다

내 릴리스 목록 조회

bash
curl https://api.aevorarecords.com/v1/releases \  -H "Authorization: Bearer YOUR_API_KEY"

문서 FAQ

아니요. 레퍼런스는 공개되어 있습니다. 키가 필요할 때만 계정이 필요합니다.

엔드포인트와 응답은 같습니다. 샌드박스 전송은 스토어에 도달하기 전에 멈추며, 샌드박스 데이터는 실제 카탈로그와 분리되어 보관됩니다.

추가 사항은 변경 내역에 기록됩니다. 호환되지 않는 변경은 경로에 새 버전을 붙여 배포하므로, 기준으로 개발한 버전은 그대로 유지됩니다.

먼저 읽고, 그다음 요청해 보세요