RESTBase/fr

RESTBase est une API de proxy pour la mise en cache et la restitution derrière l' API Wikimedia REST. Sa configuration est basée sur les spécifications Swagger, et la zone de stockage primaire de son noyau utilise Cassandra. Elle fait tourner " ", l'API Wikimedia REST de contenu utilisée par l'Editeur visuel pour récupérer le code HTML de la page à modifier. Pour des raisons de performance, les points terminaux du service sont aussi disponibles sur chaque wiki, par exemple sur ce wiki.

En tant que proxy, RESTBase ne réalise aucun traitement significatif lui-même sur le contenu. A la place, il demande les transformations du contenu aux services du noyau si nécessaire, et typiquement (en fonction de la configuration) les stocke pour qu'ils puissent être récupérés ultérieurement. Pour les points de terminaison statiques à grand volume, la plupart des requêtes seront satisfaites directement à partir de la mémoire.

Its storage backends expose a RESTful storage API similar to Amazon DynamoDB and Google DataStore. The primary implementation uses Apache Cassandra. Notable features include automatically maintained secondary indexes and some lightweight transaction support. A SQLite backend has been developed and is the default backend in the package.

RESTBase automatically emits statsd metrics about all storage and backend requests. This provides a good baseline level of performance and error instrumentation in a micro-service architecture.

Cas d'utilisation
Our first use case is speeding up VisualEditor by reducing HTML size, and eliminating Varnish cache misses. RESTBase stores Parsoid metadata separately from the HTML of the page, which reduces the size of the latter by about 40%. RESTBase provides only this HTML to VE, which reduces network transfer and processing latency significantly. In the longer term, we are aiming to bring down the size of the HTML to that of current PHP parser output to make it suitable for regular page views. This has the potential to make switching to visual editing instantaneous and free of any scrolling.

If parse time is not a pressing concern for your wiki (for example it does not have complex templates or large transclusion counts), then accessing Parsoid directly may make more sense than introducing a dependency on RESTBase.

Another use case we are strongly interested in is providing a section-level editing API for micro-contributions and extremely fast VisualEditor saves, even faster than wikitext.

Documentation

 * Browse the API endpoints
 * Overview
 * Architecture
 * Browse the documentation
 * Deployment process
 * List of current users

Installation

 * RESTBase/Installation

Voir aussi

 * Follow architectural discussions about RESTBase by joining & watching the RESTBase-architecture project
 * Report issues on Phabricator, project 'RESTBase'
 * Original requests for comments: and
 * Original requests for comments: and
 * Original requests for comments: and
 * Original requests for comments: and