Autentisering
En applikasjon gir deg en Client ID og Secret Key som du trenger for å opprette en autentisert OAuth2-økt du kan bruke til å kommunisere med Wink og TripPay API-er.
Her er stegene for å opprette en autentisert økt.
Steg 1. Hent et tilgangstoken på staging eller i vårt produksjonsmiljø:
Du vil mest sannsynlig bruke et robust OAuth2-bibliotek for ditt språk, som gjør alt det tunge arbeidet for deg.
Våre eksempler viser den mest grunnleggende bruken fra kommandolinjen med curl.
Staging
Section titled “Staging”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_SECRET_KEY>"Produksjon
Section titled “Produksjon”curl -X POST https://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_SECRET_KEY>"Dette vil returnere et tilgangstoken, sammen med annen OAuth2-responsdata:
{ "access_token": "abc123"}Når du gjør et kall til noen av våre endepunkter, inkluder følgende i headeren:
Wink-Version=2.0Nyeste - Se våre API-dokumenter for andre tilgjengelige versjoner.Authorization=Bearer ${access_token}Sett inn ditt tilgangstoken.
Scopes
Section titled “Scopes”En scope er en tillatelse som tilgangstokenet ditt bærer. Når du ber om et token, sender du en
mellomromsseparert liste over scopes i scope-parameteren, og tokenet kan kun nå områdene
disse scopes dekker. Med client_credentials-grant setter du scopes på token-forespørselen —
se curl-eksemplene over og Postman-gjennomgangen.
Scopes er navngitt section.action, hvor handlingen er en av:
read— se ressurser (sikreGET-forespørsler)write— opprette og oppdatere ressurser (POST/PUT/PATCH)remove— slette ressurser (DELETE)
Wink grupperer tillatelser etter funksjonelt område. Be kun om de scopes integrasjonen din trenger:
| Scope-gruppe | Scopes | Hva de åpner for | Risiko |
|---|---|---|---|
| Account | account.read account.write account.remove | Håndtering av enheter, teammedlemmer, innstillinger, applikasjoner | Lav–Middels |
| Inventory | inventory.read inventory.write inventory.remove | Eiendommer, romtyper, prisplaner, priser, tillegg, tilgjengelighet, aktiviteter, attraksjoner | Lav–Middels |
| Booking | booking.read booking.write booking.remove | Søke, se, opprette, kansellere og refundere bookinger; utsjekk; avbestillingsregler | Lav–Middels |
| Marketing | marketing.read marketing.write marketing.remove | Kampanjer, fordeler, salgskanaler, Link manager, administrert sosiale medier, lojalitet | Lav–Middels |
| Content | content.read content.write content.remove | Eiendomsbeskrivelser, anmeldelser, media, kart, grønn-indeks | Lav–Middels |
| Analytics | analytics.read analytics.write analytics.remove | Rapportering og analyse — inntekter, topplister | Lav–Middels |
| Integrations | integrations.read integrations.write integrations.remove | Channel managers, eksterne bookingsystemer, Google Hotel, varslingsendepunkter, booking-synkronisering | Lav–Middels |
| Payment | payment.read payment.write payment.remove | Betalingsbehandling, Stripe, Revolut, utbetalinger, abonnementer | Middels–Høy |
| Accounting | accounting.read accounting.write accounting.remove | Regnskap, uttaksbokføring, avstemming | Middels–Høy |
| MCP | mcp.read mcp.write mcp.remove | Åpner MCP transport (/mcp) for AI-agenter | Lav–Middels |
Noen ting å huske på:
- Be om minimum. Be kun om de scopes integrasjonen din faktisk bruker — et token utstedt med bredere tilgang enn nødvendig har større skadepotensial hvis det lekkes.
- Ukjente scopes avvises. Å be om en scope applikasjonen din ikke er registrert for, eller en som ikke finnes, feiler ved token-utstedelse.
mcp.*er kun for AI-agent-klienter. Du trenger det for å åpne MCP-transporten; det er ikke nødvendig for vanlige REST API-kall. Se Model Context Protocol.
