데이터 팩

선택 규칙, 이름 패턴, 릴리스 이름 검사를 한 설치에서 다른 설치로 복사합니다.

데이터 팩은 데이터만 든 JSON 파일입니다. 코드를 실행하거나, 주소에서 무언가를 가져오거나, 작품을 추가하거나, 사용자를 바꾸거나, 미디어 파일을 건드리거나, 비밀 값을 담을 수 없습니다.

시작하기 전에

• 소유자여야 합니다.
• admin 범위의 API 키가 있어야 합니다. health_read, read, write 키는 거부됩니다.
• 팩 JSON이 있어야 합니다. 받은 팩을 쓰거나, 고급 사용자용 아래의 구조를 보고 직접 작성하세요.

팩 옮기기

모든 경로는 http://your-server:6262에 있습니다.

1. 팩을 POST /api/v1/data-packs/validate로 보내세요. 저장하지 않고 확인만 합니다. "valid": true가 표시됩니다.
2. 같은 JSON을 POST /api/v1/data-packs로 보내세요. 팩이 비활성 상태로 저장됩니다. 아직 바뀌는 것은 없습니다.
3. GET /api/v1/data-packs를 열면 저장된 팩 목록이 나옵니다. GET /api/v1/data-packs/{id}는 팩 하나를 내보냅니다.
4. 규칙마다 pick_rule_id 하나씩, naming_id는 많아야 하나를 붙여 GET /api/v1/data-packs/{id}/preview를 여세요. approval_hash를 받습니다.
5. 같은 선택과 해시를 POST /api/v1/data-packs/{id}/apply로 보내세요. 팩 id와 고른 규칙 id가 표시됩니다.

미리 보기:

GET /api/v1/data-packs/home-cinema/preview?pick_rule_id=balanced-web&naming_id=readable

적용 본문:

{
  "pick_rule_ids": ["balanced-web"],
  "naming_id": "readable",
  "approval_hash": "the hash returned by preview"
}

주의

이름 세트를 적용하면 현재 이름 패턴이 교체됩니다. 이미 있는 파일의 이름은 바뀌지 않습니다.

적용하면 바뀌는 것

• 고른 선택 규칙은 각각 새로 만들어집니다. 어떤 작품에도 지정되지 않습니다.
• 고른 이름 세트는 다음 설정만 교체합니다:
  • 영화 파일과 폴더 패턴.
  • 시리즈 폴더, 시즌 폴더, 스페셜 폴더, 에피소드, 일일 방송, 애니메이션 패턴.
  • 아티스트 폴더, 앨범 폴더, 디스크 폴더, 트랙, 멀티 디스크 트랙 패턴.
  • 콜론과 사용할 수 없는 문자의 처리 방식.
  • 다중 에피소드 표기 방식, 방영일 표기 방식, 절대 번호 자릿수.
• 가져올 때 이름 바꾸기, 폴더 동작, 태그 읽기, 스캔 한도는 팩에 들어가지 않습니다.

문제가 생기면

증상: 적용할 때 미리 보기가 오래되었다고 나옵니다. 원인: 미리 보기 뒤에 팩이나, 이름이 겹치게 될 선택 규칙 이름이나, 교체될 이름 설정이 바뀌었습니다. 아무것도 적용되지 않았습니다. 해결: 미리 보기를 다시 하고 새 해시를 보내세요.

증상: 가져올 때 팩이 이미 있다고 나옵니다. 원인: 팩은 덮어쓰지 않습니다. 해결: 새 팩에 다른 id를 주세요.

증상: 권한 오류가 납니다. 원인: 소유자가 만든 admin 키가 아닙니다. 해결: 소유자로 admin 키를 만들어 사용하세요.

고급 사용자용

한도와 거부 조건

한도	값
format	holyarrs-data-pack
version	1
팩 또는 내보내기 하나의 크기	256 KiB
선택 규칙	32
이름 세트	8
릴리스 이름 검사	256
id	1~64자: 영문 소문자, 숫자, 마침표, 하이픈, 밑줄. 처음과 끝은 문자나 숫자
적용 요청 본문	16 KiB

중복되거나 알 수 없는 필드가 있을 때, 끝난 뒤에 JSON이 더 붙어 있을 때, 알 수 없는 품질 이름이나 특성 이름이 있을 때, 이름 패턴에 잘못된 단어가 있을 때, 버전이 1이 아닐 때, 값이 이 한도를 넘을 때 팩은 거부됩니다. 릴리스 이름 검사는 하나하나 HolyArrs 파서를 거치며, 기대하는 정보가 모두 일치해야 합니다.

팩 구조

필드	담는 것
format, version, id, name	필수 헤더
pick_rules	각각 id, name, kinds, rules(단계, 특성, 크기 한도, 프로토콜, 언어, 순서)를 가집니다
naming	각각 id, name, patterns(위에 나열한 이름 설정)를 가집니다
release_tests	각각 id, name, release_name, hints, expected(종류, 품질, 해상도, 소스, 코덱, 플래그)를 가집니다

경로와 응답

경로	성공	거부
POST /api/v1/data-packs/validate	200, valid와 요약 포함	400 잘못된 팩, 413 너무 큼
POST /api/v1/data-packs	201, 요약 포함, 상태는 inactive	409 id가 이미 있음, 400, 413
GET /api/v1/data-packs	200, data_packs 포함
GET /api/v1/data-packs/{id}	200, 팩 JSON 포함	404
GET /api/v1/data-packs/{id}/preview	200, approval_hash 포함	pick_rule_id와 naming_id 외의 쿼리가 있으면 400, 404
POST /api/v1/data-packs/{id}/apply	200, pack_id, pick_rule_ids, naming_id 포함	409 오래됨, 400, 404

관련 문서

• 메타데이터
• 라이브러리