]> git.immae.eu Git - github/bastienwirtz/homer.git/commitdiff
Docs for dummy data
authorBastien Wirtz <bastien.wirtz@gmail.com>
Tue, 11 Oct 2022 17:19:50 +0000 (19:19 +0200)
committerBastien Wirtz <bastien.wirtz@gmail.com>
Tue, 11 Oct 2022 17:19:50 +0000 (19:19 +0200)
dummy-data/README.md [new file with mode: 0644]

diff --git a/dummy-data/README.md b/dummy-data/README.md
new file mode 100644 (file)
index 0000000..deed875
--- /dev/null
@@ -0,0 +1,15 @@
+# Dummy data
+
+This directory content makes possible to test custom services cards or create a demo without actually running the service. 
+The principle is simple: save a sample output of the API used in the service in a static file in this directory. The path must be identical as the service endpoint to be used seamlessly.
+
+## How to add a new services sample: 
+
+- create a directory for your service, and any sub-folder existing in the service api path. 
+- save the api output in a file named after the service endpoint.
+
+Example:
+```
+mkdir pihole
+curl http://my-pihile.me/admin/api.php -o pihole/api.php # /admin is omited because for PiHole, the implementation expect it to be in the base url (`url` or `enpoint` property)
+```
\ No newline at end of file