Setup
Acest articol vă arată cum să vă configurați rapid ca dezvoltator și să începeți să testați API-urile noastre pe Wink.
:::notă Testarea ar trebui să aibă loc întotdeauna înmediu de pregătireExistă mult mai puține date acolo, dar ești liber să testezi cât dorești fără a impune impactul asupra mediului de producție.
Odată ce sunteți gata să lansați, vă vom certifica contul și aplicația, iar dvs. o puteți face în mediul nostru de producție. :::
Urmați acești pași:
- Registru contul tău de utilizator pe Wink
- Creați un cont de agent de turism sau un cont afiliat.
- Creați o aplicație unde îl asociați cu contul pe care l-ați creat la Pasul 2.
- Odată ce ți-ai creat
Application
, salvați ID-ul clientului și secretul clientului într-un loc sigur.
La Wink, folosim Cloudinary pentru toate imaginile și videoclipurile noastre. Când accesați inventarul nostru de călătorii, veți avea acces complet la toate funcțiile avansate ale Cloudinary.
Nostrucloud_name
estetraveliko
.
Cloudinary
Section titled “Cloudinary”Exemplu
Section titled “Exemplu”Pentru fiecare tip de inventar de călătorii pe care îl acceptăm, va exista o matrice JSON imbricată numitămultimedias
Fișierul JSON 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 Cloudinarypartners/radisson_blu_logo
Asta este tot ce ai nevoie pentru a recupera imaginea în orice format, calitate și dimensiune dorești.
Testare
Section titled “Testare”Mergeți la noiAPI-urisecțiune și alegeți API-ul cu care doriți să lucrați.
Documentație API
Section titled “Documentație API”Site-ul nostru de documentație este configurat astfel încât să puteți rula comenzi API din interiorul site-ului.
În acest exemplu, doriți să utilizațiSearch Lookups (OAuth2)
Apel API.
:::tip[Sfat profesionist]
Pentru ușurință în utilizare, recomandăm integratorilor să utilizeze punctele finale pe care le desemnăm caOAuth2
Aceste endpoint-uri știu să se aștepte la apelanți API și știu deja în ce cont te afli, deci nu trebuie să specificicompanyIdentifier
în adresele URL.
:::
- Folosește API-ul de căutare pentru a recupera destinații sau hoteluri.
- În bara de navigare din stânga, faceți clic pe
Authentication
. - Introduceți ID-ul clientului și secretul clientului și faceți clic pe
Get TOKEN
buton. - Dacă acreditările tale sunt valide, vei vedea că cheia API a fost aplicată.
- Acum puteți testa punctul final de căutare.
Poştaş
Section titled “Poştaş”Poți face același lucru și cu Poștașul.
- Descărcare Poştaş.
- Faceți clic pe
Download OpenAPI spec
din vârful API-ul de căutare pagină. - Importați-l în Postman.
- Dacă ați importat-o ca o colecție nouă numită
Wink API
, faceți clic pe punctele de suspensie orizontale (3 puncte) de lângă numele colecției și faceți clic peEdit
. - În
Authorization tab
, setațiAuth type
către OAuth2. - Setați câmpul
Add auth data to
laRequest headers
. - Setați câmpul
Header prefix
laBearer
. - Setați câmpul
Token Name
la orice nume doriți să dați token-ului salvat în Postman. De exemplu, Wink Staging. - Setați câmpul
Grant type
laClient Credentials
. - Setați câmpul
Access token URL
către https://staging-iam.wink.travel/oauth2/token. - Setați câmpul
Client ID
la ID-ul de client pe care aplicația dvs. l-a ajutat să îl genereze. - Setați câmpul
Client Secret
la secretul clientului pe care aplicația ta l-a ajutat să-l genereze. - Setați câmpul
Scope
lainventory.read inventory.write inventory.remove
Acestea sunt toate lunetele de care vei avea nevoie pentru Wink. - Setați câmpul
Client Authentication
laSend as Basic Auth header
. - Faceți clic pe
Get New Access Token
pentru a recupera token-ul și a-l salva. - Pentru toate apelurile API din colecția Wink API, asigurați-vă că fila de autentificare spune
Inherit auth from parent
deci include token-ul tău la fiecare apel.
:::tip[Sfat profesionist] Se recomandă transformarea domeniului serverului, ID-ul clientului și secretul clientului în variabile de mediu. În acest fel, puteți comuta cu ușurință între mediile de testare și de producție și puteți reutiliza toate operațiunile pe care le-ați creat. :::