Skip to content

NFrancart/lcabyg_web_api_doc

 
 

Repository files navigation


Logo

LCAbyg Web API v.1.0

About

Documentation, examples, and use cases of the LCAby Web API.

Please be aware that the scope of underlying software architecture is broader than the LCAbyg Web API.

Please note that the Python packages and example files provided were written using Python 3.10, and may not work on older versions of Python.

Installation

  1. Get a free API_KEY at https://api.lcabyg.dk/
  2. Clone the repo
   git clone https://github.com/build-aau/lcabyg_web_api_doc.git
  1. Enter your USERNAME and an API_KEY in the example.py or example_explanation.py
   USERNAME = 'INSERT YOUR USERNAME'
   API_KEY = 'INSERT YOUR API KEY'
  1. Based on the login, generate and api access TOKEN that is then used for authentication for all API calls.
  2. Before sending a job, ensure your json projects are compatible with LCAbyg JSON standard.

Documentation

  • api.md
  • csv.md
  • Error messages are located in the output JSON data, "extra_output." We are currently working on improving the debug-functionality and provide more user-friendly error messages.

Examples

  • example.py for using the python packages lcabyg_web_api_py and sbi_web_api_py. In the future, these will be Python libraries.
  • example_explanation.py step-by-step explanation of the LCAbyg Web API.

License

Distributed under the BSD 2-Clause License. See LICENSE.md for more information.

Contribution

If you have a suggestion that would make this better, you are welcome to create a pull request.

Projects using the LCAbyg Web API

  • postman configuration. Thanks to Tore Hvidegaard and 3dbyggeri danmark ApS.
  • Sensitivity analyse (WIP). Developed by Lærke Vejsnæs during her masters thesis spring 2023 lhv@build.aau.dk.

If you have a project that uses the LCAbyg Web API, we would love to feature your project here and on the LCAbyg Web API website. Contact Christian Grau Sørensen cgs@build.aau.dk

About

Documentation for the LCAbyg Web API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%