Sari la conținut

Pornire rapidă

Acest ghid te duce de la nimic la o integrare funcțională în aproximativ 30 de minute. La final vei avea:

  • prețuri live pentru hoteluri într-un oraș, din Partner API,
  • un link de rezervare care creditează rezervările în contul tău,
  • o rezervare de test și un webhook care te anunță că s-a întâmplat.

Totul se întâmplă în staging, mediul nostru de testare. Nu trebuie să ne ceri acces, iar trecerea la producție mai târziu nu necesită aprobare.

Vrei să…Începe aici
Afișezi hoteluri în aplicația, site-ul sau produsul tău AI și trimiți călătorii să rezerve, câștigând comisionAcest ghid
Rezervezi în numele clienților tăi ca agenție de turism autorizatăAcest ghid până la Pasul 5, apoi Rezervarea ca agenție de turism
Integrezi hoteluri rezervabile fără să scrii codWeb Components
Lași un agent AI să caute și să rezerveMCP Servers și Agentic Payments
Conectezi un channel manager sau PMSAdaugă Channel Manager-ul tău

Folosești Partner API pentru a găsi hoteluri și prețurile lor live. Fiecare hotel are un urlName stabil. Îl transformi într-un link către Wink Booking Engine, book.wink.travel, care poartă ID-urile tale. Călătorul rezervă și plătește acolo, iar rezervarea este creditată în contul tău.

Ai nevoie de:

  • grpcurl, sau Postman sau Insomnia. Partner API este gRPC, nu REST.
  • curl.

Staging este complet separat de producție, cu logări și conturi proprii.

  1. Accesează staging-app.wink.travel, apasă Sign-In / Register și înregistrează-te.

  2. Apasă Accounts în bara laterală din stânga, apoi Create, și alege I am an Affiliate. Rezervările pe care le trimiți sunt creditate acestui cont. Vezi Create Account.

Aplicația oferă codului tău acreditările necesare.

  1. Pe cardul contului tău, apasă Actions > Manage account, apoi fila Applications.

  2. Apasă Create new application, dă-i un nume și alege Machine-to-machine ca tip client.

  3. La scopes, selectează Inventory & rates (read). Partner API verifică pentru inventory.read.

  4. Apasă Create application și copiază Client ID și Client secret. Secretul este afișat o singură dată și nu poate fi recuperat ulterior.

Vezi Applications pentru celelalte tipuri de client și scopes.

Terminal window
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"

Salvează access_token din răspuns:

Terminal window
export WINK_TOKEN=<access_token>

Tokenurile expiră. În codul tău, lasă o bibliotecă OAuth2 să le obțină și să le reîmprospăteze. Vezi Authentication.

Dacă cererea de token este respinsă, răspunsul este un corp JSON cu un cod error:

errorStatus HTTPCauza obișnuită
invalid_client401Client ID sau secret greșit, sau acreditări de producție folosite pe staging-iam
invalid_scope400Cererea solicită un scope pentru care aplicația nu este înregistrată
unauthorized_client400Aplicația nu are permisiunea să folosească grantul client_credentials
invalid_request400Lipsește un parametru obligatoriu, de exemplu când corpul este JSON în loc de formular

Fiecare apel Partner API specifică contul pentru care acționezi în header-ul managing-entity-id. Listează conturile pentru care tokenul tău poate acționa:

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

Copiază accountId al contului afiliat din Pasul 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging are hoteluri de test cu disponibilitate în Bangkok, așa că această căutare folosește slug-ul său, bangkok-thailand:

Terminal window
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

Folosește o dată de check-in în viitor; o dată trecută este respinsă. Fiecare rezultat conține:

  • name, starRating și heroImageUrl, suficiente pentru a afișa un rând de rezultat,
  • roomTypes, ofertele live, cel mai ieftin tip de cameră primul,
  • urlName, slug-ul de care ai nevoie pentru linkul de rezervare.

Prețurile sunt întregi în unități minore: împarte la 10 la puterea currencyExponent din răspuns (2 pentru USD, deci 12500 este $125.00).

Nu știi slug-ul unui oraș? Rezolvă-l cu wink.partner.v1.Lookup/Search. Pentru conținutul complet al unei proprietăți, folosește serviciul Content. Referința Partner API documentează fiecare apel.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> este urlName-ul hotelului din Pasul 5.
  • client-id este Client ID-ul aplicației tale din Pasul 2.
  • configuration-id este ID-ul personalizării tale: Manage account > Customizations. O personalizare setează și brandingul, limba implicită și moneda pe pagina de rezervare.

Adaugă datele, oaspeții, limba și moneda călătorului în același link ca pagina hotelului să se deschidă cu ele completate:

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
ParametruSemnificațieExemplu
sdData check-insd=2027-03-14
n sau edNumăr de nopți sau data check-outn=2 sau ed=2027-03-16
rcOaspeți pe camerărc=a2 (2 adulți)
lLimba afișăriil=en
cMoneda afișăriic=USD
pCod promoționalp=ABC123

Acești parametri suprascriu valorile implicite setate în personalizarea ta. Ghidul Butonului Book Now acoperă formatul complet rc, inclusiv copii și mai multe camere.

Linkul deschide pagina hotelului; nu poate preselecta o cameră sau o tariful. Călătorul alege camera pe pagina hotelului, la prețul live.

Vezi Linking directly pentru a lega direct la pagina principală a motorului de rezervări în loc de un singur hotel.

Deschide linkul tău, alege date și o cameră, și plătește cu un card de test Stripe, de exemplu 4242 4242 4242 4242 cu orice dată de expirare viitoare și orice CVC. Niciun card real nu este taxat în staging. Notează codul rezervării de pe pagina de confirmare; începe cu WNK.

  1. În Portal, mergi la Applications > Webhooks și adaugă un endpoint care acceptă cereri POST.

  2. Abonează-te la booking.create, sau lasă lista de evenimente goală pentru a primi totul în timpul dezvoltării.

  3. Trimite-ți un eveniment de test, apoi fă o altă rezervare de test și urmărește cum sosește.

Verifică semnătura fiecărei livrări înainte să ai încredere în ea. Vezi Webhook Integration și Catalogul de evenimente Webhook.

Nu există pas de aprobare pentru dezvoltatori. (Conturile de agenție de turism sunt certificate mai întâi; vezi mai jos.) Când integrarea ta funcționează în staging:

  1. Creează un cont și o aplicație la app.wink.travel, ca în Pașii 1 și 2. Acreditările nu se transferă între medii.

  2. Elimină staging- din fiecare host:

    StagingProducție
    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. Caută din nou ID-ul contului de producție (Pasul 4) și ID-ul personalizării (Pasul 6). Sunt diferite față de staging.

Utilizarea Partner API este măsurată în nopți-hotel, cu o alocație lunară gratuită. Vezi Partner API pentru prețuri și limite.

Dacă contul tău este o agenție de turism autorizată, nu trebuie să trimiți călătorii către book.wink.travel: poți crea rezervări direct cu wink.partner.v1.Booking/CreateBooking și să le gestionezi cu celelalte apeluri Booking. Alte conturi trimit călătorii către linkul de rezervare.

Conturile de agenție de turism sunt certificate: Wink verifică înregistrarea fiecărei agenții înainte să poată rezerva. Agențiile care doresc să colecteze plata direct de la clienți, ca merchant of record, trebuie să rezerve prin Partner API și să obțină aprobarea scrisă a Wink. Vezi Început ca agenție de turism și referința Partner API.