Přeskočit na obsah

Autentizace

Aplikace vám poskytne Client ID a Secret Key, které potřebujete k vytvoření autentizované OAuth2 relace, kterou můžete použít ke komunikaci s Wink a TripPay API.

Zde jsou kroky k vytvoření autentizované relace.

Krok 1. Získejte přístupový token na stagingu nebo v našem produkčním prostředí:

Pravděpodobně budete pracovat s robustní OAuth2 knihovnou pro váš jazyk, která za vás udělá veškerou těžkou práci. Naše příklady ukazují nejzákladnější použití z příkazové řádky pomocí curl.

Terminál
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>"
Terminál
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>"

Toto vrátí přístupový token spolu s dalšími daty odpovědi OAuth2:

{
"access_token": "abc123"
}

Když voláte některý z našich koncových bodů, zahrňte do hlavičky následující:

  • Wink-Version = 2.0 Nejnovější - Podívejte se do naší dokumentace API pro další dostupné verze.
  • Authorization = Bearer ${access_token} Vložte svůj přístupový token.

Scope je oprávnění, které váš přístupový token nese. Když žádáte o token, předáte v parametru scope seznam scope oddělených mezerami a token může přistupovat pouze k oblastem, které tyto scope pokrývají. U grant typu client_credentials nastavujete scope při žádosti o token — viz příklady curl výše a návod Postman.

Scope jsou pojmenovány jako section.action, kde akce je jedna z:

  • read — prohlížení zdrojů (bezpečné GET požadavky)
  • write — vytváření a aktualizace zdrojů (POST / PUT / PATCH)
  • remove — mazání zdrojů (DELETE)

Wink seskupuje oprávnění podle funkčních oblastí. Žádejte pouze scope, které vaše integrace potřebuje:

Skupina scopeScopeCo odemykajíRiziko
Accountaccount.read account.write account.removeSpráva entit, členů týmu, nastavení, aplikacíNízké–Střední
Inventoryinventory.read inventory.write inventory.removeNemovitosti, typy pokojů, cenové plány, sazby, doplňky, dostupnost, aktivity, atrakceNízké–Střední
Bookingbooking.read booking.write booking.removeVyhledávání, prohlížení, vytváření, rušení a refundace rezervací; checkout; storno podmínkyNízké–Střední
Marketingmarketing.read marketing.write marketing.removeKampaně, výhody, prodejní kanály, správce odkazů, spravované sociální sítě, věrnostní programNízké–Střední
Contentcontent.read content.write content.removePopisy nemovitostí, recenze, média, mapy, zelený indexNízké–Střední
Analyticsanalytics.read analytics.write analytics.removeReporty a analytika — příjmy, žebříčkyNízké–Střední
Integrationsintegrations.read integrations.write integrations.removeChannel manažeři, externí rezervační systémy, Google Hotel, notifikační endpointy, synchronizace rezervacíNízké–Střední
Paymentpayment.read payment.write payment.removeZpracování plateb, Stripe, Revolut, výplaty, předplatnéStřední–Vysoké
Accountingaccounting.read accounting.write accounting.removeÚčetnictví, kniha výběrů, smířeníStřední–Vysoké
MCPmcp.read mcp.write mcp.removeOtevírá MCP transport (/mcp) pro AI agentyNízké–Střední

Několik věcí k zapamatování:

  • Žádejte minimum. Požadujte pouze scope, které vaše integrace skutečně používá — token s širším přístupem než je potřeba má větší dopad při úniku.
  • Neznámé scope jsou odmítnuty. Žádost o scope, pro který vaše aplikace není registrována, nebo který neexistuje, selže při vydávání tokenu.
  • mcp.* je pouze pro AI-agent klienty. Potřebujete ho k otevření MCP transportu; není vyžadován pro běžné REST API volání. Viz Model Context Protocol.