This project showcases the use of https://superface.ai to seamlessly integrate APIs and handle provider's failover without worrying about how they are implemented or even knowing what API and therefore provider do you use.
The demo application allows you to choose from 3 use cases, either classic email use case, fetch the names of repositores for a specified GitHub or Gitlab user or fetch the address for a specified coordinates and send these fetched information to the email entered in form.
To see how to fetch the repositories or send email using Superface's OneSDK check out the fetchUserRepos()
and sendEmail()
fuctions in the superface.js
file.
← superface.js
: This file contains all superface code except superface client code, which is centralized in client.js
. It contains functions like fetchUserRepos()
where profile and provider are set and result from perform is handled
← client.js
: This file contains centralized Superface client and function to get it
← hooks.js
: This file contains settings of event hooks for centralized client, they're used to trigger fake failover on pre-fetch
. It also contains functions to get information about failover.
← public/
, src/
: Folders from the remixed Glitch Node.js starter project, it is safe to ignore those for the puprose of learning about Superface
← server.js
: The main server script of the application, it does not contain Superface-specific code, only a boiler plate to make the application work
← superface/
: Superface folder that contains the configuration of the OneSDK for the capabilities and providers used in the application
← superface/super.json
: The actual configuration of the capabilties and providers
← .env
: Secrets such as API keys for the used providers
Geocode Example - use Superface to get coordinates from address
Reverse Geocode Example - use Superface to get address from coordinates
We would ❤️ to hear your feedback! Please get in touch either with Vrata (v@superface.ai) or Z (z@superface.ai).
If you haven't already, sign up at https://superface.ai.
You can also follow us at Twitter @superfaceai.