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 sem er 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. Beinistu að því með hvaða OpenAPI framleiðanda sem er og þú færð týpískan viðskiptavin á þínu tungumáli.

Terminal window
# Skjalið fyrir hópinn er aðgengilegt við hliðina á tilvísunarsíðunni.
curl -o wink-extranet.json https://api.wink.travel/v3/api-docs/extranet


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 birtir á 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 bera token og önnur köll.
  • .proto skrárnar, ef þú vilt frekar hafa skemuna á staðnum 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


# Búðu svo 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 bera token þitt í authorization metadata hausnum, nákvæmlega eins og REST ber það í 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öð upphaf 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óðaraðstoð er MCP þjónninn okkar hraðasta leiðin. Hann birtir Wink API 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”