Stökkva að meginefni
Wink

Hröð uppsetning

Þessi leiðarvísir tekur þig frá engu að virku samþætti á um það bil 30 mínútum. Í lokin munt þú hafa:

  • lifandi verð fyrir hótel í borg, frá Partner API,
  • bókunartengil sem skráir bókanir á reikninginn þinn,
  • prófunarbókun og webhook sem tilkynnir þér að hún hafi átt sér stað.

Allt fer fram í prófunarumhverfi, okkar prófunarumhverfi. Þú þarft ekki að biðja um aðgang og að færa þig yfir í framleiðslu síðar þarf ekki samþykki.

Er þetta rétti leiðarvísirinn fyrir þig?

Kafli sem heitir „Er þetta rétti leiðarvísirinn fyrir þig?“
Þú vilt…Byrja hér
Sýna hótel í appinu þínu, vef eða AI-vöru og senda ferðalanga til að bóka, og fá þóknunÞessi leiðarvísir
Bóka fyrir hönd viðskiptavina sem löggilt ferðaskrifstofaÞessi leiðarvísir að Skrefi 5, síðan Bókun sem ferðaskrifstofa
Innbyggja bókanleg hótel án þess að skrifa samþættinguVefhlutir
Láta AI-umboð leita og bókaMCP Servers og Agentic Payments
Tengja rásastjóra eða PMSBæta við rásastjóra

Hvernig þetta virkar

Kafli sem heitir „Hvernig þetta virkar“

Þú notar Partner API til að finna hótel og lifandi verð þeirra. Hvert hótel kemur með stöðugan urlName. Þú breytir því í tengil á Wink Booking Engine, book.wink.travel, sem ber með sér þín auðkenni. Ferðalangurinn bókar og greiðir þar, og bókunin er skráð á reikninginn þinn.

Áður en þú byrjar

Kafli sem heitir „Áður en þú byrjar“

Þú þarft:

  • grpcurl, eða Postman eða Insomnia. Partner API er gRPC, ekki REST.
  • curl.

Skref 1: Búðu til prófunarreikning

Kafli sem heitir „Skref 1: Búðu til prófunarreikning“

Prófunarumhverfið er algjörlega aðskilið frá framleiðslu, með eigin innskráningum og reikningum.

  1. Farðu á staging-app.wink.travel, smelltu á Sign-In / Register og skráðu þig.

  2. Smelltu á Accounts í vinstri hliðarstiku, síðan Create, og veldu I am an Affiliate. Bókanir sem þú sendir eru skráðar á þennan reikning. Sjá Create Account.

Skref 2: Búðu til umsókn

Kafli sem heitir „Skref 2: Búðu til umsókn“

Umsóknin gefur kóðanum þínum aðgangsupplýsingar.

  1. Á reikningskortinu þínu, smelltu á Actions > Manage account, síðan flipann Applications.

  2. Smelltu á Create new application, gefðu henni nafn og veldu Machine-to-machine sem viðskiptavinatýpu.

  3. Undir scopes, veldu Inventory & rates (lesa). Partner API athugar fyrir inventory.read.

  4. Smelltu á Create application og afritaðu Client ID og Client secret. Leyndarmálið er sýnt einu sinni og er ekki hægt að nálgast aftur.

Sjá Applications fyrir aðrar viðskiptavinatýpur og scopes.

Skref 3: Fáðu aðgangslykil

Kafli sem heitir „Skref 3: Fáðu aðgangslykil“
Útstöðvargluggi
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"

Vistaðu access_token úr svari:

Útstöðvargluggi
export WINK_TOKEN=<access_token>

Lyklar renna út. Í þínum eigin kóða, láttu OAuth2 bókasafn sækja og endurnýja þá. Sjá Authentication.

Skref 4: Finndu reikningsauðkenni þitt

Kafli sem heitir „Skref 4: Finndu reikningsauðkenni þitt“

Allir Partner API kallar nefna reikninginn sem þú starfar fyrir í managing-entity-id haus. Skráðu reikninga sem lykillinn þinn getur starfað fyrir:

Útstöðvargluggi
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  -d '{}' \
  staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Afritaðu accountId fyrir tengdan reikning úr Skrefi 1:

Útstöðvargluggi
export WINK_ACCOUNT_ID=<accountId>

Skref 5: Leitaðu að hótelum í borg

Kafli sem heitir „Skref 5: Leitaðu að hótelum í borg“
Útstöðvargluggi
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

Notaðu innritunardagsetningu í framtíðinni; fyrri dagsetning er hafnað. Hvert niðurstaða inniheldur:

  • name, starRating og heroImageUrl, nægilegt til að sýna niðurstöðuröð,
  • roomTypes, lifandi tilboð, ódýrasta herbergið fyrst,
  • urlName, slugginn sem þú þarft fyrir bókunartengilinn.

Verð eru heiltölur í minni einingum: deildu með 10 í veldi currencyExponent úr svarinu (2 fyrir USD, svo 12500 er $125,00).

Þekkirðu ekki slugg borgar? Leystu það með wink.partner.v1.Lookup/Search. Fyrir fullan innihald eignar, notaðu Content þjónustuna. Partner API tilvísun skráir alla kalla.

Skref 6: Búðu til bókunartengilinn

Kafli sem heitir „Skref 6: Búðu til bókunartengilinn“
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> er urlName hótelsins úr Skrefi 5.
  • client-id er Client ID umsóknar þinnar úr Skrefi 2.
  • configuration-id er sérsniðna auðkenni þitt: Manage account > Customizations. Sérsniðin stilling setur einnig vörumerki þitt, sjálfgefna tungumál og gjaldmiðil á bókunarsíðunni.

Sjá Beint tenging fyrir tengingu á heimasíðu bókunarvélarinnar í stað eins hótels.

Skref 7: Gerðu prófunarbókun

Kafli sem heitir „Skref 7: Gerðu prófunarbókun“

Opnaðu tengilinn þinn, veldu dagsetningar og herbergi, og greiððu með Stripe prófkorti, til dæmis 4242 4242 4242 4242 með hvaða framtíðar gildistíma og hvaða CVC sem er. Engin raunveruleg kort eru rukkuð í prófunarumhverfi. Skráðu bókunarkóðann á staðfestingarsíðunni; hann byrjar á WNK.

Skref 8: Fáðu tilkynningar um bókanir

Kafli sem heitir „Skref 8: Fáðu tilkynningar um bókanir“

  1. Í Portal, farðu í Applications > Webhooks og bættu við endaþjón sem samþykkir POST beiðnir.

  2. Skráðu þig á booking.create, eða skildu atburðalistann auðan til að fá allt meðan þú þróar.

  3. Sendu þér prófunaratburð, gerðu svo aðra prófunarbókun og fylgstu með að hún berist.

Staðfestu undirskrift hvers afhendingar áður en þú treystir henni. Sjá Webhook Integration og Webhook Events Catalog.

Skref 9: Fara í framleiðslu

Kafli sem heitir „Skref 9: Fara í framleiðslu“

Engin samþykktarferli eru fyrir forritara. (Ferðaskrifstofureikningar eru vottaðir fyrst; sjá hér að neðan.) Þegar samþættingin þín virkar í prófunarumhverfi:

  1. Búðu til reikning og umsókn á app.wink.travel, eins og í Skrefum 1 og 2. Aðgangsupplýsingar flytjast ekki á milli umhverfa.

  2. Fjarlægðu staging- úr öllum hýsingum:

    PrófunarumhverfiFramleiðsla
    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. Finndu framleiðslureikningsauðkenni (Skref 4) og sérsniðna auðkenni (Skref 6) aftur. Þau eru önnur en í prófunarumhverfi.

Notkun Partner API er mæld í hótelnóttum, með mánaðarlega ókeypis kvóta. Sjá Partner API fyrir verðlagningu og takmarkanir.

Bókun sem ferðaskrifstofa

Kafli sem heitir „Bókun sem ferðaskrifstofa“

Ef reikningurinn þinn er löggilt ferðaskrifstofa þarftu ekki að senda ferðalanga á book.wink.travel: þú getur búið til bókanir beint með wink.partner.v1.Booking/CreateBooking og stjórnað þeim með öðrum Booking köllum. Aðrir reikningar senda ferðalanga á bókunartengilinn í staðinn.

Ferðaskrifstofureikningar eru vottaðir: Wink yfirfer skráningu hverrar skrifstofu áður en hún getur bókað. Skrifstofur sem vilja innheimta greiðslu frá viðskiptavinum sínum sjálfar, sem kaupmaður, verða að bóka í gegnum Partner API og fá skriflegt samþykki frá Wink. Sjá Byrja sem ferðaskrifstofa og Partner API tilvísun.

Næstu skref

Kafli sem heitir „Næstu skref“