Stökkva að meginefni

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.

Þú 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ðsmann leita og bókaMCP Servers og Agentic Payments
Tengja rásastjóra eða PMSBæta við rásastjóra

Þú 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 auðkenni þitt. Ferðalangurinn bókar og greiðir þar, og bókunin er skráð á reikninginn þinn.

Þú þarft:

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

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.

Umsóknin gefur kóðanum þínum auðkenni.

  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 (read). 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 ekki hægt að nálgast það aftur.

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

Ú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>

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

Ef beiðni um tákn er hafnað, er svarið JSON með error kóða:

errorHTTP staðaVenjulegur orsök
invalid_client401Rangt client ID eða leyndarmál, eða framleiðsluauðkenni notuð á staging-iam
invalid_scope400Beiðnin biður um scope sem umsóknin er ekki skráð fyrir
unauthorized_client400Umsóknin má ekki nota client_credentials grant
invalid_request400Nauðsynlegur parameter vantar, t.d. þegar líkami er JSON í stað forms

Allar Partner API köll nefna reikninginn sem þú starfar fyrir í managing-entity-id haus. Skráðu reikninga sem táknið þitt 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 tengda reikninginn úr Skrefi 1:

Útstöðvargluggi
export WINK_ACCOUNT_ID=<accountId>

Prófunarumhverfið hefur prófunarhótel með framboði í Bangkok, svo þessi leit notar slug þeirra, bangkok-thailand:

Ú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; dagsetning í fortíð er hafnað. Hvert niðurstaða inniheldur:

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

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

Veistu ekki slug borgar? Finndu það með wink.partner.v1.Lookup/Search. Fyrir fullan innihald eignar, notaðu Content þjónustuna. Partner API tilvísunin skráir öll köll.

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óknarinnar þinnar úr Skrefi 2.
  • configuration-id er sérsniðna auðkennið þitt: Manage account > Customizations. Sérsnið gerir einnig þér kleift að stilla vörumerki, sjálfgefna tungumál og gjaldmiðil á bókunarsíðunni.

Bættu við dagsetningum, gestum, tungumáli og gjaldmiðli ferðalangs í sama tengil svo hótelsíðan opnist með þeim fylltum inn:

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
BreytaMerkingDæmi
sdInnritunardagsetningsd=2027-03-14
n eða edFjöldi nætur, eða útritunardagsetningn=2 eða ed=2027-03-16
rcGestir á herbergirc=a2 (2 fullorðnir)
lSýningartungumáll=en
cSýningargjaldmiðillc=USD
pKynningarkóðip=ABC123

Þessar breytur ganga fyrir sjálfgefnum stillingum í sérsniðinu þínu. Leiðarvísirinn um Book Now hnappinn fjallar um fulla rc sniðið, þar með talið börn og mörg herbergi.

Tengillinn opnar hótelsíðuna; hann getur ekki valið herbergi eða verð fyrirfram. Ferðalangurinn velur herbergið á hótelsíðunni, á lifandi verði.

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

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

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

  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.

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

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

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ðslur 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.