Sari la conținut
Academy

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 contul tău de utilizator pe Wink
  2. Creează un cont de agent de turism sau un cont de afiliat.
  3. Creează o Aplicație unde o asociezi cu contul creat la Pasul 2.
  4. După ce ai creat Aplicația, salvează client-id și client secret într-un loc sigur.

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. Dă click 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 selectează 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 obține 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.