REST e gRPC

A Wink expõe dois transportes. Qual você usa depende de qual API está integrando.

	Transporte	Schema	Docs
A maioria das APIs Wink	REST sobre HTTPS	OpenAPI 3	Qualquer grupo sob API na barra lateral
Partner Integrator API	gRPC sobre HTTP/2	Protocol Buffers	Partner

Gerar um cliente REST

Cada grupo de API publica um documento OpenAPI 3. Aponte qualquer gerador OpenAPI para ele e você obtém um cliente tipado na sua linguagem.

# A especificação de cada grupo está disponível para download neste site: /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

Geradores OpenAPI por linguagem

Gerar um cliente gRPC

A Partner Integrator API é gRPC. Você gera um cliente a partir do schema .proto, que a Wink publica de duas formas:

Server reflection — o servidor se descreve, então ferramentas como grpcurl, Postman e Insomnia podem descobrir o schema em tempo de execução sem arquivos para baixar. Reflection requer o mesmo token bearer de qualquer outra chamada.
Os arquivos .proto, se preferir incorporar o schema e gerar antecipadamente.

# Descobrir o schema de um servidor em execução (autenticado).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list

# Então gerar um cliente — aqui Go; todas as linguagens suportadas funcionam da mesma forma.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

As chamadas carregam seu token bearer no cabeçalho de metadados authorization, exatamente como o REST o carrega no cabeçalho Authorization. Erros chegam como um código de status gRPC nos trailers da resposta, em vez de um código de status HTTP — a referência Partner lista os status que você deve esperar.

Inícios rápidos gRPC por linguagem

O que é gRPC?

Ou deixe o servidor MCP escrever para você

Se você usa um assistente de codificação com IA, nosso servidor MCP é a rota mais rápida. Ele expõe as APIs da Wink como ferramentas que seu assistente pode chamar e raciocinar, então em vez de gerar um cliente inteiro e encontrar os endpoints sozinho, você descreve o que está construindo e recebe código de integração moldado para isso.

Configure o servidor MCP da Wink

Leitura adicional

Configuração — contas, ambientes e credenciais
Autenticação — obtenção e renovação de tokens
Integração via Webhook — recebendo eventos em vez de fazer polling