Configurare

Acest articol îți arată cum să te configurezi rapid ca dezvoltator și să începi să testezi API-urile noastre pe Wink.

Urmează acești pași:

Înregistrează-te cu un cont de utilizator pe Wink.
Creează un cont afiliat. Vei avea nevoie de acesta pentru a asocia Aplicația ta. Vezi ce este Studio pentru mai mult context.
Creează o Aplicație și asociază-o cu contul afiliat creat la Pasul 2. Pentru integrări API server-to-server, alege MACHINE_2_MACHINE ca tip client.
După ce ai creat Aplicația, copiază și salvează imediat client-id-ul și cheia secretă — cheia secretă este afișată o singură dată și nu poate fi recuperată ulterior.

CDN

La Wink, folosim Cloudinary pentru toate imaginile și videoclipurile noastre. Când accesezi inventarul nostru de călătorii, vei avea acces complet la toate funcțiile avansate ale Cloudinary.

cloud_name-ul nostru este traveliko.

Cloudinary

Exemplu

Pentru fiecare tip de inventar de călătorii pe care îl susținem, există un array JSON imbricat numit multimedias. JSON-ul pentru o intrare multimedia arată astfel:

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

Linia evidențiată de mai sus arată ID-ul unic Cloudinary partners/radisson_blu_logo. Acesta este tot ce ai nevoie pentru a prelua imaginea în orice format, calitate și dimensiune dorești.

Testare

Accesează secțiunea noastră de API-uri și alege API-ul cu care vrei să lucrezi.

Documentație API

Site-ul nostru de documentație este configurat astfel încât să poți rula comenzi API direct din site.

În acest exemplu, vrei să folosești apelul API Search Lookups (OAuth2).

Folosește Lookup API pentru a prelua destinații sau hoteluri.
În bara de navigare din stânga, dă click pe Authentication.
Introdu client-id-ul și cheia secretă și apasă butonul Get TOKEN.
Dacă datele tale de autentificare sunt valide, vei vedea că cheia API a fost aplicată.
Acum poți testa endpoint-ul lookup.

Endpoint API Lookup — *Exemplu Search Lookups (OAuth2)*

Postman

Poți face același lucru și cu Postman.

Descarcă Postman.
Dă click pe Download OpenAPI spec din partea de sus a paginii Lookup API.
Importă-l în Postman.
Dacă l-ai importat ca o colecție nouă numită Wink API, dă click pe elipsa orizontală (3 puncte) de lângă numele colecției și selectează Edit.
În fila Authorization, setează Auth type la OAuth2.
Setează câmpul Add auth data to la Request headers.
Setează câmpul Header prefix la Bearer.
Setează câmpul Token Name cu orice nume dorești pentru token-ul salvat în Postman, de ex. Wink Staging.
Setează câmpul Grant type la Client Credentials.
Setează câmpul Access token URL la https://staging-iam.wink.travel/oauth2/token.
Setează câmpul Client ID cu Client ID-ul generat de aplicația ta.
Setează câmpul Client Secret cu cheia secretă generată de aplicația ta.
Setează câmpul Scope cu scope-urile separate prin spațiu de care are nevoie integrarea ta (ex. inventory.read inventory.write inventory.remove). Vezi referința scope-urilor pentru lista completă.
Setează câmpul Client Authentication la Send as Basic Auth header.
Apasă butonul Get New Access Token pentru a obține token-ul și salvează-l.
Pentru toate apelurile API din colecția Wink API, asigură-te că fila de autentificare spune Inherit auth from parent pentru a include token-ul la fiecare apel.