{"action":"opened","issue":{"url":"https://api.github.com/repos/civicrm/civicrm-dev-docs/issues/125","repository_url":"https://api.github.com/repos/civicrm/civicrm-dev-docs","labels_url":"https://api.github.com/repos/civicrm/civicrm-dev-docs/issues/125/labels{/name}","comments_url":"https://api.github.com/repos/civicrm/civicrm-dev-docs/issues/125/comments","events_url":"https://api.github.com/repos/civicrm/civicrm-dev-docs/issues/125/events","html_url":"https://github.com/civicrm/civicrm-dev-docs/issues/125","id":217748783,"number":125,"title":"Document API joining","user":{"login":"seanmadsen","id":42411,"avatar_url":"https://avatars2.githubusercontent.com/u/42411?v=3","gravatar_id":"","url":"https://api.github.com/users/seanmadsen","html_url":"https://github.com/seanmadsen","followers_url":"https://api.github.com/users/seanmadsen/followers","following_url":"https://api.github.com/users/seanmadsen/following{/other_user}","gists_url":"https://api.github.com/users/seanmadsen/gists{/gist_id}","starred_url":"https://api.github.com/users/seanmadsen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/seanmadsen/subscriptions","organizations_url":"https://api.github.com/users/seanmadsen/orgs","repos_url":"https://api.github.com/users/seanmadsen/repos","events_url":"https://api.github.com/users/seanmadsen/events{/privacy}","received_events_url":"https://api.github.com/users/seanmadsen/received_events","type":"User","site_admin":false},"labels":[{"id":345892013,"url":"https://api.github.com/repos/civicrm/civicrm-dev-docs/labels/new%20content","name":"new content","color":"84b6eb","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2017-03-29T02:45:53Z","updated_at":"2017-03-29T02:45:53Z","closed_at":null,"body":"API joining was introduced in 4.7 with [CRM-17795](https://issues.civicrm.org/jira/browse/CRM-17795). I think it deserves its own page in the Developer Guide, along with API Chaining, etc\r\n\r\nThere is already some documentation in [this PR comment](https://github.com/civicrm/civicrm-core/pull/7565#issuecomment-170631077). \r\n\r\nMore content from the help box in the API explorer: \r\n\r\n> Join this api call to return values from or filter on a related entity. The new fields will be selectable from the \"Params\" and \"Fields to return\" lists. Example: If the api entity is Email, you can also fetch the display name of the contact this email belongs to. Disambiguation: Joins are different from api chaining in that joins execute as a single SELECT query, and only work for api \"get\" operations.\r\n\r\nI think it'd be nice to create a page in the Dev Guide and then simplify the above help text to link to that page\r\n"}}
{"actor":{"display_login":"seanmadsen"}}