A simple VIN decoding microservice wrapped around the vin_decoder package written in Dart.
The application can be activated from pub directly:
$ pub global activate --source path <path to repository>
Package vin_decoder_service is currently active at path "...".
Installed executable vindecoder-service.
Activated vin_decoder_service 0.0.4 at path "...".
The vindecoder-service can run standalone, or can register itself with a Consul Agent to ease with service discovery.
By default, an attempt to register with Consul will be made.
To run standalone on the server side and inhibit Consul registration, the --no-use-consul flag may be specified:
$ vindecoder-service --no-use-consul
VIN Decoder Service Registered on 0.0.0.0:8080/vin
...
otherwise, the default behaviour applies, and service registration will be attempted with the defined (or default) agent:
$ vindecoder-service
Registering VIN Decoder Service with Consul Agent @ localhost:8500
VIN Decoder Service Registered on 0.0.0.0:8080/vin
...
An overview of supported commands and flags is provided below:
$ vindecoder-service --help
usage: vindecoder-service [-pcu]
-p, --port Port to bind to
(defaults to "8080")
-c, --consul-agent Consul Agent to register service with
(defaults to "localhost:8500")
-u, --[no-]use-consul Use Consul for service registration
(defaults to on)
-h, --help Show usage info
From the client side, decoding may be tested by sending a JSON-encoded VIN string:
$ curl -X POST -H "Content-Type: application/json" -d '{ "vin": "WP0ZZZ99ZTS392124" }' http://localhost:8080/vin
with the decoded VIN returned in the POST response body:
{"wmi":"WP0","vds":"ZZZ99Z","vis":"TS392124","year":"1996","region":"EU","manufacturer":"Porsche","assembly_plant":"S","serial_number":"92124","make":"Porsche","model":"911","vehicle_type":"Passenger Car"}
A /health endpoint is provided and registered with Consul by default - in practice, this simply checks continued
connectivity to the Consul Agent from the service side. In the cases where Consul isn't used, it simply denotes the
continued accessibility of the service itself.
Prometheus metrics are also provided and can be scraped from the /metrics endpoint as expected.
Docker images are provided under adaptant/vin-decoder-service and can be run without any special configuration:
$ docker run -d -p 8080:8080 adaptant/vin-decoder-service
Please file feature requests and bugs at the issue tracker.
Licensed under the terms of the Apache 2.0 license, the full version of which can be found in the LICENSE file included in the distribution.