Setup
Den här artikeln visar hur du snabbt kan komma igång som utvecklare och börja testa våra API:er på Wink.
Tester bör alltid ske i vårstaging-miljöDet finns mycket mindre data där, men du kan testa så mycket du vill utan att det påfrestar produktionsmiljön.
När du är redo att gå live certifierar vi ditt konto och din applikation och du kan lansera den i vår produktionsmiljö.
Följ dessa steg:
- Register ditt användarkonto på Wink
- Skapa en resebyråkonto eller en affiliate-konto.
- Skapa en applikation där du kopplar det till kontot du skapade i steg 2.
- När du har skapat din
Application
, spara klient-ID och klienthemligheten på ett säkert ställe.
På Wink använder vi Cloudinary för alla våra bild- och videoresurser. När du får åtkomst till vårt resematerial har du fullständig tillgång till alla Cloudinarys avancerade funktioner.
Vårcloud_name
ärtraveliko
.
Molnigt
Section titled “Molnigt”Exempel
Section titled “Exempel”För varje reseannonstyp vi stöder kommer det att finnas en kapslad JSON-matris som hetermultimedias
JSON-filen för en multimediapost ser ut så här:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Lobby", "description": "Picture of the lobby", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}
Den markerade raden ovan visar Cloudinarys unika IDpartners/radisson_blu_logo
Det är allt du behöver för att hämta bilden i vilket format, vilken kvalitet och storlek du vill.
Testning
Section titled “Testning”Gå vidare till vårAPI:eroch välj det API du vill arbeta med.
API-dokumentation
Section titled “API-dokumentation”Vår dokumentationssajt är konfigurerad på ett sådant sätt att du kan köra API-kommandon inifrån webbplatsen.
I det här exemplet vill du användaSearch Lookups (OAuth2)
API-anrop.
:::tips[Proffstips]
För enkel användning rekommenderar vi att integratörer använder de slutpunkter vi anger somOAuth2
De slutpunkterna vet att de kan förvänta sig API-anropare och vet redan vilket konto du är på så att du inte behöver angecompanyIdentifier
i dina webbadresser.
:::
- Använd Sök-API för att hämta destinationer eller hotell.
- I den vänstra navigeringsfältet klickar du på
Authentication
. - Ange ditt klient-ID och din klienthemlighet och klicka på
Get TOKEN
knapp. - Om dina inloggningsuppgifter är giltiga ser du att din API-nyckel har tillämpats.
- Nu kan du testa sökslutpunkten.
Brevbärare
Section titled “Brevbärare”Du kan göra samma sak med Postman.
- Ladda ner Brevbärare.
- Klicka på
Download OpenAPI spec
från toppen av Sök-API sida. - Importera den till Postman.
- Om du importerade den som en ny samling som heter
Wink API
, klicka på det horisontella ellipset (3 punkter) bredvid samlingsnamnet och klicka påEdit
. - I
Authorization tab
, ställ inAuth type
till OAuth2. - Ställ in fältet
Add auth data to
tillRequest headers
. - Ställ in fältet
Header prefix
tillBearer
. - Ställ in fältet
Token Name
till vad du än vill döpa din sparade token till i Postman. T.ex. Wink Staging. - Ställ in fältet
Grant type
tillClient Credentials
. - Ställ in fältet
Access token URL
till https://staging-iam.wink.travel/oauth2/token. - Ställ in fältet
Client ID
till det klient-ID som din app hjälpte till att generera. - Ställ in fältet
Client Secret
till klienthemligheten som din app hjälpte till att generera. - Ställ in fältet
Scope
tillinventory.read inventory.write inventory.remove
Det är alla omfång du behöver för Wink. - Ställ in fältet
Client Authentication
tillSend as Basic Auth header
. - Klicka på
Get New Access Token
knappen för att hämta din token och spara den. - För alla API-anrop under Wink API-samlingen, se till att fliken autentisering anger
Inherit auth from parent
så det inkluderar din token med varje samtal.
:::tips[Proffstips] Det rekommenderas att göra serverdomänen, klient-ID:t och klienthemligheten till miljövariabler. På så sätt kan du enkelt växla mellan staging- och produktionsmiljöer och återanvända alla operationer du har skapat. :::