Sari la conținut
Wink

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:

  1. Înregistrează-te cu un cont de utilizator pe Wink.
  2. Creează un cont afiliat. Vei avea nevoie de acesta pentru a lega Aplicația ta. Vezi ce este Studio pentru mai mult context.
  3. 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.
  4. După ce ai creat Application, copiază și salvează imediat client-id și cheia secretă — cheia secretă este afișată o singură dată și nu poate fi recuperată ulterior.

CDN

Section titled “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 nostru este traveliko.

Cloudinary

Section titled “Cloudinary”

Exemplu

Section titled “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": "Imaginea holului",
      "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

Section titled “Testare”

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

Documentație API

Section titled “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).

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

Postman

Section titled “Postman”

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

  1. Descarcă Postman.
  2. Apasă pe Download OpenAPI spec din partea de sus a paginii Lookup API.
  3. Importă-l în Postman.
  4. 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 apasă Edit.
  5. În fila Authorization, setează Auth type la OAuth2.
  6. Setează câmpul Add auth data to la Request headers.
  7. Setează câmpul Header prefix la Bearer.
  8. Setează câmpul Token Name cu orice nume dorești pentru token-ul salvat în Postman, de ex. Wink Staging.
  9. Setează câmpul Grant type la Client Credentials.
  10. Setează câmpul Access token URL la https://staging-iam.wink.travel/oauth2/token.
  11. Setează câmpul Client ID cu Client ID-ul generat de aplicația ta.
  12. Setează câmpul Client Secret cu Client Secret-ul generat de aplicația ta.
  13. Setează câmpul Scope la inventory.read inventory.write inventory.remove. Acestea sunt toate scope-urile de care ai nevoie pentru Wink.
  14. Setează câmpul Client Authentication la Send as Basic Auth header.
  15. Apasă butonul Get New Access Token pentru a prelua token-ul și salvează-l.
  16. 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.