Gyors kezdés
Ez az útmutató körülbelül 30 perc alatt vezet el a semmitől egy működő integrációig. A végére rendelkezel:
- élő árakkal egy város szállodáira a Partner API-ból,
- egy foglalási linkkel, amely a foglalásokat a te fiókodhoz írja jóvá,
- egy tesztfoglalással és egy webhookkal, amely jelzi, hogy megtörtént.
Minden a staging környezetben történik, ami a tesztkörnyezetünk. Nem kell engedélyt kérned tőlünk, és a későbbi élesítéshez sem szükséges jóváhagyás.
Ez a megfelelő útmutató számodra?
Szekció neve “Ez a megfelelő útmutató számodra?”| Szeretnéd… | Innen indulj |
|---|---|
| Szállodákat megjeleníteni az alkalmazásodban, weboldaladon vagy AI termékedben, és az utazókat foglalásra küldeni, jutalékot keresve | Ez az útmutató |
| Ügyfeleid nevében foglalni, mint engedélyezett utazási iroda | Ez az útmutató 5. lépéséig, majd Foglalás utazási irodaként |
| Foglalható szállodákat beágyazni integráció írása nélkül | Web Components |
| AI ügynököt keresésre és foglalásra használni | MCP Servers és Agentic Payments |
| Csatornakezelőt vagy PMS-t csatlakoztatni | Csatornakezelő hozzáadása |
Hogyan működik
Szekció neve “Hogyan működik”A Partner API segítségével keresed meg a szállodákat és azok élő árait. Minden szállodához tartozik egy stabil urlName. Ezt egy linkké alakítod a Wink Foglalási Motorhoz, a book.wink.travel-hez, amely viszi az azonosítóidat. Az utazó ott foglal és fizet, és a foglalás a te fiókodhoz íródik jóvá.
Mielőtt elkezdenéd
Szekció neve “Mielőtt elkezdenéd”Szükséged lesz:
grpcurl-ra, vagy Postmanre vagy Insomniára. A Partner API gRPC alapú, nem REST.curl-ra.
1. lépés: Hozz létre egy staging fiókot
Szekció neve “1. lépés: Hozz létre egy staging fiókot”A staging teljesen különáll az éles környezettől, saját bejelentkezésekkel és fiókokkal.
-
Látogass el a staging-app.wink.travel oldalra, kattints a
Sign-In / Registergombra, és regisztrálj. -
Kattints a bal oldali menüben az
Accountsmenüpontra, majd aCreategombra, és válaszd az I am an Affiliate opciót. Az általad küldött foglalások ehhez a fiókhoz íródnak jóvá. Lásd Fiók létrehozása.
2. lépés: Hozz létre egy alkalmazást
Szekció neve “2. lépés: Hozz létre egy alkalmazást”Az alkalmazás adja meg a kódodnak a hitelesítő adatokat.
-
A fiók kártyádon kattints az
Actions>Manage accountmenüpontra, majd azApplicationsfülre. -
Kattints a
Create new applicationgombra, adj neki nevet, és válaszd a Machine-to-machine kliens típust. -
A scopes alatt válaszd az Inventory & rates (olvasás) opciót. A Partner API az
inventory.readjogosultságot ellenőrzi. -
Kattints a
Create applicationgombra, majd másold ki a Client ID és Client secret értékeket. A titok egyszer jelenik meg, később nem kérhető le újra.
Lásd az Applications oldalt a többi kliens típus és scope miatt.
3. lépés: Szerezz hozzáférési tokent
Szekció neve “3. lépés: Szerezz hozzáférési tokent”curl -X POST https://staging-iam.wink.travel/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=<YOUR_CLIENT_ID>" \ -d "client_secret=<YOUR_CLIENT_SECRET>" \ -d "scope=inventory.read"Mentsd el a válaszból az access_token értéket:
export WINK_TOKEN=<access_token>A tokenek lejárnak. Saját kódodban használj OAuth2 könyvtárat a lekéréshez és frissítéshez. Lásd Hitelesítés.
Ha a token kérés elutasításra kerül, a válasz egy JSON törzs error kóddal:
error | HTTP státusz | Szokásos ok |
|---|---|---|
invalid_client | 401 | Hibás kliens ID vagy titok, vagy éles hitelesítő adatot használtak a staging-iam-en |
invalid_scope | 400 | A kérés olyan scope-ot kér, amelyre az alkalmazás nincs regisztrálva |
unauthorized_client | 400 | Az alkalmazás nem jogosult a client_credentials grant használatára |
invalid_request | 400 | Hiányzó kötelező paraméter, például ha a törzs JSON helyett formátumú |
4. lépés: Találd meg a fiókazonosítódat
Szekció neve “4. lépés: Találd meg a fiókazonosítódat”Minden Partner API hívásban meg kell adni, hogy melyik fiók nevében jársz el a managing-entity-id fejlécben. Listázd ki azokat a fiókokat, amelyekhez a tokened jogosultsággal bír:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsMásold ki az 1. lépésben létrehozott affiliate fiók accountId értékét:
export WINK_ACCOUNT_ID=<accountId>5. lépés: Keresés szállodákra egy városban
Szekció neve “5. lépés: Keresés szállodákra egy városban”A staging tesztszállodákat tartalmaz Bangkokban, ezért a kereséshez annak slugját, a bangkok-thailand-ot használjuk:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -H "managing-entity-id: $WINK_ACCOUNT_ID" \ -d '{ "urlName": "bangkok-thailand", "userSession": { "itinerary": { "startDate": "2026-12-01", "nights": 2, "room": { "adults": 2 } }, "currencyCode": "USD", "languageCode": "en" } }' \ staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCityHasználj jövőbeli bejelentkezési dátumot; a múltbeli dátumot elutasítja a rendszer. Minden találat tartalmazza:
name,starRatingésheroImageUrl, ami elegendő egy találati sor megjelenítéséhez,roomTypes, az élő ajánlatokat, a legolcsóbb szoba az első,urlName, a slug, amire szükséged van a foglalási linkhez.
Az árak egész számok kisebb egységekben: oszd el tíz a currencyExponent hatványával a válaszból (USD esetén 2, tehát a 12500 125,00 USD).
Nem ismered egy város slugját? Keresd meg a wink.partner.v1.Lookup/Search segítségével. Egy ingatlan teljes tartalmához használd a Content szolgáltatást. A Partner API referencia dokumentál minden hívást.
6. lépés: Építsd meg a foglalási linket
Szekció neve “6. lépés: Építsd meg a foglalási linket”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>a szállodaurlNameértéke az 5. lépésből.client-idaz alkalmazásod Client ID-ja a 2. lépésből.configuration-ida testreszabási azonosítód:Manage account>Customizations. Egy testreszabás beállítja a brandinget, az alapértelmezett nyelvet és valutát a foglalási oldalon.
Add át az utazó keresési adatait
Szekció neve “Add át az utazó keresési adatait”Add hozzá az utazó dátumait, vendégeit, nyelvét és valutáját ugyanahhoz a linkhez, hogy a szálloda oldal ezekkel kitöltve nyíljon meg:
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD| Paraméter | Jelentése | Példa |
|---|---|---|
sd | Bejelentkezési dátum | sd=2027-03-14 |
n vagy ed | Éjszakák száma vagy kijelentkezési dátum | n=2 vagy ed=2027-03-16 |
rc | Vendégek száma szobánként | rc=a2 (2 felnőtt) |
l | Megjelenítési nyelv | l=en |
c | Megjelenítési valuta | c=USD |
p | Promóciós kód | p=ABC123 |
Ezek a paraméterek felülírják a testreszabásban beállított alapértelmezett értékeket. A Foglalás most gomb útmutató részletezi az rc formátumot, beleértve a gyerekeket és több szobát is.
A link megnyitja a szálloda oldalát; nem tud előre kiválasztani szobát vagy árat. Az utazó a szálloda oldalon választja ki a szobát az élő áron.
Lásd a Közvetlen linkelés részt, ha a foglalási motor kezdőlapjára szeretnél linkelni egyetlen szálloda helyett.
7. lépés: Készíts egy tesztfoglalást
Szekció neve “7. lépés: Készíts egy tesztfoglalást”Nyisd meg a linkedet, válassz dátumokat és szobát, majd fizess egy Stripe tesztkártyával, például 4242 4242 4242 4242 bármilyen jövőbeli lejárati dátummal és bármilyen CVC-vel. A stagingben nem terhelnek valódi kártyát. Jegyezd meg a foglalási kódot a visszaigazoló oldalon; WNK-val kezdődik.
8. lépés: Értesülj a foglalásokról
Szekció neve “8. lépés: Értesülj a foglalásokról”-
A Portalban menj az
Applications > Webhooksmenüpontra, és adj hozzá egy végpontot, amely elfogadPOSTkéréseket. -
Iratkozz fel a
booking.createeseményre, vagy hagyd üresen az eseménylistát, hogy fejlesztés közben mindent megkapj. -
Küldj magadnak egy teszt eseményt, majd készíts egy újabb tesztfoglalást, és figyeld, hogy megérkezik-e.
Minden kézbesítés aláírását ellenőrizd, mielőtt megbízol benne. Lásd a Webhook integráció és a Webhook események katalógusa.
9. lépés: Menj élesbe
Szekció neve “9. lépés: Menj élesbe”Fejlesztőknek nincs jóváhagyási lépés. (Az utazási iroda fiókokat előzetesen tanúsítják; lásd lentebb a Foglalás utazási irodaként részt.) Ha az integrációd működik stagingben:
-
Hozz létre egy fiókot és egy alkalmazást az app.wink.travel oldalon, ahogy az 1. és 2. lépésben. A hitelesítő adatok nem vihetők át a környezetek között.
-
Távolítsd el a
staging-előtagot minden hosztnév elől:Staging Éles https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Keresd meg újra az éles fiókazonosítódat (4. lépés) és testreszabási azonosítódat (6. lépés). Ezek eltérnek a stagingtől.
A Partner API használata hotel-éjszakákban mérhető, havi ingyenes kerettel. Lásd a Partner API oldalt az árakról és korlátokról.
Foglalás utazási irodaként
Szekció neve “Foglalás utazási irodaként”Ha a fiókod engedélyezett utazási iroda, nem kell az utazókat a book.wink.travel oldalra küldened: közvetlenül létrehozhatsz foglalásokat a wink.partner.v1.Booking/CreateBooking hívással, és kezelheted őket a többi Booking hívással. Más fiókok az utazókat a foglalási linkre küldik.
Az utazási iroda fiókokat tanúsítják: a Wink minden iroda regisztrációját ellenőrzi, mielőtt foglalhatna. Azok az irodák, amelyek maguk szeretnék beszedni az ügyfelektől a fizetést, mint kereskedő, a Partner API-n keresztül kell foglaljanak, és írásos jóváhagyást kell kapjanak a Wink-től. Lásd a Utazási irodaként kezdés és a Partner API referencia oldalakat.
Következő lépések
Szekció neve “Következő lépések”- Generálj típusos klienst a
.protoséma alapján a kézigrpcurlhívások helyett. - Csatlakoztasd az MCP szervert és használd az AI Skills funkciókat, hogy a kódoló asszisztensed megírja az integrációt az élő API ellen.
- Olvasd el a teljes listát az környezetekről és hosztokról.
