Tovább a tartalomhoz

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.

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 keresveEz az útmutató
Ügyfeleid nevében foglalni, mint engedélyezett utazási irodaEz 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ülWeb Components
AI ügynököt keresésre és foglalásra használniMCP Servers és Agentic Payments
Csatornakezelőt vagy PMS-t csatlakoztatniCsatornakezelő hozzáadása

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á.

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.

  1. Látogass el a staging-app.wink.travel oldalra, kattints a Sign-In / Register gombra, és regisztrálj.

  2. Kattints a bal oldali menüben az Accounts menüpontra, majd a Create gombra, é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.

  1. A fiók kártyádon kattints az Actions > Manage account menüpontra, majd az Applications fülre.

  2. Kattints a Create new application gombra, adj neki nevet, és válaszd a Machine-to-machine kliens típust.

  3. A scopes alatt válaszd az Inventory & rates (olvasás) opciót. A Partner API az inventory.read jogosultságot ellenőrzi.

  4. Kattints a Create application gombra, 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”
Terminál
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:

Terminál
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:

errorHTTP státuszSzokásos ok
invalid_client401Hibás kliens ID vagy titok, vagy éles hitelesítő adatot használtak a staging-iam-en
invalid_scope400A kérés olyan scope-ot kér, amelyre az alkalmazás nincs regisztrálva
unauthorized_client400Az alkalmazás nem jogosult a client_credentials grant használatára
invalid_request400Hiá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:

Terminál
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Másold ki az 1. lépésben létrehozott affiliate fiók accountId értékét:

Terminál
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:

Terminál
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/SearchByCity

Használj jövőbeli bejelentkezési dátumot; a múltbeli dátumot elutasítja a rendszer. Minden találat tartalmazza:

  • name, starRating és heroImageUrl, 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álloda urlName értéke az 5. lépésből.
  • client-id az alkalmazásod Client ID-ja a 2. lépésből.
  • configuration-id a 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 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éterJelentésePélda
sdBejelentkezési dátumsd=2027-03-14
n vagy edÉjszakák száma vagy kijelentkezési dátumn=2 vagy ed=2027-03-16
rcVendégek száma szobánkéntrc=a2 (2 felnőtt)
lMegjelenítési nyelvl=en
cMegjelenítési valutac=USD
pPromóciós kódp=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”
  1. A Portalban menj az Applications > Webhooks menüpontra, és adj hozzá egy végpontot, amely elfogad POST kéréseket.

  2. Iratkozz fel a booking.create eseményre, vagy hagyd üresen az eseménylistát, hogy fejlesztés közben mindent megkapj.

  3. 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.

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:

  1. 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.

  2. Távolítsd el a staging- előtagot minden hosztnév elől:

    StagingÉles
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. 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.

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.