BWS gRPC API

gRPC is a high-performance Remote Procedure Call (RPC) framework that uses HTTP/2 and service- and message-contracts to create high-performance services. As gRPC uses Protocol Buffers (Protobuf) for its interface definition and message interchange format, our new BWS API is defined with a Protobuf service definition file.

Service Definition

Please download the Protobuf files needed to to integrate BWS into your client software project below. By using Protobuf files, client code can be generated easily for C++, C#, Java, Python, Go, Ruby, Objective-C and other languages.

• bws.proto: Definition of the BioID Web Service (BWS) 3 API.
• facerecognition.proto: Definition of the BWS 3 Face Recognition API (preview).
• bwsmessages.proto: Definition of messages as used in various BWS 3 APIs.

Endpoint

The BWS 3 basic APIs (gRPC API and JSON Web API) can be found at the grpc subdomain of the various BWS 3 installation locations: https://grpc.{bws-location}.bioid.com, e.g.: https://grpc.bws-eu.bioid.com or https://grpc.bws-sa.bioid.com.