Add information about api4 changes
Created by: colemanw
This adds a changelog and information adapted from https://github.com/civicrm/org.civicrm.api4/blob/master/readme.md and https://gist.github.com/totten/cd2e62e32c84fa6e1b0a1021ffe0a252
Merge request reports
Activity
Created by: colemanw
Ping @totten @seamuslee001
1 # Differences between API v3 and v4 2 3 APIv4 is broadly similar to APIv3. Both are designed for reading and writing data. 4 Both use *entities*, *actions*, and *parameters*. However, APIv4 is specifically a 5 breaking-change which aims to reduce *ambiguity* and improve *flexibility* and *consistency*. 6 7 This document walks through a list of specific differences. As you consider 8 them, it may help to have a concrete example expressed in both APIv3 and 9 APIv4: 10 11 <!-- Would be nice if Markdown made it easier to do side-by-side comparison... --> We can do tables with the "pipe" syntax - if you wrap that inside a code block you can get highlighting - with, for example, "diff" style red/green highlighting as required or with support for code highlight blocks within cells.
https://squidfunk.github.io/mkdocs-material/extensions/codehilite/#usage
| Header 1 | Header 2 | Header 3 | | ---------- | ---------- | ---------- | | Cell 1 | Cell 2 | Cell 3 |
Header 1 Header 2 Header 3 Cell 1 Cell 2 Cell 3 Simple tables are workable - complex tables - not so much!
1 # Differences between API v3 and v4 2 3 APIv4 is broadly similar to APIv3. Both are designed for reading and writing data. 4 Both use *entities*, *actions*, and *parameters*. However, APIv4 is specifically a 5 breaking-change which aims to reduce *ambiguity* and improve *flexibility* and *consistency*. 6 7 This document walks through a list of specific differences. As you consider 8 them, it may help to have a concrete example expressed in both APIv3 and 9 APIv4: 10 11 <!-- Would be nice if Markdown made it easier to do side-by-side comparison... -->
Please register or sign in to reply