Introduction

ntlm.TinyMessages is an ultra basic HTTP messaging system for microservices. Its purpose is to maintain consistency between them, making sure a entity persisted by one microservice database is up to date in other microservices databases.

Base address

https://test-admin-tm-ms.ntlm.tech

Concepts

Solution

Represents a solution delivered to a client and contains multiple services that are hosted on various location. For instance a solution for a shop could contain a catalog service, a billing service and a customer service.

Service

Represents a service, or a "microservice". For instance the customer service manages customers, their addresses, etc.

Collection

Represents a list of objects maintained by a service. The service publishes entities to the collection. For instance a catalog service could contain a products collection and a categories collection ; the customer service could countain a customer collection.

Registration

Represents a registration of a service to the solution. For instance the product service registers to the shop service. Security is not paramount for now so the registration of a service to a solution only generates a simple public key.

Subscription

Represents the subscription of a service to a collection. For instance the billing service subscribes to the customer collection. So whenever a customer is modified the billing service is notified.

Broadcast

A broadcast is when a service delcares to ntlm.TinyMessages that something happend to an entity of a collection he maintains. ntlm.TinyMessages notifies all services that subcribed to that collection.

Example

• Customer is about to check out.
• He creates an account by the customer service
• The customer service broadcasts the new customer to TinyMessages.
• TinyMessages notifies the billing service and delivers the customer's info.