Version: 0.0.1.0
Developed by: Steve Sparks

Overview

The purpose of this API is to act as a demo project that members of my team use to practice various development and DevOps Activities. It is much more fun to get to the end of the coding project or, even worse, a deployment and CICD build-out, and it has something fun to do at the end.

This API is also very usable for the foundation of your own BlackJack game. My goal is an original game following well-accepted rules. I have not introduced the ability to split a hand (yet), but the gameplay and the API have many fun features.

You can play the game using a client I have implemented or you can implment your own client. Scroll down to see the game commands and the game rules

Implementing a Client for the API

You can post an empty game move to the /game/play/ endpoint, and the API will start a new game and return the new game results. The client that calls the /game/play/{id} endpoint will continue to get the game results for the unique game id for each move posted. The API caches the game for 8 hours and lets you play until the cache expires or you rest the game. The API can be used to play on any platform calling the API or you can use the srrvice in the source application to create a standalone game.

• Call the POST endpoint and the game starts
• Post each time the player submits a command.
• The API POST method expects a simple game move object that contains the game ID and the platyer move
• The API then returns a move result object you can use to display the game state.

House Rules:

I have implemented a single-deck version of Blackjack. When the game begins, the cards are turned round-robin style and removed from the deck. Then, the deck is shuffled when the last card is used, and the play continues.

• The deck is 52 cards w/o Jokers.
• The deck will shuffle when the last card is used.
• House draws on 16 or less and stands on 17.
• Insurance requires enough points for equal bets.
• Double requires enough points remaining to double your bet.
• BlackJack pays 3 x points. (Bet 100 win 300)
• BlackJack is an ACE and a FACE Card. A 10 is not a face card.
• The player receives 10000 points. Each new play session.
• The Minimum Best is 100 points.
• Beat the house when the player exceeds 50000 points.
• When a player has 0 points, the house wins.

Game Commands:

• HELP: Displays this list of commands.
• BET[#]: Bets 100 or the number specified.
• DOUBLE: Doubles your bet and then STANDS your hand.
• HIT: Deal a card and continue to play.
• INS: Purchases insurance and stands on the current hand.
• RULES: Provides a list of the rules.
• RESET: Restarts the game and resets player and points.
• STAND: The player has completed the play.