Setup
Šajā rakstā parādīts, kā ātri kļūt par izstrādātāju un sākt testēt mūsu API platformā Wink.
:::piezīme Testēšanai vienmēr jānotiek mūsuiestudējuma videTur ir daudz mazāk datu, taču jūs varat brīvi testēt tik daudz, cik vēlaties, nepārslogojot ražošanas vidi.
Kad būsiet gatavs sākt darbu tiešsaistē, mēs sertificēsim jūsu kontu un lietojumprogrammu, un jūs varēsiet palaist to mūsu ražošanas vidē. :::
Veiciet šīs darbības:
- Reģistrēties jūsu lietotāja konts vietnē Wink
- Izveidot ceļojumu aģenta konts vai filiāles konts.
- Izveidojiet lietojumprogrammu kur to saistāt ar kontu, ko izveidojāt 2. darbībā.
- Kad esat izveidojis savu
Application
, saglabājiet klienta ID un klienta noslēpumu drošā vietā.
Wink mēs izmantojam Cloudinary visiem mūsu attēlu un video resursiem. Piekļūstot mūsu ceļojumu inventāram, jums būs pilnīga piekļuve visām Cloudinary papildu funkcijām.
Mūsucloud_name
irtraveliko
.
Mākoņainais
Section titled “Mākoņainais”Piemērs
Section titled “Piemērs”Katram mūsu atbalstītajam ceļojumu inventāra veidam būs ligzdots JSON masīvs ar nosaukumumultimedias
Multivides ieraksta JSON fails izskatās šādi:
{ "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" } ]}
Iepriekš iezīmētā rinda parāda Cloudinary unikālo IDpartners/radisson_blu_logo
Tas ir viss, kas jums nepieciešams, lai izgūtu attēlu jebkurā vēlamajā formātā, kvalitātē un izmērā.
Testēšana
Section titled “Testēšana”Dodieties uz mūsuAPIsadaļu un izvēlieties API, ar kuru vēlaties strādāt.
API dokumentācija
Section titled “API dokumentācija”Mūsu dokumentācijas vietne ir izveidota tā, lai jūs varētu palaist API komandas no vietnes iekšienes.
Šajā piemērā vēlaties izmantotSearch Lookups (OAuth2)
API izsaukums.
:::tip[Profesionāls padoms]
Lietošanas ērtībai integratoriem iesakām izmantot galapunktus, ko mēs apzīmējam kāOAuth2
Šie galapunkti zina, ka jāgaida API izsaucēji, un jau zina, kurā kontā jūs atrodaties, tāpēc jums tas nav jānorāda.companyIdentifier
jūsu URL.
:::
- Izmantojiet Meklēšanas API lai izgūtu galamērķus vai viesnīcas.
- Kreisajā navigācijas joslā noklikšķiniet uz
Authentication
. - Ievadiet savu klienta ID un klienta noslēpumu un noklikšķiniet uz
Get TOKEN
poga. - Ja jūsu akreditācijas dati ir derīgi, jūs redzēsiet, ka jūsu API atslēga ir lietota.
- Tagad varat pārbaudīt meklēšanas galapunktu.
Pastnieks
Section titled “Pastnieks”To pašu var izdarīt ar Postman.
- Lejupielādēt Pastnieks.
- Noklikšķiniet uz
Download OpenAPI spec
no augšas Meklēšanas API lapa. - Importējiet to programmā Postman.
- Ja importējāt to kā jaunu kolekciju ar nosaukumu
Wink API
, noklikšķiniet uz horizontālās daudzzīmes (3 punkti) blakus kolekcijas nosaukumam un noklikšķiniet uzEdit
. - Iekšpusē
Authorization tab
, iestatietAuth type
uz OAuth2. - Iestatiet lauku
Add auth data to
uzRequest headers
. - Iestatiet lauku
Header prefix
uzBearer
. - Iestatiet lauku
Token Name
kā vien vēlaties nosaukt savu saglabāto žetonu programmā Postman. Piemēram, Wink Staging. - Iestatiet lauku
Grant type
uzClient Credentials
. - Iestatiet lauku
Access token URL
uz https://staging-iam.wink.travel/oauth2/token. - Iestatiet lauku
Client ID
uz klienta ID, kura ģenerēšanā jūsu lietotne palīdzēja. - Iestatiet lauku
Client Secret
klienta noslēpumam, kuru jūsu lietotne palīdzēja ģenerēt. - Iestatiet lauku
Scope
uzinventory.read inventory.write inventory.remove
Tie ir visi darbības jomas, kas jums būs nepieciešamas Wink. - Iestatiet lauku
Client Authentication
uzSend as Basic Auth header
. - Noklikšķiniet uz
Get New Access Token
pogu, lai izgūtu savu žetonu un saglabātu to. - Visiem API izsaukumiem Wink API kolekcijā pārliecinieties, vai autentifikācijas cilnē ir norādīts
Inherit auth from parent
tāpēc tas iekļauj jūsu žetonu katrā izsaukumā.
:::tip[Profesionāls padoms] Ieteicams servera domēnu, klienta ID un klienta slepeno atslēgu iekļaut vides mainīgajos. Tādā veidā jūs varat viegli pārslēgties starp izstrādes un ražošanas vidi un atkārtoti izmantot visas izveidotās darbības. :::