Stökkva að meginefni

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.

Ú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_SECRET_KEY>"
Útstöðvargluggi
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.0 Ný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 (öruggir GET fyrirspurnir)
  • 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ópurUmfangHvað þau opnaÁhætta
Reikninguraccount.read account.write account.removeStjórnun eininga, liðsmanna, stillinga, forritaLág–Miðlungs
Birgðirinventory.read inventory.write inventory.removeEignir, herbergistegundir, verðáætlanir, verð, aukahlutir, framboð, virkni, aðdráttaraflLág–Miðlungs
Bókunbooking.read booking.write booking.removeLeit, skoðun, stofnun, aflýsing og endurgreiðsla bókana; útskráning; aflýsingarstefnurLág–Miðlungs
Markaðssetningmarketing.read marketing.write marketing.removeHerferðir, ávinningur, sölurásir, Link stjóri, stjórnað samfélag, tryggðarkerfiLág–Miðlungs
Innihaldcontent.read content.write content.removeLýsingar eignar, umsagnir, fjölmiðlar, kort, grænn vísirLág–Miðlungs
Greiningaranalytics.read analytics.write analytics.removeSkýrslugerð og greiningar — tekjur, stigatöflurLág–Miðlungs
Samþættingarintegrations.read integrations.write integrations.removeRásarstjórar, ytri bókunarkerfi, Google Hotel, tilkynningastöðvar, samstilling bókanaLág–Miðlungs
Greiðslapayment.read payment.write payment.removeGreiðslumeðhöndlun, Stripe, Revolut, úttektir, áskriftirMiðlungs–Há
Bókhaldaccounting.read accounting.write accounting.removeBókhald, úttektarbók, samræmingMiðlungs–Há
MCPmcp.read mcp.write mcp.removeOpnar MCP flutninginn (/mcp) fyrir AI-umboðsmennLá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.