Calling Skygear API

Skygear Container

Besides using the SDKs to interact with Skygear, you can also call the Skygear APIs directly using the Skygear skygearCloud.getContainer() from the cloud code.

const container = skygearCloud.getContainer();

You can create Skygear Container object by CloudCodeContainer() from skygearCloud. And configure it with apiKey, endPoint and userId.

const container = new skygearCloud.CloudCodeContainer();
container.apiKey = 'your-api-key';
container.endPoint = skygearCloud.settings.skygearEndpoint + '/';

Query can be done similar to JS SDK.

As an example, you can perform a query through Skygear with the following:

const container = skygearCloud.getContainer('admin'); // act as `admin`
const TaskRecord = skygear.Record.extend('task');
const query = new skygear.Query(TaskRecord);
query.equalTo('_id', 'cdfc7bb4-afd3-464c-a430-c9564c2202cf');
container.publicDB.query(query).then((records) => {
  console.log(records);
});

Using the master key

A master key is a special key which allows you to perform operations that would not be possible using the normal API key. A typical use case in the cloud code is to impersonate a user for creating, altering or querying records.

You can find your master key in your app settings in the Skygear portal, or obtain your master key through the cloud code by:

masterKey = skygearCloud.settings.masterKey;

You can impersonate a user from the cloud code by setting the master key as the api_key when you initialize the SkygearContainer, and provide the user ID as the user_id parameter. You do not need an access token for the user to be impersonated.

Any calls made using send_action will then be done on behalf of the provided user.

The following example demonstrates saving a record on behalf of the authenticated user:

const container = skygearCloud.getContainer('admin');

// When you call container to save the record,
// the action will be done on behalf of the given user
const Task = skygear.Record.extend('task');
const TaskRecord = new Task({
  description: 'Complete the sales report'});
container.publicDB.save(TaskRecord).then((result) => {
  console.log(result);
});

Deleting a record can be done in a similar fashion:

const container = skygearCloud.getContainer('admin');

container.publicDB.delete({
  id: 'note/cdfc7bb4-afd3-464c-a430-c9564c2202cf'
}).then((record) => {
  console.log(record);
}, (error) => {
  console.error(error);
});

Database Queries

In the database hooks, you receive the pool argument which is an instance of the [SQLAlchemy engine connection]. In other types of cloud code functions, you can obtain such an instance by calling pool. In this below example, we have connected to the Skygear database and made a raw SQL query in a lambda function.

const skygearCloud = require('skygear/cloud');

skygearCloud.op('queryX', () =>
  skygearCloud.pool
    .query(
      `SELECT * FROM app_sample.sampleTable WHERE x='y'`
    )
    .then(res => {
      return {
        results: res.rows
      };
    })
    .catch(err => {
      console.error(err.stack);
      return Promise.reject('Fail to execute the sql');
    })
);

Note: you should fill in app_sample.sampleTable as app_<your-app-name>.<table-name>.

PubSub Events

You can publish a message to a PubSub channel through cloud code using the publish function in the skygear.pubsub module.

container.pubsub.publish('my_channel', {'text': 'Hello World'});

The publish function has no return values and takes two arguments:

• channel (String)

  The name of the PubSub channel to publish to. All subscribers to the channel will receive the data.

• data (Object)

  This is the data to be published to the channel.

Push Notifications

You can send push notifications to users from the cloud code using the sendToUser function in the skygear package.

const container = skygearCloud.getContainer();
container.push.sendToUser(
  ['2aa4af2a-699a-4e43-8d67-7598757fc7ed'], // User IDs
  {
    'apns': {
        'aps': {
            'alert': {
                'title': title,
                'body': message,
            }
        },
        'from': 'skygear',
        'operation': 'notification',
    },
    'fcm': {
         'notification': {
              'title': title,
              'body': message,
          }
    },
  }
);

Parameters

sendToUser(users, notification, topic)

• users (string or array of string)

  An array of User IDs. If you are sending a notification to a single user, you can also specify the User ID in string instead of array.

• notification (dictionary)

  It should be a Python dictionary with two keys, apns and gcm, representing the argument for Apple Push Notification Service and Google Cloud Messaging respectively.

• topic (string)

  The device topic, refer to application bundle identifier on iOS and application package name on Android

sendToDevice(devices, notification, topic)

• devices (string or array of string)

  An array of Device IDs. If you are sending a notification to a single device, you can also specify the Device ID in string instead of array.

• notification (dictionary)

  It should be a Python dictionary with two keys, apns and gcm, representing the argument for Apple Push Notification Service and Google Cloud Messaging respectively.

• topic (string)

  The device topic, refer to application bundle identifier on iOS and application package name on Android

Return Value

(TODO)