Ebben a cikkben
Egy link-in-bio oldal elkészítéséhez hozz létre egy oldalt felismerhető névvel és útvonallal (slug), add hozzá a közönséged számára fontos célcímeket, majd az URL megosztása előtt aktiváld és ellenőrizd az oldalt. Ez az útmutató az Uplonic API és a minimal sablon segítségével mutatja be a folyamatot, beleértve a mentett vázlat (draft) és a nyilvánosan elérhető oldal közötti lényeges különbséget.
A link-in-bio szolgáltatás áttekintése bemutatja, milyen szerepet tölt be ez a gyűjtőoldal a publikálási munkafolyamatodban. Az alábbi API-útvonal akkor hasznos, ha saját integrációból szeretnéd létrehozni és karbantartani az oldalt; ez nem egy kattintásról kattintásra haladó vezérlőpult-leírás.
Mielőtt belekezdenél
Szükséged lesz egy írási jogosultsággal rendelkező munkaterületi API-kulcsra, az API alap URL-jére, egy kívánt oldal-útvonalra (slug), valamint a cél-URL-ekre. A kezelési hívásokhoz küldd el a kulcsot az x-api-key fejlécben. A nyilvános olvasási végpont ettől eltér, és nem igényel API-kulcsot.
A teszt egyszerű szöveges linkeket és a minimal sablont használta; nem töltött fel képeket, és nem próbált ki fizetős sablonfunkciókat. Dizájnötletekért böngészd át a link-in-bio sablongalériát, majd más sablon választása előtt ellenőrizd, mely opciók érhetők el a munkaterületeden.
Tesztelési hatókör: 2026. október 17-én egy dedikált demó-munkaterületen, a media_api_dev környezet ellen HTTP-n keresztül futtattuk le a tényleges oldalkezelő és nyilvános oldallekérdező API-útvonalakat. Ellenőriztük a vázlat létrehozását, a linkek hozzáadását, a sorbarendezést, az aktiválást, a láthatóságot és a deaktiválást. Nem publikáltunk éles oldalt, nem teszteltük a hosztolt frontendet, nem kattintottuk végig a galériát, és nem módosítottunk valódi közösségi profilt.
Hozz létre egy vázlat oldalt
Válassz egy olyan egyedi azonosítót (slug), amely egyértelműen jelöli a márkádat, és ellenőrizd a foglaltságát a GET /landing-pages/slug-available?slug=YOUR_SLUG végponttal. A fejlesztői tesztünk igazolta, hogy a demónév a létrehozás előtt szabad volt, utána pedig foglalttá vált. Egy szabadnak jelzett nevet ettől függetlenül lefoglalhat más, mielőtt a létrehozási kérésed befejeződne.
Küldj egy POST /landing-pages kérést az alábbi JSON-törzzsel. Cseréld le a YOUR_UNIQUE_SLUG értéket; a példában szereplő megjelenített név és bemutatkozás (bio) szabadon átírható szöveg.
{
"slug": "YOUR_UNIQUE_SLUG",
"displayName": "Creator demo",
"bio": "Watch, read and get in touch.",
"template": "minimal"
}Mentsd el a visszaadott oldalazonosítót (PAGE_ID). A 2026. október 17-i fejlesztői tesztben ez a hívás HTTP 201-es kódot és status: "draft" állapotot adott vissza. A vázlat hitelesítés nélküli nyilvános lekérdezése HTTP 404-es választ eredményezett. A sikeres létrehozási válasz tehát önmagában nem jelenti azt, hogy az oldal már nyilvánosan elérhető.
A slug-validátor kisbetűket, számjegyeket és kötőjeleket fogad el (betűvel vagy számjeggyel kezdődően), és elutasítja a fenntartott neveket. A tesztünk megkísérelte átnevezni az oldalt admin névre, amire validációs hibát kapott. Ezek az Uplonic oldalcímzési szabályai, nem pedig a közösségi hálózatok felhasználónév-szabályai.
Add hozzá a cél-linkeket
Minden egyes célállomáshoz küldj egy POST /landing-pages/PAGE_ID/links kérést. Ez a tesztelt törzs példadomaint használ; a megosztás előtt cseréld le a valódi célcímre.
{
"title": "Watch the latest video",
"url": "https://example.com/video"
}Ugyanígy adj hozzá egy másik linket is, például egy hírlevél-feliratkozási oldalt, és mentsd el minden visszaadott link azonosítóját (LINK_ID). A fejlesztői tesztünk elutasította a javascript: előtagú URL-t, mivel a végpont HTTP vagy HTTPS sémát követel meg. Ez a formátumellenőrzés azonban nem vizsgálja, hogy a céloldal valóban elérhető-e vagy a te tulajdonodban van-e, ezért minden éles célcímet nyiss meg és ellenőrizz saját kezűleg.
Használj olyan gombfeliratokat, amelyek pontosan megnevezik a műveletet vagy a tartalmat. A látogatónak anélkül is meg kell tudnia különböztetni a legújabb videódat, a hírleveledet és a kapcsolatfelvételi űrlapodat, hogy minden gombra rákattintana. Ez szerkesztési jótanács, nem pedig mért konverziós ígéret.
Rendezd sorba, aktiváld és vizsgáld meg az oldalt
Az átrendezéshez küldj egy PUT /landing-pages/PAGE_ID/links/reorder kérést a linkazonosítókat és pozíciókat tartalmazó tömbbel. Figyelj rá, hogy a kéréstörzs közvetlenül egy JSON-tömb, nem pedig egy listát csomagoló objektum.
[
{ "id": "NEWSLETTER_LINK_ID", "position": 0 },
{ "id": "VIDEO_LINK_ID", "position": 1 }
]A fenti pozíciók a 2026. október 17-én tesztelt példaértékek. A módosítás után a nyilvános válaszban a hírlevél-link megelőzte a videólinket. Amikor a linkek készen állnak, küldj egy PATCH /landing-pages/PAGE_ID kérést {"status":"active"} törzzsel.
Ellenőrizd az eredményt a GET /public/landing/YOUR_SLUG végponton API-kulcs küldése nélkül. A fejlesztői tesztben az aktív oldal HTTP 200-as kóddal, a megjelenített névvel és a kért sorrendbe rendezett linkekkel tért vissza. Ugyanez a teszt igazolta, hogy a letiltott (disabled) link nem kerül bele a nyilvános válaszba.
A hosztolt Uplonic-oldal a /landing/YOUR_SLUG útvonalat használja. Ezt a frontend-útvonalat a forráskódban ellenőriztük, de a böngészőben renderelt megjelenése kívül esett ezen az API-teszten. Mielőtt beillesztenéd az éles címet a közösségi profilodba, nyisd meg kijelentkezett állapotban, ellenőrizd mobiltelefonon, és próbálj ki minden gombot. A profilszerkesztés és a webhelylink elhelyezésének jogosultsága az adott közösségi hálózattól függ, így nem része ennek az útmutatónak.
Rejts el egy linket, vagy szüneteltesd a teljes oldalt
Egyetlen link elrejtéséhez küldj PATCH /landing-pages/PAGE_ID/links/LINK_ID kérést {"enabled":false} törzzsel. Ha a teljes oldalt ki szeretnéd venni a nyilvános elérésből, frissítsd az oldalt {"status":"inactive"} értékkel. A 2026. október 17-i tesztünk igazolta, hogy az elrejtett link eltűnt a listából, az inaktív oldal pedig HTTP 404-es választ adott a nyilvános API-n.
Jelenség | Ellenőrzés | Teendő |
|---|---|---|
Az új oldal nem nyilvános | Az állapota valószínűleg még mindig | Állítsd össze a linkeket, aktiváld az oldalt, majd ismételd meg a hitelesítés nélküli olvasást. |
Egy link hiányzik a nyilvános válaszból | Ellenőrizd az | Engedélyezd a kívánt linket, és nézd át a láthatósági időablakot. |
A slugot elutasítja a rendszer | Ellenőrizd a formátumot és a fenntartott neveket. | Válassz érvényes, nem fenntartott slugot; az |
Egy cél-URL-t elutasít a végpont | A végpont HTTP vagy HTTPS sémájú URL-t vár. | Add meg a teljes webcímet, majd ellenőrizd külön a céloldal működését. |
Amint az éles oldal átmegy ezeken az ellenőrzéseken, hangold össze a közzétett tartalmaiddal. Ehhez kapcsolódó munkafolyamatot a publikálási szolgáltatás áttekintése mutat be; önmagában egy link-in-bio oldal aktiválása nem hoz létre közösségi média posztokat.
Források és módszertan
Ellenőrizve: 2026. október 17. Az elsődleges termékforrások az Uplonic landing-oldal kezelő útvonala, a nyilvános landing útvonal és a slug-validátor. A hosztolt webcímet a frontend útvonal-implementációjában ellenőriztük. A HTTP-teszt a minimal sablont, egyszerű szöveges linkeket és egy dedikált fejlesztői munkaterületet használt, majd eltávolította a tesztrekordokat. Képfeltöltést, sablongaléria-folyamatot, böngészős renderelést és közösségi profilszerkesztést nem teszteltünk.
- Uplonic link-in-bio áttekintés — termékkontextus, ellenőrizve: 2026. október 17.; a fenti API-működés az implementációból és a fejlesztői tesztekből származik.
- Uplonic sablongaléria — dizájnreferencia, ellenőrizve: 2026. október 17.; a galériafolyamat kívül esik a tesztelt minimal sablonos API-munkafolyamaton.
