API improvements and documentation: Difference between revisions
No edit summary |
No edit summary |
||
Line 34: | Line 34: | ||
* Stéphane Gigandet | * Stéphane Gigandet | ||
[[Category:Project]] | [[Category:Project]] | ||
[[Category:Documentation]] |
Revision as of 07:27, 7 August 2024
Title: API improvements and documentation
Short description: Simplify, harmonize, complete and extend the Open Food Facts API to edit and read products data and images, and make sure it is documented
What (outcomes):
- Review existing API, simplify when possible (e.g. image upload), harmonize naming and conventions etc.
- Complete existing APIs that miss some features, new fields etc.
- e.g. keywords search in new search API v2
- e.g. nutrition facts for the prepared product
- Possibly extend the existing API, and/or specify a new API
- e.g. support for writing products using a JSON body in the same format as the one used for reading
- Document all available APIs
- Investigate moving API documentation closer to the code (e.g. simple markdown doc in GitHub) so that it stays in synch
Impact (why):
- Allow more uses of Open Food Facts data
- Ease development of those reuses
- Reduce support
Status: Proposal
Timeline: Q2 2022
Needs:
How to join/contribute:
- #api on Slack
People:
- Stéphane Gigandet