Auðkenning
Forrit veitir þér Client ID og Secret Key sem þú þarft til að búa til auðkennda OAuth2 lotu sem þú getur notað til að eiga samskipti við Wink og TripPay API.
Hér eru skrefin til að búa til auðkennda lotu.
Skref 1. Sækja aðgangstákna á staging eða í framleiðsluumhverfi okkar:
Þú munt líklega vinna með öflugt OAuth2 bókasafn fyrir þitt forritunarmál, sem sér um allt flókið fyrir þig.
Dæmin okkar sýna einfaldasta notkun frá skipanalínu með curl.
Staging
Kafli sem heitir „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>"Framleiðsla
Kafli sem heitir „Framleiðsla“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>"Þetta mun skila aðgangstákna ásamt öðrum OAuth2 svörum:
{ "access_token": "abc123"}Þegar þú gerir kall á hvaða endapunkt sem er, innifærðu eftirfarandi í hausnum:
Wink-Version=2.0Nýjasta - Sjáðu API skjöl okkar fyrir aðrar útgáfur.Authorization=Bearer ${access_token}Settu inn aðgangstákna þinn.
Umfang er leyfi sem aðgangstákninn þinn ber með sér. Þegar þú biður um tákna, sendir þú
lista yfir umfang aðskilin með bilum í scope breytunni, og táknið nær aðeins til þeirra svæða
sem þau umfang ná yfir. Með client_credentials heimildinni stillir þú umfangið í beiðni um tákna —
sjáðu curl dæmin hér að ofan og Postman leiðbeiningarnar.
Umfang eru nefnd section.action, þar sem aðgerðin er ein af:
read— skoða auðlindir (öruggirGETfyrirspurnir)write— búa til og uppfæra auðlindir (POST/PUT/PATCH)remove— eyða auðlindum (DELETE)
Wink flokkar leyfi eftir virkni. Biddu aðeins um þau umfang sem samþættingin þín þarf:
| Umfangshópur | Umfang | Hvað þau opna | Áhætta |
|---|---|---|---|
| Reikningur | account.read account.write account.remove | Stjórnun eininga, liðsmanna, stillinga, forrita | Lág–Miðlungs |
| Birgðir | inventory.read inventory.write inventory.remove | Eignir, herbergistegundir, verðáætlanir, verð, aukahlutir, framboð, virkni, aðdráttarafl | Lág–Miðlungs |
| Bókun | booking.read booking.write booking.remove | Leit, skoðun, stofnun, aflýsing og endurgreiðsla bókana; útskráning; aflýsingarstefnur | Lág–Miðlungs |
| Markaðssetning | marketing.read marketing.write marketing.remove | Herferðir, ávinningur, sölurásir, Link stjóri, stjórnað samfélag, tryggðarkerfi | Lág–Miðlungs |
| Innihald | content.read content.write content.remove | Lýsingar eignar, umsagnir, fjölmiðlar, kort, grænn vísir | Lág–Miðlungs |
| Greiningar | analytics.read analytics.write analytics.remove | Skýrslugerð og greiningar — tekjur, stigatöflur | Lág–Miðlungs |
| Samþættingar | integrations.read integrations.write integrations.remove | Rásarstjórar, ytri bókunarkerfi, Google Hotel, tilkynningastöðvar, samstilling bókana | Lág–Miðlungs |
| Greiðsla | payment.read payment.write payment.remove | Greiðslumeðhöndlun, Stripe, Revolut, úttektir, áskriftir | Miðlungs–Há |
| Bókhald | accounting.read accounting.write accounting.remove | Bókhald, úttektarbók, samræming | Miðlungs–Há |
| MCP | mcp.read mcp.write mcp.remove | Opnar MCP flutninginn (/mcp) fyrir AI-umboðsmenn | Lág–Miðlungs |
Nokkur atriði til að hafa í huga:
- Biddu um það minnsta. Biddu aðeins um þau umfang sem samþættingin þín raunverulega notar — tákn með víðtækari aðgang en nauðsynlegt er hefur stærra tjónssvæði ef það leka.
- Óþekkt umfang eru hafnað. Að biðja um umfang sem forritið þitt er ekki skráð fyrir, eða sem ekki er til, bilar við útgáfu tákns.
mcp.*er aðeins fyrir AI-umboðsforrit. Þú þarft það til að opna MCP flutninginn; það er ekki nauðsynlegt fyrir venjuleg REST API köll. Sjá Model Context Protocol.
