Setup

Ta članek vam pokaže, kako se hitro usposobiti kot razvijalec in začeti testirati naše API-je na Winku.

Note

Testiranje bi moralo vedno potekati v našemuvodno okoljeTam je veliko manj podatkov, vendar jih lahko testirate, kolikor želite, ne da bi pri tem posegali v produkcijsko okolje.

Ko boste pripravljeni za objavo, bomo potrdili vaš račun in vašo aplikacijo ter jo lahko zaženete v našem produkcijskem okolju.

Sledite tem korakom:

1. Registracija vaš uporabniški račun na Winku
2. Ustvari račun potovalnega agenta ali partnerski račun.
3. Ustvari aplikacijo kjer ga povežete z računom, ki ste ga ustvarili v 2. koraku.
4. Ko ustvarite svoj Application, shranite ID odjemalca in skrivnost odjemalca na varno mesto.

CDN

Pri Winku za vse naše slikovne in video materiale uporabljamo Cloudinary. Ko dostopate do naše potovalne ponudbe, boste imeli poln dostop do vseh naprednih funkcij Cloudinaryja.

Našecloud_namejetraveliko.

Oblačno

• Začetek
• SDK-ji
• Cloudinary na GitHubu
• Video vadnice

Primer

Za vsako vrsto potovalne opreme, ki jo podpiramo, bo na voljo vgnezdeno polje JSON z imenommultimediasJSON za večpredstavnostni vnos izgleda takole:

{
  "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"
    }
  ]
}

Označena črta zgoraj prikazuje edinstveni ID Cloudinaryja.partners/radisson_blu_logoTo je vse, kar potrebujete za pridobitev slike v poljubni obliki, kakovosti in velikosti, ki jo želite.

Testiranje

Pojdite k našemuAPI-jiin izberite API, s katerim želite delati.

Dokumentacija API-ja

Naše spletno mesto z dokumentacijo je nastavljeno tako, da lahko ukaze API izvajate kar znotraj spletnega mesta.

V tem primeru želite uporabitiSearch Lookups (OAuth2)Klic API-ja.

:::nasvet[Nasvet profesionalca] Za lažjo uporabo priporočamo, da integratorji uporabljajo končne točke, ki jih označimo kotOAuth2Te končne točke vedo, da morajo pričakovati klicatelje API-ja in že vedo, v katerem računu ste, zato vam ni treba določiti …companyIdentifierv vaših URL-jih. :::

1. Uporabite Iskalni API za pridobitev destinacij ali hotelov.
2. V levi navigacijski vrstici kliknite na Authentication.
3. Vnesite svoj ID odjemalca in skrivno kodo odjemalca ter kliknite Get TOKEN gumb.
4. Če so vaše poverilnice veljavne, boste videli, da je bil vaš ključ API uporabljen.
5. Zdaj lahko preizkusite končno točko iskanja.

Vzorčna iskanja (OAuth2)

Poštar

Enako lahko storite s Postmanom.

1. Prenesi Poštar.
2. Kliknite na Download OpenAPI spec z vrha Iskalni API stran.
3. Uvozi ga v Postman.
4. Če ste ga uvozili kot novo zbirko z imenom Wink API, kliknite na vodoravno elipso (3 pike) poleg imena zbirke in kliknite Edit.
5. V Authorization tab, nastavite Auth type v OAuth2.
6. Nastavi polje Add auth data to do Request headers.
7. Nastavi polje Header prefix do Bearer.
8. Nastavi polje Token Name poljubno ime shranjenega žetona v Postmanu. Npr. Wink Staging.
9. Nastavi polje Grant type do Client Credentials.
10. Nastavi polje Access token URL na https://staging-iam.wink.travel/oauth2/token.
11. Nastavi polje Client ID na ID stranke, ki ga je vaša aplikacija pomagala ustvariti.
12. Nastavi polje Client Secret do skrivnosti odjemalca, ki jo je vaša aplikacija pomagala ustvariti.
13. Nastavi polje Scope do inventory.read inventory.write inventory.removeTo so vsi daljnogledi, ki jih boste potrebovali za Wink.
14. Nastavi polje Client Authentication do Send as Basic Auth header.
15. Kliknite na Get New Access Token gumb za pridobitev žetona in njegovo shranjevanje.
16. Za vse klice API-ja v zbirki Wink API se prepričajte, da je na zavihku za preverjanje pristnosti navedeno Inherit auth from parent zato pri vsakem klicu vključi vaš žeton.

:::nasvet[Nasvet profesionalca] Priporočljivo je, da domeno strežnika, ID odjemalca in skrivno vrednost odjemalca spremenite v okoljske spremenljivke. Tako lahko preprosto preklapljate med preizkusnim in produkcijskim okoljem ter ponovno uporabite vse ustvarjene operacije. :::