Ebben a cikkben
Az ismétlődő közösségi média posztokhoz olyan szabályra van szükség, amely minden ütemezett időpontban kiválasztja a feltételeknek megfelelő tartalmat. Az Uplonicban egy feltöltési ütemezés (upload schedule) egy mappából vagy médiatárbeli videóazonosítók (video ID-k) listájából választ videót. Ez az útmutató az API segítségével hoz létre egy szüneteltetett szabályt, ellenőrzi a következő futási időpontot, módosítja az időzónát és vezérli az aktiválást. Magának a szabálynak a mentése még nem bizonyítja, hogy egy közösségi hálózat ténylegesen megkapta a bejegyzést.
Ha ugyanaz a forrásvideó több hálózatra is kikerül, kezdd az egy videó adaptálása Shortsra, TikTokra és Reelsre útmutatóval. Egy ismétlődő ütemezés nem teszi alkalmassá a nem megfelelő formátumú videót egy másik platform számára.
Mit fogsz elérni, és mire lesz szükséged?
Az eredmény egy elmentett, lekérdezhető ismétlődő szabály, amelyet bármikor szüneteltethetsz vagy aktiválhatsz. Szükséged lesz egy írási jogosultsággal rendelkező munkaterületi API-kulcsra, az API alap URL-jére, az adott munkaterülethez tartozó médiatárbeli videóazonosítókra, valamint egy csatlakoztatott célcsatornára. Az API-kulcsot mindig szerveroldalon vagy megbízható API-kliensben tárold.
Az alábbi példák JSON-kéréstörzsek. Cseréld le a VIDEO_ID és a CHANNEL_ID helyőrzőket a saját munkaterületed azonosítóira, az API-kulcsot pedig küldd el az x-api-key fejlécben. A bemutatott forrásmód a keys, ami explicit videólistát jelent. A mappaválasztás (folder selection) egy külön támogatott működési mód, amelyet itt nem tesztelünk.
Tesztelési hatókör: 2026. október 17-én egy dedikált fejlesztői munkaterületen HTTP-n keresztül futtattuk le a tényleges schedules routert és az API-kulcsos middleware-t. Ellenőriztük a létrehozást, a listázást, az időzóna-módosítást, az aktiválást, a szüneteltetést, a törlést és a hibás bemenetekre adott válaszokat. A teszt nem töltött fel videót közösségi hálózatra, és nem vizsgált vezérlőpult-kattintásokat.
Hozd létre a szabályt szüneteltetett állapotban
Küldj egy POST /schedules kérést az alábbi törzzsel. A heti kifejezés hétfőnként 18:00 órát jelent a megadott időzónában; ez példakonfiguráció, nem pedig a közönség aktivitására vonatkozó ajánlás. A cron szintaxist a node-cron dokumentációja határozza meg (ellenőrizve: 2026. október 17.).
{
"name": "Weekly archive",
"sourceMode": "keys",
"videoIds": ["VIDEO_ID"],
"platforms": ["youtube"],
"channels": ["CHANNEL_ID"],
"cronExpression": "0 18 * * 1",
"timezone": "Europe/Budapest",
"excludeRecentDays": 30,
"isActive": false
}A fejlesztői teszt HTTP 201-es kóddal, egy szabályazonosítóval (rule ID), isActive: false állapottal és egy nem üres nextRunAt mezővel tért vissza. Mentsd el a kapott szabályazonosítót. A 30 napos ismétléskizárási érték (excludeRecentDays) a mi tesztelt példabeállításunk, nem pedig platformkorlát; állítsd be a saját újrahasznosítható tartalomkészleted méretéhez igazítva. Ha a kizárási időablak miatt elfogy a választható videókészlet, az adott futás kimaradhat (skipped run).
Ellenőrizd az időzónát és a következő futást
Küldj egy GET /schedules kérést, és keresd meg a visszaadott azonosítót. Erősítsd meg a forrásazonosítókat, a csatornaazonosítókat, a cron kifejezést, a timezone mezőt és a nextRunAt értékét. A szabály engedélyezése előtt értelmezd az időbélyeget a kiválasztott időzónában. A posztolási ütemterv-generátor segíthet a naptár megtervezésében, de a kimenete önmagában nem hozza létre és nem aktiválja ezt a szabályt.
Az időzóna módosításához küldj PUT /schedules/RULE_ID kérést {"timezone":"UTC"} törzzsel. A fejlesztői ellenőrzésünk során az API újraszámolta a nextRunAt értékét. Az időzóna megváltoztatása megváltoztatja ugyanannak a falióra szerinti kifejezésnek a tényleges jelentését; ez nem csupán megjelenítési beállítás.
A telepített cron-értelmezőt egy napi 18:00 órás szabállyal is megvizsgáltuk Europe/Budapest időzónában. A következő kiszámolt időpontok 2026-10-24T16:00:00.000Z és 2026-10-25T17:00:00.000Z lettek: a helyi óra változatlan maradt, miközben az UTC-megfelelője az óraátállítás miatt módosult. Ezek 2026. október 17-én mért előnézeti eredmények, nem pedig éles kézbesítési megfigyelések. A cron-parser projekt részletesen dokumentálja az időzóna- és nyáriidőszámítás-támogatást.
Aktiváld, szüneteltesd és ellenőrizd az eredményt
A forrás és a célcsatorna ellenőrzése után frissítsd a szabályt a PUT /schedules/RULE_ID végponton {"isActive":true} törzzsel. A szüneteltetéshez küldj {"isActive":false} értéket ugyanerre a végpontra. Az aktiválási tesztünk egy éves kifejezést használt, amelynek következő futása biztonságosan a távoli jövőre esett, majd szüneteltette és törölte a szabályt. Ezzel éles publikálás elindítása nélkül igazoltuk az ütemezett feladat regisztrációját és eltávolítását.
Mindig válaszd szét magát a szabályt és az általa indított munkát: egy szabály sikeres utolsó futása azt jelenti, hogy létrehozott egy publikálási kérést (publishing request). Vizsgáld meg az adott kérés célállomás-eredményeit, mielőtt közzétettnek tekintenéd a posztot. A szabály szüneteltetése megakadályozza a jövőbeli kiválasztásokat, de nem vonja vissza a korábbi futások által már létrehozott publikálási kéréseket.
Az implementáció a szabályok betöltésekor a jövőbeli cron-futásokat regisztrálja; nem tartalmaz visszamenőleges újrajátszó ciklust a leállások alatt kimaradt időpontok pótlására. Ne feltételezd, hogy egy esetleges kiesés után a rendszer automatikusan legyártja az összes elmaradt posztot. Kézi indítás előtt mindig tekintsd át a meglévő kéréseket. Ezeket a működési megfigyeléseket az ütemező (scheduler) forráskódjában ellenőriztük 2026. október 17-én.
Ha a beállítás nem működik
Jelenség | Ellenőrzés | Következő lépés |
|---|---|---|
HTTP 400-as hiba az időzónára | Az érvénytelen időzónás tesztünk a | Használj érvényes IANA-nevet, például |
HTTP 400-as hiba a kifejezésre | A hibás formátumú cron-tesztet még a szabály létrehozása előtt elutasította a rendszer. | Javítsd a cron kifejezést, és tartsd szüneteltetve a szabályt az ellenőrzés idejére. |
A szabály mentve van, de semmi nem jelent meg | Ellenőrizd külön az | A mentett szabály csak a beállítást igazolja. Validáld a forrásmédiát, a csatornakapcsolatot és a kérés eredményét. |
Egy futás kimarad (skipped) | Vizsgáld meg a rögzített okot, és azt, hogy maradt-e választható forrásvideó. | Nézd át a forráskészletet és az ismétléskizárási beállítást, mielőtt újabb kiválasztást kényszerítenél ki. |
Valódi kampány aktiválása előtt vizsgáld meg a forrásfájlokat a videó-specifikáció ellenőrzővel, és erősítsd meg a célcsatorna kapcsolatát. A fenti tesztelt folyamat a szabálykezelést igazolja; az éles publikálási ellenőrzés külön átvételi lépés marad.
Források és módszertan
Ellenőrizve: 2026. október 17. A termékműködés a schedules útvonal és a scheduler implementációjából, valamint a media_api_dev ellen egy dedikált demó-munkaterületen futtatott HTTP-tesztből származik. A tesztrekordokat eltávolítottuk. Éles platformszintű kézbesítést vagy vezérlőpult-munkafolyamatot nem állítunk; a cron-előnézeti kimenetet a telepített függőséggel mértük.
- node-cron: cron kifejezések szintaxisa — ellenőrizve: 2026. október 17.; a példakifejezés alapja.
- node-cron: ütemezési opciók — ellenőrizve: 2026. október 17.; időzóna- és átfedési beállítások, a saját implementációnkkal együtt értelmezve.
- cron-parser: időzóna-támogatás és iteráció — ellenőrizve: 2026. október 17.; az UTC-időbélyegek helyi teszteredmények.
