Sąranka
Šiame straipsnyje parodyta, kaip greitai susikurti kūrėjo paskyrą ir pradėti testuoti mūsų API Wink platformoje.
Atlikite šiuos veiksmus:
- Užsiregistruokite Wink platformoje.
- Sukurkite kelionių agento paskyrą arba partnerio paskyrą.
- Sukurkite programą ir susiekite ją su paskyra, sukurtą 2 žingsnyje.
- Sukūrę
Application, saugiai išsaugokite client-id ir client secret.
Wink platformoje naudojame Cloudinary visiems mūsų vaizdų ir vaizdo įrašų ištekliams. Prisijungę prie mūsų kelionių inventoriaus, turėsite pilną prieigą prie visų Cloudinary pažangių funkcijų.
Mūsų cloud_name yra traveliko.
Cloudinary
Section titled “Cloudinary”Pavyzdys
Section titled “Pavyzdys”Kiekvienam kelionių inventoriaus tipui, kurį palaikome, bus įdėtas JSON masyvas pavadinimu multimedias. Multimedia įrašo JSON atrodo taip:
{ "multimediaIdentifier": "multimedia-1", "identifier": "partners/radisson_blu_logo", "type": "IMAGE", "width": "1024", "height": "768", "category": "1", "descriptions": [ { "name": "Vestibiulis", "description": "Vestibiulio nuotrauka", "language": "en" } ], "lifestyleType": "LIFESTYLE_BUSINESS", "attribution": [ { "url": "https://www.hilton.com", "name": "Hilton" } ]}Pažymėta eilutė rodo Cloudinary unikalų ID partners/radisson_blu_logo. Tai viskas, ko reikia, kad gautumėte vaizdą bet kokiu formatu, kokybe ir dydžiu.
Testavimas
Section titled “Testavimas”Eikite į mūsų API skyrių ir pasirinkite API, su kuria norite dirbti.
API dokumentacija
Section titled “API dokumentacija”Mūsų dokumentacijos svetainė sukurta taip, kad galite vykdyti API užklausas tiesiogiai svetainėje.
Šiame pavyzdyje norite naudoti Search Lookups (OAuth2) API užklausą.
- Naudokite Lookup API, kad gautumėte paskirties vietas arba viešbučius.
- Kairėje naršymo juostoje spustelėkite
Authentication. - Įveskite savo client-id ir client secret ir spustelėkite mygtuką
Get TOKEN. - Jei jūsų kredencialai galioja, pamatysite, kad jūsų API raktas buvo pritaikytas.
- Dabar galite testuoti lookup galinį tašką.
Postman
Section titled “Postman”Tą patį galite atlikti naudodami Postman.
- Atsisiųskite Postman.
- Spustelėkite
Download OpenAPI specviršuje Lookup API puslapyje. - Importuokite jį į Postman.
- Jei importavote kaip naują kolekciją pavadinimu
Wink API, spustelėkite horizontalią elipsę (3 taškai) šalia kolekcijos pavadinimo ir pasirinkiteEdit. - Skiltyje
AuthorizationnustatykiteAuth typeį OAuth2. - Lauke
Add auth data topasirinkiteRequest headers. - Lauke
Header prefixįrašykiteBearer. - Lauke
Token Nameįrašykite norimą pavadinimą savo saugomam tokenui Postman, pvz., Wink Staging. - Lauke
Grant typepasirinkiteClient Credentials. - Lauke
Access token URLįrašykite https://staging-iam.wink.travel/oauth2/token. - Lauke
Client IDįrašykite savo programos sugeneruotą Client ID. - Lauke
Client Secretįrašykite savo programos sugeneruotą Client Secret. - Lauke
Scopeįrašykiteinventory.read inventory.write inventory.remove. Tai visi reikalingi Wink leidimai. - Lauke
Client AuthenticationpasirinkiteSend as Basic Auth header. - Spustelėkite mygtuką
Get New Access Token, kad gautumėte ir išsaugotumėte tokeną. - Visoms API užklausoms Wink API kolekcijoje įsitikinkite, kad autorizacijos skirtelyje yra pasirinkta
Inherit auth from parent, kad tokenas būtų pridėtas prie kiekvienos užklausos.