quick start
HOW TO
Auth
App Management
Microservices
How to call API of a deployed service on Skygear
Introduction
The APIs of your microservices on Skygear can be called with the
fetch method provided in Skygear JS SDK, or with tools like cURL that can make HTTP-based requests.Prerequisites
Before you start this section, please ensure you have
skycli installed and configured properly. If not, follow this to set it up.You will need your service(s) deployed on Skygear before you can call them, where
skycli is the only way to perform deployments.TL;DR Sooner or later you will need to install and configure
skycli.Call APIs using the Skygear JS SDK
We recommend you to use
fetch in Skygear JS SDK to call your APIs, since it not only manages the users sessions but also throws in required headers for you.Assume you already have a web frontend and a up-and-running microservice on Skygear.
Install the SDK in the frontend client
The CDN way:
1
<script src="https://unpkg.com/@skygear/web"></script>
Copied!
The
npm install or yarn install way:1
$ npm install @skygear/web
2
# OR
3
$ yarn add @skygear/web
Copied!
Configure the SDK with your app's endpoint and API key
1
skygear.configure({
2
endpoint: '<INSERT API ENDPOINT HERE>',
3
apiKey: '<INSERT API KEY HERE>'
4
});
Copied!
Fetch!
Assuming that a microservice is deployed under the path
api and would like to send a request to one of its APIs fetch_blogs, we can achieve this with Skygear SDK as shown below:1
skygear
2
.fetch('api/fetch_blogs', { method: 'POST' })
3
.then((resp) => resp.json())
4
.then((posts) => console.log(posts));
Copied!
This API
fetch_blogs actually exists in one of our Skygear demos. Visit this guide for more information.Call APIs using cURL
Similarly, you can curl the exact same API:
1
curl -X POST \
2
https://<your-app>.skygearapp.com/api/fetch_blogs \
3
-H 'Cache-Control: no-cache' \
4
-H 'Connection: keep-alive' \
5
-H 'Content-Length: 33' \
6
-H 'accept: */*' \
7
-H 'cache-control: no-cache' \
8
-H 'content-type: application/json' \
9
-H 'sec-fetch-mode: cors' \
10
-H 'sec-fetch-site: same-site' \
11
-H 'x-skygear-api-key: <your_app_key>' \
Copied!
The request is visibly bulkier, plus extra effort is spent to substitute values like a Skygear API key. This is nevertheless the go-to option when you would like to test out an API quickly without having to install some SDKs and initialise a new project.