graphapi.api.php file needs more documentation and examples

The file has

• not much examples using all part of the API like #1209426: Multiple links from A to B are not supported
• it misses the new link / edge API change