Querying multiple tables with joins

From DreamFactory
Jump to: navigation, search
DreamFactoryTutorialsQuerying multiple tables with joins
Line 13: Line 13:
 
[[File:Swagger-related.png|1000px]]
 
[[File:Swagger-related.png|1000px]]
  
### Example - Fetch contact and contact_info_by_contact_id records in one API call. Each contact has zero or more contact_info_by_contact_id records.
+
### Example - Fetch contact and contact_info_by_contact_id records in one API call.  
  
 
* Table name: contact
 
* Table name: contact
 
* Related parameter in API call: <pre>related=contact_info_by_contact_id</pre>
 
* Related parameter in API call: <pre>related=contact_info_by_contact_id</pre>
 
* Request URL: <pre>https://foo.com/api/v2/db/_table/contact?related=contact_info_by_contact_id</pre>
 
* Request URL: <pre>https://foo.com/api/v2/db/_table/contact?related=contact_info_by_contact_id</pre>
 +
 +
### Example - Fetch contact, contact_info_by_contact_id, and contact_group_relationship_by_contact_id records in one API call.
 +
 +
* Table name: contact
 +
* Related parameter in API call: <pre>related=contact_info_by_contact_id, contact_group_relationship_by_contact_id</pre>
 +
* Request URL: <pre>https://foo.com/api/v2/db/_table/contact?related=contact_info_by_contact_id, contact_group_relationship_by_contact_id</pre>
  
 
### Example - Fetch  contact and all related records by foreign key in one API call.
 
### Example - Fetch  contact and all related records by foreign key in one API call.

Revision as of 17:10, 9 October 2015

      1. Tutorial

Query a SQL database for records in different tables joined by key. Try these examples in the 'API Docs' tab of the DreamFactory Admin Console or from the command line with cURL.

Note that passing * as the 'related' parameter will return all records by foreign key.

      1. API Endpoint
GET https://{url}/api/v2/{api_name}/_table/{table_name}?related={foreign_key_field}
      1. API Docs Screenshot

Swagger-related.png

      1. Example - Fetch contact and contact_info_by_contact_id records in one API call.
  • Table name: contact
  • Related parameter in API call:
    related=contact_info_by_contact_id
  • Request URL:
    https://foo.com/api/v2/db/_table/contact?related=contact_info_by_contact_id
      1. Example - Fetch contact, contact_info_by_contact_id, and contact_group_relationship_by_contact_id records in one API call.
  • Table name: contact
  • Related parameter in API call:
    related=contact_info_by_contact_id, contact_group_relationship_by_contact_id
  • Request URL:
    https://foo.com/api/v2/db/_table/contact?related=contact_info_by_contact_id, contact_group_relationship_by_contact_id
      1. Example - Fetch contact and all related records by foreign key in one API call.
  • Table name: contact
  • Filter parameter in API call:
    related=*
  • Request URL:
    https://foo.com/api/v2/db/_table/contact?related=*