Skip to content
Wink

REST og gRPC

Wink býður upp á tvær flutningsleiðir. Hvaða leið þú notar fer eftir því hvaða API þú ert að samþætta við.

FlutningsleiðSkemaSkjöl
Flest Wink APIREST yfir HTTPSOpenAPI 3Hvaða hópur undir API í hliðarstikunni
Partner Integrator APIgRPC yfir HTTP/2Protocol BuffersPartner

Búðu til REST viðskiptavin

Section titled “Búðu til REST viðskiptavin”

Hver API hópur birtir OpenAPI 3 skjal. Beindu hvaða OpenAPI framleiðanda sem er að því og þú færð typaðan viðskiptavin á þínu tungumáli.

Terminal window
# Sérhver hópur hefur skilgreiningu til niðurhals á þessari síðu: /api/downloads/<group>.json
curl -o wink-extranet.json https://wink.travel/api/downloads/extranet.json


npx @openapitools/openapi-generator-cli generate \
  -i wink-extranet.json -g typescript-fetch -o ./wink-client

OpenAPI framleiðendur eftir tungumáli

Búðu til gRPC viðskiptavin

Section titled “Búðu til gRPC viðskiptavin”

Partner Integrator API er gRPC. Þú býrð til viðskiptavin úr .proto skemanu, sem Wink birti á tvo vegu:

  • Server reflection — þjónninn lýsir sjálfum sér, svo verkfæri eins og grpcurl, Postman og Insomnia geta fundið skemuna í keyrslu án þess að þurfa að hlaða niður skrám. Reflection krefst sama auðkennislykils og önnur köll.
  • .proto skrárnar, ef þú vilt frekar eiga skemuna og búa til fyrirfram.
Terminal window
# Finndu skemuna frá keyrandi þjón (auðkenndur).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Síðan býrðu til viðskiptavin — hér Go; öll studd tungumál virka á svipaðan hátt.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Köll bera auðkennislykil þinn í authorization metadata hausnum, nákvæmlega eins og REST ber hann í Authorization hausnum. Villur koma sem gRPC stöðukóði í svari í stað HTTP stöðukóða — Partner tilvísunin listar þær stöður sem þú ættir að búast við.

Hröð byrjun með gRPC eftir tungumáli

Hvað er gRPC?

Eða láttu MCP þjóninn skrifa það

Section titled “Eða láttu MCP þjóninn skrifa það”

Ef þú notar AI kóðunaraðstoð er MCP þjónninn okkar hraðasta leiðin. Hann birtir Wink API-in sem verkfæri sem aðstoðarmaðurinn þinn getur kallað á og skilið, svo í stað þess að búa til allan viðskiptavin og finna endapunkta sjálfur, lýsir þú því sem þú ert að byggja og færð samþættingarkóða sniðinn að því.

Settu upp Wink MCP þjóninn

Frekari lesning

Section titled “Frekari lesning”