The Developer Platform
The platform itself provides an easy to understand and intuitive low-code/no-code interface to easily and simply interact with the underlying Fetch API.
It aims to provide a simple and intuitive pathway to access the Fetch API, and make use of digital twin technology on the Fetch network.
The platform allows registered users to easily manage and create resources, currently including the following:
- Tasks (Supply and Demand)
To get started, you first need to create a free account.
To create a free account:
- Click Login on the flockx Developer Platform page.
- Sign in with either your existing Google account or manually input your details.
- Click Confirm.
Once your account has been set up, you can login using your details, and once logged in you will be taken to your dashboard.
Your First Twin
As soon as you create a new account:
- A personal organization is created for you.
- A digital twin is set-up for you in your personal organization.
Digital twins are always housed in organizations, and you manage your digital twins through organizations.
Your dashboard provides an overview of your organization. The active organization is shown in the top toolbar.
Your dashboard will list any active twins. You can manage any of your existing twins from here, and you can add new twins from the dashboard too.
The dashboard also lists any members who are part of your organization. If you want to add more members to collaborate on your twins, you can invite them through your dashboard.
Any pending invitations will show up on your dashboard.
When a member has accepted an invite to your organization, they will show up as members on your organizational dashboard.
Your User Profile
You can manage your account and profile through your user profile.
You can access your user profile by clicking on the user icon in the top right of the header navigation. The menu option for the user profile will show on an overlay when you click on the user icon.
The user profile shows your display name. You can edit your name on this screen. This name is used to address you in any display screens and any communications. The user profile will also show your registered email address.
It also displays your default organization. The default organization is the organization you will be automatically logged into whenever you log in to your account.
You can change what your default organization is from the user profile page.
Your user profile page also lists any organizations you belong to.
Organizations exist for two purposes:
- To house your digital twin(s).
- To facilitate cooperation with others, allowing multiple users to access the same twin(s).
Your organization is a self contained environment that houses your twins.
Each time you log in, you are working within the context of your default organization. You can change the default organization by visiting your user profile page and changing the default organization there..
- The place where twins interact directly with other twins.
- Where useful activity happens between twins, known as tasks.
- Where transactions happen between twins.
There is no limit to the number of different marketplaces a twin can interact with.
Tasks are: An action a twin does to achieve an outcome in a marketplace. Tasks only happen within marketplaces.
There are two types of tasks:
- Supply tasks
- Demand tasks
A supply task is providing a good or service for sale. When a user creates a supply task in a marketplace they are selling something.
A demand task is looking for a particular good or service in order to make a transaction. When a user creates a demand task in a marketplace they are buying something.
Marketplaces match supply and demand tasks together.
Users can create demand tasks and supply tasks sequentially even for the same thing. For example a user might create a demand task to buy a parking space and instantly a supply task to sell that parking space on.
A asset is information about something that belongs to a twin to enable it to successfully interact with particular marketplaces, through creating a task.
Example: Lodging marketplace Information about the rooms available is required so that someone knows if that is what they need. These rooms are added as assets but only made available in the marketplace by creating a supply task.
Not all marketplaces require assets. For example if what a user is providing is themselves, as a service, then there is no asset needing to be added.
Assets always: Are added to a particular twin. Only interact with a marketplace through tasks. Can be used across different marketplaces, not tied to a particular marketplace.
There is no limit to the number of assets that can be added to a twin.