Data packs

Afritaðu valreglurnar þínar, nafnamynstur eða athuganir á nöfnum útgáfa úr einni uppsetningu í aðra.

Data pack er JSON-skrá sem inniheldur aðeins gögn. Hún getur ekki keyrt kóða, sótt vistfang, bætt við titli, breytt notanda, snert miðlaskrár eða borið leyndarmál.

Áður en þú byrjar

• Þú ert eigandi.
• Þú ert með API-lykil með admin umfang. Lyklum með health_read, read eða write er hafnað.
• Þú ert með JSON pakkans. Notaðu pakkann sem þú fékkst, eða skrifaðu einn út frá uppbyggingunni undir Fyrir sérfræðinga.

Færðu pakka

Allar leiðir eru á http://your-server:6262.

1. Sendu pakkann á POST /api/v1/data-packs/validate. Hann athugar án þess að vista. Þú ættir að sjá "valid": true.
2. Sendu sama JSON á POST /api/v1/data-packs. Það vistar pakkann sem óvirkan. Ekkert breytist enn.
3. Opnaðu GET /api/v1/data-packs til að sjá vistaða pakka. GET /api/v1/data-packs/{id} flytur einn út.
4. Opnaðu GET /api/v1/data-packs/{id}/preview með einu pick_rule_id fyrir hverja reglu og í mesta lagi einu naming_id. Þú færð approval_hash.
5. Sendu sama val og hashið á POST /api/v1/data-packs/{id}/apply. Þú ættir að sjá auðkenni pakkans og auðkenni reglnanna sem þú valdir.

Forskoðun:

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

Meginmál apply:

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

Caution

Nafnasett kemur í stað núverandi nafnamynstra þinna. Skrár sem eru til eru ekki endurnefndar.

Hvað það breytir að beita pakka

• Hver valin valregla er búin til sem ný. Hún er ekki tengd neinum titli.
• Valið nafnasett kemur aðeins í stað þessara stillinga:
  • Mynstur fyrir skrár og möppur kvikmynda.
  • Mynstur fyrir þáttamöppu, þáttaraðarmöppu, sérþáttamöppu, þátt, daglega þætti og anime.
  • Mynstur fyrir flytjandamöppu, plötumöppu, diskamöppu, lag og lög á fleiri diskum.
  • Snið fyrir tvípunkta og ólögleg tákn.
  • Stíll fyrir marga þætti í einni skrá, stíll fyrir útsendingardagsetningu og fjöldi stafa í samfelldu númeri.
• Endurnefning við innflutning, hegðun möppu, lestur á tags og takmörk skönnunar eru aldrei í pakka.

Ef það virkar ekki

Einkenni: Apply segir að forskoðunin sé úrelt. Orsök: pakkinn, nafn valreglu sem myndi rekast á, eða nafnastilling sem hún myndi skipta út breyttist eftir forskoðunina. Ekkert var framkvæmt. Lausn: forskoðaðu aftur og sendu nýja hashið.

Einkenni: innflutningur segir að pakkinn sé þegar til. Orsök: pakkar eru aldrei yfirskrifaðir. Lausn: gefðu nýja pakkanum annað auðkenni.

Einkenni: heimildavilla. Orsök: lykillinn er ekki admin-lykill sem eigandi bjó til. Lausn: búðu til admin-lykil sem eigandi og notaðu hann.

Fyrir sérfræðinga

Takmörk og höfnun

Takmörk	Gildi
format	holyarrs-data-pack
version	1
Stærð pakka eða útflutnings	256 KiB
Valreglur	32
Nafnasett	8
Athuganir á nöfnum útgáfa	256
Auðkenni	1 til 64 stafir: lágstafir, tölustafir, punktar, bandstrik, undirstrik. Byrja og enda á staf eða tölustaf
Meginmál apply-beiðni	16 KiB

Pakka er hafnað ef reitir eru tvöfaldir eða óþekktir, aukalegt JSON kemur eftir endann, gæða- eða einkennanöfn eru óþekkt, nafnaorð eru ógild, útgáfa er önnur en 1, eða gildi fara yfir þessi takmörk. Hver athugun á nafni útgáfu fer í gegnum HolyArrs-þáttarann og þarf að passa við allar staðreyndir sem hún býst við.

Uppbygging pakka

Reitur	Inniheldur
format, version, id, name	Nauðsynlegur haus
pick_rules	Hver með id, name, kinds og rules (þrep, einkenni, stærðarmörk, protocol, tungumál, röð)
naming	Hver með id, name og patterns (nafnastillingarnar sem eru taldar upp hér að ofan)
release_tests	Hver með id, name, release_name, hints og expected (kind, quality, resolution, source, codec, flags)

Leiðir og svör

Leið	Tókst	Höfnun
POST /api/v1/data-packs/validate	200 með valid og samantekt	400 ógilt, 413 of stórt
POST /api/v1/data-packs	201 með samantekt, stöðu inactive	409 auðkenni er til, 400, 413
GET /api/v1/data-packs	200 með data_packs
GET /api/v1/data-packs/{id}	200 með JSON pakkans	404
GET /api/v1/data-packs/{id}/preview	200 með approval_hash	400 fyrir allar fyrirspurnir aðrar en pick_rule_id og naming_id, 404
POST /api/v1/data-packs/{id}/apply	200 með pack_id, pick_rule_ids, naming_id	409 úrelt, 400, 404

Tengt efni

• Metadata
• Safn