{"action":"created","issue":{"url":"https://api.github.com/repos/SharePoint/sp-dev-docs/issues/1689","repository_url":"https://api.github.com/repos/SharePoint/sp-dev-docs","labels_url":"https://api.github.com/repos/SharePoint/sp-dev-docs/issues/1689/labels{/name}","comments_url":"https://api.github.com/repos/SharePoint/sp-dev-docs/issues/1689/comments","events_url":"https://api.github.com/repos/SharePoint/sp-dev-docs/issues/1689/events","html_url":"https://github.com/SharePoint/sp-dev-docs/issues/1689","id":315596819,"node_id":"MDU6SXNzdWUzMTU1OTY4MTk=","number":1689,"title":"Modern experience APIs undocumented","user":{"login":"baywet","id":7905502,"node_id":"MDQ6VXNlcjc5MDU1MDI=","avatar_url":"https://avatars1.githubusercontent.com/u/7905502?v=4","gravatar_id":"","url":"https://api.github.com/users/baywet","html_url":"https://github.com/baywet","followers_url":"https://api.github.com/users/baywet/followers","following_url":"https://api.github.com/users/baywet/following{/other_user}","gists_url":"https://api.github.com/users/baywet/gists{/gist_id}","starred_url":"https://api.github.com/users/baywet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/baywet/subscriptions","organizations_url":"https://api.github.com/users/baywet/orgs","repos_url":"https://api.github.com/users/baywet/repos","events_url":"https://api.github.com/users/baywet/events{/privacy}","received_events_url":"https://api.github.com/users/baywet/received_events","type":"User","site_admin":false},"labels":[{"id":873121733,"node_id":"MDU6TGFiZWw4NzMxMjE3MzM=","url":"https://api.github.com/repos/SharePoint/sp-dev-docs/labels/area:csom/rest","name":"area:csom/rest","color":"e99695","default":false},{"id":896532035,"node_id":"MDU6TGFiZWw4OTY1MzIwMzU=","url":"https://api.github.com/repos/SharePoint/sp-dev-docs/labels/area:dear-vesa","name":"area:dear-vesa","color":"85ed07","default":false},{"id":429675059,"node_id":"MDU6TGFiZWw0Mjk2NzUwNTk=","url":"https://api.github.com/repos/SharePoint/sp-dev-docs/labels/status:tracked","name":"status:tracked","color":"c5def5","default":false},{"id":422233696,"node_id":"MDU6TGFiZWw0MjIyMzM2OTY=","url":"https://api.github.com/repos/SharePoint/sp-dev-docs/labels/type:question","name":"type:question","color":"c2e0c6","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":6,"created_at":"2018-04-18T18:41:41Z","updated_at":"2018-10-10T17:55:06Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"#### Category\r\n- [x] Question\r\n- [ ] Typo\r\n- [ ] Bug\r\n- [ ] Additional article idea\r\n\r\n#### Expected or Desired Behavior\r\nAPI's to come either under the SharePoint REST API or the Graph and to be documented, even if they are in beta.\r\n\r\n#### Observed Behavior\r\nAs the modern experience is picking up, we have more and more customers that are asking us to build on top of it.\r\nThings like \"I'd like to see my saved for later news on my people-centric portal on the desktop\", \"I'd like the system to recommend me news I might be interested in\", \"I'd like to subscribe/follow sites, but from the news webpart...\"\r\nIt appears the modern experience is leveraging 2 API's that are undocumented today:\r\n- https://tenant.sharepoint.com/_vti_bin/homeapi.ashx/ (eg: sites/followed/add)\r\n- https://eastus3-sphomep.svc.ms/api/v1/ (eg: sites/suggested?start=0&count=21&acronyms=true)\r\n\r\nFor the first one I can see it's under SharePoint (good'ol vti bin...), just not under the _api yet and not documented, so a bit of cleanup plus documentation would be required here. **Would it be possible to get at least a summary of what endpoints are available, payloads and supportability for this API fairly soon please?** (Dear Vesa...)\r\n\r\nFor the second one I can't see a valid point for it being on it's own:\r\n- It's not under the SharePoint REST API or the Graph (yet another API I have to know about)\r\n- It has a dynamic domain name that's discoverable only within a page context, the token for it is passed with the page context as well... makes it super closed\r\n\r\nWhen Microsoft came out with the Graph and then with the SPFX, something was repeated many times: have a first/third party API and extensibility model that'd provide a consistant experience for developers from all sides.\r\n**For this second api, if it's not \"production ready\" can you at least move it under the graph, beta and document it please?** (Dear Vesa...) I know this is a \"big\" request that involves engineering, documentation, and the Graph teams...\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/SharePoint/sp-dev-docs/issues/comments/428669040","html_url":"https://github.com/SharePoint/sp-dev-docs/issues/1689#issuecomment-428669040","issue_url":"https://api.github.com/repos/SharePoint/sp-dev-docs/issues/1689","id":428669040,"node_id":"MDEyOklzc3VlQ29tbWVudDQyODY2OTA0MA==","user":{"login":"Jeeakooma","id":22009414,"node_id":"MDQ6VXNlcjIyMDA5NDE0","avatar_url":"https://avatars3.githubusercontent.com/u/22009414?v=4","gravatar_id":"","url":"https://api.github.com/users/Jeeakooma","html_url":"https://github.com/Jeeakooma","followers_url":"https://api.github.com/users/Jeeakooma/followers","following_url":"https://api.github.com/users/Jeeakooma/following{/other_user}","gists_url":"https://api.github.com/users/Jeeakooma/gists{/gist_id}","starred_url":"https://api.github.com/users/Jeeakooma/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Jeeakooma/subscriptions","organizations_url":"https://api.github.com/users/Jeeakooma/orgs","repos_url":"https://api.github.com/users/Jeeakooma/repos","events_url":"https://api.github.com/users/Jeeakooma/events{/privacy}","received_events_url":"https://api.github.com/users/Jeeakooma/received_events","type":"User","site_admin":false},"created_at":"2018-10-10T17:55:06Z","updated_at":"2018-10-10T17:55:06Z","author_association":"NONE","body":"@berndverhofstadt for the Stop call does the site address need to be assigned to a property in the body ie: body: { site: https://<tenant>.sharepoint.com/sites/<site-to-unfollow>}`?"}}
{"actor":{"display_login":"Jeeakooma"}}