Skip to content

Latest commit

 

History

History
34 lines (18 loc) · 2.75 KB

README.md

File metadata and controls

34 lines (18 loc) · 2.75 KB
Raw

BeApi(tm) Api Framework

Documentation located at http://orubel.github.io/Beapi-API-Framework/

Fully reactive api framework providing automation and simplification of api's for scale. Some features include:

  • Automated Batching: all endpoints are batchable by default with AUTH ROLES assignable to restrict access. Batching can also be TOGGLED to turn this feature ON/OFF per endpoint.

  • Built-in CORS: Cross Origin Request handling secures all endpoints from domains that you don't want.

  • JWT Tokens: JWT Token handling for Javascript frontends to allow or better abstraction of the VIEW layer

  • Web Hooks: Enables secured Web Hooks for any endpoint so your developers/users can get push notification on updates.

  • Throttling/Rate Limits: Data Limits/Rate limits and Throttling for all API's through easy to configure options

  • Autogenerated APIDocs: APIDocs that are autogenerated based on your ROLE thus showing only the endpoints that you have access to.

  • Shared I/O state: the data associated with functionality for REQUEST/RESPONSE (usually through annotations) has been removed and abstracted out to a single file per endpoint grouping. This allows for ON-THE-FLY reloading of the state and endpoint security. This also allows for easy update and synchronization will all services/processes that may share in the IO flow and need to synchronize this data (rather than duplicate).

  • API Chaining(tm): rather than using HATEOASto make a request, get a link, make a request, get a link, make a request, etc... api chaining allows for creation of an 'api monad' wherein the output from a related set of apis can be chained allowing the output from one api to be accepted as the input to the next and so on and be passed with ONE REQUEST AND ONE RESPONSE.

  • Localized API Cache: returned resources are cached,stored and updated with requesting ROLE/AUTH. Domains extend a base class that auto update this cache upon create/update/delete. This speeds up your api REQUEST/RESPONSE x10

  • Built-In Profiler: Profile your API's and have them deliver a metrics report of time it takes for every class/method to deliver so you can optimize queries, methods services

FAQ

Q: How hard is this to implement? A: BeApi is 'Plug-N-Play'. Merely install the plugin and it takes care of the 'REST'. The only thing you have to do is build an IO state file for each controller. This enables us to separate all IO data from functionality so it can be shared with other services in the architecture.

Q: How do I implement the listener for IO state webhook on my proxy/Message queue? A: It merely requires an endpoint to send the data to. As a side project, I may actually supply a simple daemon in the future with ehCache to do this for people.