PHPackages dreamfactory/javascript-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [HTTP & Networking](/categories/http) 4. / 5. dreamfactory/javascript-sdk ActiveLibrary[HTTP & Networking](/categories/http) dreamfactory/javascript-sdk =========================== DreamFactory Services Platform(tm) Javascript SDK 1.0.18(11y ago)515.6k52[1 issues](https://github.com/dreamfactorysoftware/javascript-sdk/issues)[2 PRs](https://github.com/dreamfactorysoftware/javascript-sdk/pulls)1Apache2.0JavaScript Since Sep 30Pushed 2y ago19 watchersCompare [ Source](https://github.com/dreamfactorysoftware/javascript-sdk)[ Packagist](https://packagist.org/packages/dreamfactory/javascript-sdk)[ Docs](http://dreamfactorysoftware.github.io)[ RSS](/packages/dreamfactory-javascript-sdk/feed)WikiDiscussions master Synced 2d ago READMEChangelogDependenciesVersions (19)Used By (1) Address Book for JavaScript =========================== [](#address-book-for-javascript) This repo contains a sample address book application for JavaScript that demonstrates how to use the DreamFactory REST API. It includes new user registration, user login, and CRUD for related tables. Installing DreamFactory on your local machine --------------------------------------------- [](#installing-dreamfactory-on-your-local-machine) To download and install DreamFactory, choose the desired installation package [here](https://www.dreamfactory.com/downloads-interstitial). Configuring your DreamFactory instance to run the app ----------------------------------------------------- [](#configuring-your-dreamfactory-instance-to-run-the-app) - Enable [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) for development purposes. - In the admin console, navigate to the Config tab and click on CORS in the left sidebar. - Click Add. - Set Origin, Paths, and Headers to \*. - Set Max Age to 0. - Allow all HTTP verbs and check the Enabled box. - Click update when you are done. - More info on setting up CORS is available [here](http://wiki.dreamfactory.com/DreamFactory/Tutorials/Enabling_CORS_Access). - Create a default role for new users and enable open registration - In the admin console, click the Roles tab then click Create in the left sidebar. - Enter a name for the role and check the Active box. - Go to the Access tab. - Add a new entry under Service Access (you can make it more restrictive later). - set Service = All - set Component = \* - check all HTTP verbs under Access - set Requester = API - Click Create Role. - Click the Services tab, then edit the user service. Go to Config and enable Allow Open Registration. - Set the Open Reg Role Id to the name of the role you just created. - Make sure Open Reg Email Service Id is blank, so that new users can register without email confirmation. - Save changes. - Import the package file for the app. - From the Apps tab in the admin console, click Import and click 'Address Book for JavaScript' in the list of sample apps. The Address Book package contains the application description, source code, schemas, and sample data. - Leave storage service and folder blank. It will use the default local file service named 'files'. - Click the Import button. If successful, your app will appear on the Apps tab. You may have to refresh the page to see your new app in the list. - Decide if you're going to run the app locally or load it from the instance. - For running locally you clone the repo to your machine and open index.html in the browser. If running locally you need to set the URL for your instance so the app can make the API calls. Go to your local repo and edit script.js. Set the constant `INSTANCE_URL` to point to your DreamFactory instance such as . - For running from the instance you launch the app directly from the Apps tab in the admin console. Leave `INSTANCE_URL` set to empty string. - If running from instance make your app files public. - Figure out where your app files are stored. If you used the default storage settings to import the app, it'll be the default local file service named 'files'. - Go to the Files tab in the admin console. Find your file service. Double click and find the folder for your app, e.g., `AddressBookForJavaScript`. - Go to the `Services` tab in the admin console and click the `files` service. Click the `Config` tab and add the folder name `AddressBookForJavaScript` as a public path. Now select the relevant container from the Container drop down. If you used the default storage settings to import the app then select `local` from the drop down list. Save your changes. - Edit your app API key - If you are running from instance use the file manager to edit `script.js` and set `APP_API_KEY` to the key for your new app. The API key is shown on the app details in the Apps tab of the admin console. - If you are running locally edit `script.js` in your local repo. - Make sure you have a SQL database service named `db`. Most DreamFactory instances have a default `db` service for SQLite. You can add one by going to the `Services` tab in the admin console and creating a new SQL service. Make sure you set the name to `db`. Running the Address Book app ---------------------------- [](#running-the-address-book-app) You can launch the app from the Apps tab in the admin console, or by opening your local `index.html` in your browser. When the app starts up you can register a new user, or log in as an existing user. Currently the app does not support registering and logging in admin users. Example API calls ----------------- [](#example-api-calls) The DreamFactory Address Book for JavaScript uses AJAX to make API calls and the file `functions.js` contains the most common functions for CRUD operations. The general form of a DreamFactory REST API call is: ` http[s]:///api/v2/[]/[][?=]` The JavaScript app AJAX call format is: ``` dataType: String contentType: String url: String data: String,Object method: String headers: Object ``` Breaking down each parameter: - **dataType** Format of the returned data. This depends on the application, but will typically be JSON. - **contentType** The format of data sent to the API. This is commonly JSON and char set UTF-8. - **url** Holds the value of `http[s]:///api/v2/[]/[]` from the generic call. You can include the query parameters here. However, it is easier and cleaner to pass in the query parameters by using the **data** parameter than it is to format them into the url. - **data** The (optional) query parameters. - **method** The REST verb. - **headers** The header object must include the app specific API key and a session token. ### Login and Registration Examples [](#login-and-registration-examples) #### Login [](#login) ``` // if the app is imported to the DreamFactory instance leave INSTANCE_URL blank. Email and password are typically input fields in the app UI. var INSTANCE_URL = 'http[s]://'; var email = 'my@email.com'; var password = 'mypassword'; $.ajax({ dataType: 'json', contentType: 'application/json; charset=utf-8', url: INSTANCE_URL + '/api/v2/user/session', data: JSON.stringify({ 'email': email, 'password': password }), method:'POST', success:function (response) { // Handle success }, error:function (response) { // Handle error } }); ``` The `user/session` API request will return a session token. #### Registration [](#registration) ``` // Email and password are typically input fields in the app UI. var firstname = 'firstname'; var lastname = 'lastname'; var email = 'email'; var new_password = 'new_password'; $.ajax({ dataType: 'json', contentType: 'application/json; charset=utf-8', url: INSTANCE_URL + '/api/v2/user/register?login=true', data: JSON.stringify({ 'first_name': firstname, 'last_name': lastname, 'email': email, 'new_password': password }), method:'POST', success:function (response) { // Handle success }, error:function (response) { // Handle error } }); ``` The API request will return a session token when the (optional) `login=true` parameter is appended to the url. So with this parameter appended, the new registered user doesn't have to login to get a session token. The login and registration examples illustrates how to make API requests to DreamFactory. This Address Book app has functions for common API request types, so in the following examples these functions are used. ### Examples of Fetching Records [](#examples-of-fetching-records) #### Fetch All Records in Table [](#fetch-all-records-in-table) ``` // Use the function `getRecords()` function to get all records from the **contact_group** table. // Usage: getRecords(table, params, token, callback) - params can be fields, filters etc. $.api.getRecords('contact_group', null, session_token, callback); // create a callback function and handle the returned data there var callback = function(response) { // The response contains an array of group objects } ``` #### Fetching Specific Fields [](#fetching-specific-fields) ``` // only need to get the contact_id and full contact name // set the fields param to give us just the fields we need var params = 'fields=contact_id,first_name,last_name'; $.api.getRecords('contacts', params, session_token, callback); ``` #### Fetching with a Filter Applied [](#fetching-with-a-filter-applied) ``` // create filter to get only the contact ids in the group id 10 // note the equal sign is url encoded (%3D) in the filter value; var params = 'filter=contact_group_id%3D10'; $.api.getRecords('contact_group_relationship', params, session_token, callback); ``` ### Creating a Record [](#creating-a-record) ``` // Store a group by posting a stringified object. The API request will return the new group id if successful. var group = { resource: [ { name: 'My Group' } ] }; var params = JSON.stringify(group); $.api.setRecord('contact_group', params, session_token, callback); ``` ### Deleting Records [](#deleting-records) #### Deleting a Single Record by ID [](#deleting-a-single-record-by-id) ``` // a single record can be deleted by id. $.api.deleteRecord('contact', null, session_token, callback); ``` #### Deleting Multiple Records by ID [](#deleting-multiple-records-by-id) ``` // one or more records from e.g. contact can be deleted by adding one or more ids to the parameter. var params = ids=1,2,3; $.api.deleteRecord('contact', params, session_token, callback); ``` #### Deleting Records Matching Field Conditions [](#deleting-records-matching-field-conditions) ``` // delete all records matching field conditions, in this case all contacts with the last name 'Smith'. var params = 'filter=last_name%3DSmith'; $.api.deleteRecord('contact', params, session_token, callback); ``` Additional Resources ==================== [](#additional-resources) More detailed information on the DreamFactory REST API is available [here](http://wiki.dreamfactory.com/DreamFactory/API). The live API documentation included in the admin console is a great way to learn how the DreamFactory REST API works. ### Health Score 40 ↑ FairBetter than 88% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity34 Limited adoption so far Community22 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 50% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~31 days Recently: every ~133 days Total 19 Last Release 4048d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a6d25412f9819bf51eaf3cb005d1f1239f2b81081c51018240d132b98e6ad2b8?d=identicon)[dreamfactory](/maintainers/dreamfactory) --- Top Contributors [![u-patel](https://avatars.githubusercontent.com/u/10222149?v=4)](https://github.com/u-patel "u-patel (2 commits)")[![wjgilmore](https://avatars.githubusercontent.com/u/161522?v=4)](https://github.com/wjgilmore "wjgilmore (2 commits)") --- Tags apisdkrestjavascriptswaggerdreamfactorydsp ### Embed Badge ![Health badge](/badges/dreamfactory-javascript-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/dreamfactory-javascript-sdk/health.svg)](https://phpackages.com/packages/dreamfactory-javascript-sdk) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)