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þættingu | Vefhlutir |
| Láta AI-umboðsmann leita og bóka | MCP Servers og Agentic Payments |
| Tengja rásastjóra eða PMS | Bæ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 auðkenni þitt. 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.
-
Farðu á staging-app.wink.travel, smelltu á
Sign-In / Registerog skráðu þig. -
Smelltu á
Accountsí vinstri hliðarstiku, síðanCreate, 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 auðkenni.
-
Á reikningskortinu þínu, smelltu á
Actions>Manage account, síðan flipannApplications. -
Smelltu á
Create new application, gefðu henni nafn og veldu Machine-to-machine sem viðskiptavinatýpu. -
Undir scopes, veldu Inventory & rates (read). Partner API athugar fyrir
inventory.read. -
Smelltu á
Create applicationog 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.
Skref 3: Fáðu aðgangstákn
Kafli sem heitir „Skref 3: Fáðu aðgangstákn“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:
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:
error | HTTP staða | Venjulegur orsök |
|---|---|---|
invalid_client | 401 | Rangt client ID eða leyndarmál, eða framleiðsluauðkenni notuð á staging-iam |
invalid_scope | 400 | Beiðnin biður um scope sem umsóknin er ekki skráð fyrir |
unauthorized_client | 400 | Umsóknin má ekki nota client_credentials grant |
invalid_request | 400 | Nauðsynlegur parameter vantar, t.d. þegar líkami er JSON í stað forms |
Skref 4: Finndu reikningsauðkennið þitt
Kafli sem heitir „Skref 4: Finndu reikningsauðkennið þitt“Allar Partner API köll nefna reikninginn sem þú starfar fyrir í managing-entity-id haus. Skráðu reikninga sem táknið þitt getur starfað fyrir:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsAfritaðu accountId fyrir tengda reikninginn úr Skrefi 1:
export WINK_ACCOUNT_ID=<accountId>Skref 5: Leitaðu að hótelum í borg
Kafli sem heitir „Skref 5: Leitaðu að hótelum í borg“Prófunarumhverfið hefur prófunarhótel með framboði í Bangkok, svo þessi leit notar slug þeirra, bangkok-thailand:
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/SearchByCityNotaðu innritunardagsetningu í framtíðinni; dagsetning í fortíð er hafnað. Hvert niðurstaða inniheldur:
name,starRatingogheroImageUrl, 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.
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>erurlNamehótelsins úr Skrefi 5.client-ider Client ID umsóknarinnar þinnar úr Skrefi 2.configuration-ider 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.
Sendu leit ferðalangsins
Kafli sem heitir „Sendu leit ferðalangsins“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| Breyta | Merking | Dæmi |
|---|---|---|
sd | Innritunardagsetning | sd=2027-03-14 |
n eða ed | Fjöldi nætur, eða útritunardagsetning | n=2 eða ed=2027-03-16 |
rc | Gestir á herbergi | rc=a2 (2 fullorðnir) |
l | Sýningartungumál | l=en |
c | Sýningargjaldmiðill | c=USD |
p | Kynningarkóði | p=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.
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ó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.
Skref 8: Fáðu tilkynningar um bókanir
Kafli sem heitir „Skref 8: Fáðu tilkynningar um bókanir“-
Í Portal, farðu í
Applications > Webhooksog bættu við endaþjón sem tekur viðPOSTbeiðnum. -
Skráðu þig á
booking.create, eða skildu atburðalistann auðan til að fá allt meðan þú þróar. -
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:
-
Búðu til reikning og umsókn á app.wink.travel, eins og í Skrefum 1 og 2. Auðkenni flytjast ekki milli umhverfa.
-
Fjarlægðu
staging-úr öllum hýsingum:Prófunarumhverfi Framleiðsla https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
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.
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ð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.
Næstu skref
Kafli sem heitir „Næstu skref“- Búðu til týndan viðskiptavin úr
.protoskema í stað þess að kalla ágrpcurlhandvirkt. - Tengdu MCP þjóninn og notaðu AI Skills til að láta kóðaraðstoðarmann skrifa samþættinguna við lifandi API.
- Lestu fulla lista yfir umhverfi og hýsingar.
