API 키와 REST API

키는 Settings → Developers(설정 → 개발자)에서 만듭니다(소유자와 관리자만 가능). 키에 이름을 붙이고 Access(접근 권한)를 선택하세요. Read only(뷰어와 같음), Read & write videos(멤버와 같음), Admin 중에서 고를 수 있습니다. 키는 한 번만 표시되므로 안전한 곳에 보관하세요. 키 목록에는 각 키의 접근 권한, 마지막 사용 시점, Revoke 버튼이 표시됩니다.

각 키에는 마지막으로 사용된 시점이 표시됩니다. Revoke를 누르면 키가 즉시 폐기되며, 이 키를 사용하던 모든 것이 바로 작동을 멈춥니다.

키는 Bearer 토큰으로 보내세요.

curl https://api.pellio.io/v1/videos 
  -H "Authorization: Bearer pk_…"

업로드

업로드는 세 단계로 진행됩니다. 업로드를 생성하고, 파일을 보낸 다음, 완료되었다고 Pellio에 알립니다.

1. 업로드를 생성합니다. 응답에는 동영상과 함께 url, method(PUT), headers가 담긴 upload 객체가 포함됩니다. URL은 6시간 동안 유효합니다.

   curl https://api.pellio.io/v1/videos/uploads 
     -H "Authorization: Bearer pk_…" 
     -H "Content-Type: application/json" 
     -d '{"title":"Onboarding","filename":"onboarding.mp4","size":48213377,"type":"video/mp4"}'

2. 제공된 헤더와 함께 PUT으로 upload.url에 파일을 보냅니다. 파일은 저장소로 바로 전송됩니다.
3. POST /v1/videos/{id}/complete를 호출합니다. 이때 처리가 시작되며, 이 단계를 거치지 않으면 처리가 시작되지 않습니다. 처리가 끝나면 video.ready 웹훅으로 알려 줍니다.

파일은 최대 20 GB의 동영상 또는 오디오여야 합니다. 큰 파일은 16 MB 단위의 이어 올리기 업로드를 사용하세요. POST /v1/videos/{id}/multipart를 호출한 다음, /multipart/resume으로 도착한 부분을 확인하고, /multipart/complete를 호출합니다.

링크에서 가져오려면 파일 URL과 함께 POST /v1/videos/import를 호출하세요.

레퍼런스

요청 및 응답 스키마와 대화형 콘솔을 포함한 모든 엔드포인트는 API 레퍼런스에서 확인할 수 있습니다. OpenAPI 문서는 https://api.pellio.io/v1/openapi.json에 있습니다.

요청 한도

각 키는 분당 600건의 요청과 분당 30건의 가져오기를 할 수 있습니다. 429 응답을 받으면 속도를 늦추고 다시 시도하세요.