REST API 연동

할 수 있는 일

동영상을 저장소로 바로 업로드해요. 큰 파일은 16 MB 단위로 이어 올리기 업로드를 사용해요.
파일 링크로 동영상을 가져와요.
직접 작성한 코드에서 라이브러리와 웹훅을 읽고 관리해요.
분석 데이터를 대시보드, 스프레드시트, 데이터 웨어하우스로 가져와요(아래 분석 참고).
각 키에 필요한 권한만 주세요. Read only, Read & write videos, Admin 중에서 고를 수 있어요.

Read only를 포함한 모든 키로 분석 데이터를 읽을 수 있어요. 기간은 days(오늘을 포함한 최근 N일) 또는 from과 to 날짜(YYYY-MM-DD, 양 끝 포함)로 지정해요.

GET /v1/stats: 워크스페이스, 폴더, 태그별 합계, 일별 재생 수, 모든 동영상, 인기 페이지, UTM 캠페인. 스프레드시트용으로는 ?format=csv를 사용하세요.
GET /v1/videos/{id}/stats: 동영상 하나의 시청 지속률, 완료, 국가, 기기
GET /v1/analytics/sessions: 모든 조회를 오래된 순으로 한 번에 최대 1,000개까지. 다음 페이지를 받으려면 next 값을 after로 다시 보내세요. 각 조회에는 시청자(알려진 경우), 시청량, 완료 여부, 국가, 기기, 페이지, UTM 태그, 클릭하거나 제출한 내용이 담겨요.
GET /v1/analytics/viewer?email=…: 한 사람이 시청한 모든 내용을 동영상별로, 모든 세션을 합쳐서 보여 줘요.
POST /v1/analytics/report: 사용자 지정 보고서(Analytics → Reports처럼 그룹 기준과 수치 지정), 그리고 GET /v1/analytics/reports/{id}/run은 팀이 그곳에 저장한 보고서를 실행해요.
GET /v1/analytics/compare?videos=…와 GET /v1/analytics/live: 동영상 비교와 지금 시청 중인 사람

Pellio에서 Settings → Developers로 이동하세요. 소유자 또는 관리자여야 해요.
키를 만드세요. 이름을 붙이고 Access를 선택하세요.
키를 복사하세요. 한 번만 표시되므로 안전한 곳에 보관하세요.
Bearer 토큰으로 보내세요: curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…"
업로드하려면 POST /v1/videos/uploads를 호출하고, 반환된 URL로 파일을 PUT한 다음, POST /v1/videos/{id}/complete를 호출하세요. 처리가 끝나면 video.ready 웹훅으로 알려 줘요.

모든 엔드포인트는 API 레퍼런스에 있고, OpenAPI 문서는 https://api.pellio.io/v1/openapi.json에 있어요.
파일은 최대 20 GB의 동영상 또는 오디오여야 해요. 업로드 URL은 6시간 동안 유효해요.
각 키는 분당 600건의 요청과 분당 30건의 가져오기를 할 수 있어요. 429 응답을 받으면 속도를 늦추고 다시 시도하세요.
키 목록에 각 키의 마지막 사용 시점이 표시돼요. Revoke를 누르면 키가 즉시 폐기돼요.
Standard 요금제 이상이 필요해요.