mirror of
https://github.com/oceanprotocol/webtasks
synced 2024-11-24 02:55:13 +01:00
241 lines
6.6 KiB
Markdown
241 lines
6.6 KiB
Markdown
[](https://oceanprotocol.com)
|
|
|
|
<h1 align="center">webtasks</h1>
|
|
|
|
> 🐬 Ocean Protocol's webtasks doing automatic things for us via webtask.io
|
|
|
|
|
|
|
|
[](https://travis-ci.com/oceanprotocol/webtasks)
|
|
[](https://github.com/oceanprotocol/eslint-config-oceanprotocol) [](https://greenkeeper.io/)
|
|
|
|
## Table of Contents
|
|
|
|
- [Tasks](#tasks)
|
|
- [Medium](#medium)
|
|
- [YouTube](#youtube)
|
|
- [Bounties](#bounties)
|
|
- [MailChimp](#mailchimp)
|
|
- [Zoho](#zoho)
|
|
- [Campaigns API](#campaigns-api)
|
|
- [CRM API](#crm-api)
|
|
- [Development](#development)
|
|
- [Deployment](#deployment)
|
|
- [Authors](#authors)
|
|
- [License](#license)
|
|
|
|
---
|
|
|
|
## Tasks
|
|
|
|
### Medium
|
|
|
|
**`webtask-medium.js`**: Generic task to fetch and reconstruct items from any medium publication.
|
|
|
|
Requires the Medium username appended at the end of the url:
|
|
|
|
```bash
|
|
http://localhost:8080/:medium_username
|
|
|
|
# when published on webtask.io
|
|
https://TASK_URL/TASK_NAME/:medium_username
|
|
```
|
|
|
|
### YouTube
|
|
|
|
**`webtask-youtube.js`**: Generic task to fetch and reconstruct items from any YouTube account. YouTube API key is provided via [secret environment variable](https://webtask.io/docs/issue_parameters) `YOUTUBE_API_KEY` setup in web editor of webtask.io.
|
|
|
|
* `/playlist/:playlistId`: returns all videos in the given playlist.
|
|
* `/channel/:channelId`: returns latest 10 videos in the given channel, sorted by date.
|
|
|
|
Construct your `GET` request urls like so:
|
|
|
|
```bash
|
|
http://localhost:8080/playlist/:youtube_playlist_id
|
|
http://localhost:8080/channel/:youtube_channel_id
|
|
|
|
# when published on webtask.io
|
|
https://TASK_URL/TASK_NAME/playlist/:youtube_playlist_id
|
|
https://TASK_URL/TASK_NAME/channel/:youtube_channel_id
|
|
```
|
|
|
|
**Response**
|
|
|
|
For all endpoints, response is reconstructed in the same format:
|
|
|
|
```json
|
|
[{
|
|
"id": "8EMowpNlWPE",
|
|
"title": "Fang Gong, Researcher - Bringing Privacy to Ocean Protocol",
|
|
"description": "At Ocean Protocol, we unlock data for AI and use TCRs to maintain a registry of high-quality data sets through voting. Privacy is essential to protecting the ...",
|
|
"imageUrl": "https://i.ytimg.com/vi/8EMowpNlWPE/mqdefault.jpg",
|
|
"videoUrl": "https://www.youtube.com/watch?v=8EMowpNlWPE"
|
|
},
|
|
{
|
|
...
|
|
}]
|
|
```
|
|
|
|
If you want to get the original response returned from YouTube API, append `/raw` at the end of your request, e.g.:
|
|
|
|
```
|
|
https://TASK_URL/TASK_NAME/playlist/:youtube_playlist_id/raw
|
|
```
|
|
|
|
### Bounties
|
|
|
|
**`webtask-bounties.js`**: Task to fetch open bounties on Gitcoin and Bounties.network in one request. Task creates a unified response from fetching both networks.
|
|
|
|
Construct your `/` request url like so, e.g. locally:
|
|
|
|
```bash
|
|
http://localhost:8080/
|
|
|
|
# when published on webtask.io
|
|
https://TASK_URL/TASK_NAME/
|
|
```
|
|
|
|
**Response**
|
|
|
|
Response is structured by network and returns the count of open bounties:
|
|
|
|
```json
|
|
{
|
|
"gitcoin": 1,
|
|
"bountiesNetwork": 2
|
|
}
|
|
```
|
|
|
|
### MailChimp
|
|
|
|
**`webtask-mailchimp.js`**: Task to add a new newsletter subscriber.
|
|
|
|
Construct your `POST /newsletter` request url like so, e.g. locally:
|
|
|
|
```bash
|
|
http://localhost:8080/newsletter/jelly@mcjellyfish.com
|
|
|
|
# when published on webtask.io
|
|
https://TASK_URL/TASK_NAME/newsletter/jelly@mcjellyfish.com
|
|
```
|
|
|
|
**Response**
|
|
|
|
When subscription is successful:
|
|
|
|
```json
|
|
{ "status": "created" }
|
|
```
|
|
|
|
When subscriber already exists:
|
|
|
|
```json
|
|
{ "status": "exists" }
|
|
```
|
|
|
|
All errors from MailChimp (when `"status"` is a number) are simply passed through and follow the MailChimp API error responses, e.g.:
|
|
|
|
```json
|
|
{
|
|
"type": "http://developer.mailchimp.com/documentation/mailchimp/guides/error-glossary/",
|
|
"title": "Forgotten Email Not Subscribed",
|
|
"status": 400,
|
|
"detail": "matthias@bigchaindb.com was permanently deleted and cannot be re-imported. The contact must re-subscribe to get back on the list.",
|
|
"instance": "06171156-4bca-4b6c-a84f-aa3690a82798"
|
|
}
|
|
```
|
|
|
|
### Zoho
|
|
|
|
**`webtask-zoho.js`**: Generic task to subscribe users into lists on Zoho Campaigns & Zoho CRM.
|
|
|
|
Credentials are provided via [secret environment variables](https://webtask.io/docs/issue_parameters), setup in web editor of webtask.io:
|
|
|
|
* `ZOHO_CAMPAIGNS_TOKEN`
|
|
* `ZOHO_CAMPAIGNS_LIST_KEY`
|
|
* `ZOHO_CRM_TOKEN`
|
|
|
|
#### Campaigns API
|
|
|
|
* `/newsletter/:data`: subscribes the given email address to the newsletter list on Zoho Campaigns.
|
|
|
|
The data needs to be in `json` format in the following pattern:
|
|
|
|
```
|
|
{Contact Email:info@oceanprotocol.com}
|
|
```
|
|
|
|
Construct your request url like so, e.g. locally:
|
|
|
|
```bash
|
|
http://localhost:8080/newsletter/:data
|
|
|
|
# when published on webtask.io
|
|
https://TASK_URL/TASK_NAME/newsletter/:data
|
|
```
|
|
|
|
#### CRM API
|
|
|
|
* `/crm/:data`: subscribes the given email address to the newsletter list on Zoho Campaigns.
|
|
|
|
The data needs to be in `json` format in the following pattern:
|
|
|
|
```
|
|
{First Name:Jellyfish, Last Name:McJellyfish, Contact Email:info@oceanprotocol.com}
|
|
```
|
|
|
|
Construct your request url like so, e.g. locally:
|
|
|
|
```bash
|
|
http://localhost:8080/crm/:data
|
|
|
|
# when published on webtask.io
|
|
https://TASK_URL/TASK_NAME/crm/:data
|
|
```
|
|
|
|
## Development
|
|
|
|
```bash
|
|
npm install wt-cli -g
|
|
npm start
|
|
```
|
|
|
|
And go to [localhost:8080](http://localhost:8080)
|
|
|
|
## Deployment
|
|
|
|
All tasks are running serverless on webtask.io where you can login with your GitHub account. Then interact with it locally with the `wt-cli`:
|
|
|
|
```bash
|
|
npm install wt-cli -g
|
|
wt init YOUR_GITHUB_EMAIL
|
|
|
|
wt create webtask-medium.js --name medium
|
|
|
|
# make sure it's there and get url
|
|
wt ls
|
|
```
|
|
|
|
## Authors
|
|
|
|
- Matthias Kretschmann ([@kremalicious](https://github.com/kremalicious)) - [BigchainDB](https://www.bigchaindb.com) & [Ocean Protocol](https://oceanprotocol.com)
|
|
- initial Medium web task by Pedro Gomes ([@pedrouid](https://github.com/pedrouid)) - [Balance](https://balance.io)
|
|
|
|
## License
|
|
|
|
```
|
|
Copyright 2018 Ocean Protocol Foundation Ltd.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
```
|