Difference between revisions of "API improvements and documentation"

From Open Food Facts wiki
Jump to navigation Jump to search
(Created page with "'''Title:''' API improvements and documentation '''Short description:''' Simplify, harmonize, complete and extend the Open Food Facts API to edit and read products data and i...")
 
 
(3 intermediate revisions by 2 users not shown)
Line 33: Line 33:
  
 
* Stéphane Gigandet
 
* Stéphane Gigandet
 +
* Pierre Slamich
 +
[[Category:Project]]
 +
[[Category:Documentation]]

Latest revision as of 07:28, 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
  • Pierre Slamich