Line 11: |
Line 11: |
| * When doing averages, computations… filter incomplete products to avoid issues | | * When doing averages, computations… filter incomplete products to avoid issues |
| * Assume the data is not reliable until the product is marked as complete. | | * Assume the data is not reliable until the product is marked as complete. |
− | * '''In general, ensure the user exercises maintains caution (for allergens…) and be upfront about possible risks.''' | + | * '''In general, ensure the user exercises caution (for allergens…) and be upfront about possible risks.''' |
| * <span style="color:#d33">'''By using any part of the API you have read and understood the [[#License|license]].'''</span> | | * <span style="color:#d33">'''By using any part of the API you have read and understood the [[#License|license]].'''</span> |
| | | |
Line 27: |
Line 27: |
| | | |
| == READ operations == | | == READ operations == |
− | For more details please look at [[API/Read]] | + | For more information, see [[API/Read]] |
| | | |
| === Technical details === | | === Technical details === |
− | * You can do READ operations using production server. | + | * You can do READ operations using the production server. |
| * You should use the SSL version of the API. <code>https://world.openfoodfacts.org</code> | | * You should use the SSL version of the API. <code>https://world.openfoodfacts.org</code> |
− | * '''Please send a UserAgent HTTP Header''' with the name of the app/service querying, the version, system and an URL if you have one, so that you are not blocked by mistake (e.g. <code>UserAgent: CoolFoodApp - Android - Version 1.0 - https://coolfoodapp.com</code>) | + | * '''Please send a UserAgent HTTP Header''' with the name of the app/service querying, the version, system and a URL if you have one, so that you are not blocked by mistake (e.g. <code>UserAgent: CoolFoodApp - Android - Version 1.0 - https://coolfoodapp.com</code>) |
| | | |
| == WRITE operations == | | == WRITE operations == |
− | Please look at [[API/Write]]
| + | For more information, see [[API/Write]] |
| | | |
| === Use cases === | | === Use cases === |
− | * You can add photos and informations to Open Food Facts using the API. | + | * You can add photos and information to Open Food Facts using the API. |
| ** Letting your users add new products by uploading photos is the most common use case. | | ** Letting your users add new products by uploading photos is the most common use case. |
| ** Several apps already enable more advanced editing. Gamification would be welcome. | | ** Several apps already enable more advanced editing. Gamification would be welcome. |
Line 91: |
Line 91: |
| Do not hesitate to file a bug if you find an issue in the API, or need an improvement! | | Do not hesitate to file a bug if you find an issue in the API, or need an improvement! |
| | | |
− | You can fill in the issue report[https://github.com/openfoodfacts/openfoodfacts-server/issues/new here on GitHub] | + | You can fill in the issue report [https://github.com/openfoodfacts/openfoodfacts-server/issues/new here on GitHub] |
| + | |
| === Known bugs === | | === Known bugs === |
| * General bugs: https://github.com/openfoodfacts/openfoodfacts-server/issues | | * General bugs: https://github.com/openfoodfacts/openfoodfacts-server/issues |