Ripledd APIs & documentation

Hi developer! We offer different options for developers to use our service, like: APIs and Widgets. Ripledd is also an open-source project, that means people are able to interact with Ripledd's code. Information below will help you to use Ripledd in your projects.

2. Bot API

This API allows your bots to interact with Ripledd posting system. Mostly known as RPB (Ripledd Posting Bot). Ripledd bots are able to send data into posts. Currently bots are able to send only text format, that means this API does not support media uploads via bots. Before starting, it is good to know how to connect your bot to Ripledd's API. The connection is easy, it requires only few steps to do in your code.

Firstly you need to get your channel secure_id.

For getting the secure ID, you need to do the following POST request to https://ripledd.com/api/login.php Send your following credentials as json:

{ "email": "example@mail.com", "password": "XXXXXXXX", }

You will recive the following output { "id": 21, "email": "jhondoe@mail.com", "uname": "Jhon Doe", "avatar": "http://localhost/profile/jhon.png", "banner": "http://localhost/profile/default/default-banner.png", "secure_id": "121gdd5g4s5123", "user_url": "jhondoe", "followers": 3000, "quote_text": "I love my wife Jane Doe.", "bio_link": "johndoe.com", "bio_about": "Your friendly neighbourhood John Doe., "join_date": 01-06-2015, "status": "verified", "restriction": null, "owner": null, "type": null, "change_id": null }

Then use the secure_id to post on Ripledd.

Send the following json body to https://ripledd.com/api/post/create.php with secure_id in the headers as

HTTP-SECURE-ID: <SECURE_ID> ← This will help in authenticating the user

Other wise you can send your channel id in the post data as auth_secure_id

Request JSON { "content": "Hey Girl, Roses are #ff0000, Violets are #0000ff, I use hex codes, But I'd use RGB for you.", "channel_id": "XXXXXXXX", #This one is optional if you are creating post from the main channel, but required to create from sub channel, "category": "funny", #This one is also optional, but it will help Ripledd to categorize your post. "auth_secure_id": "1x2y3z4a5b6c" #If the headers couldn't be sent properly use this method to authenticate yourself. }

To get the details of sub channels that you own, do a request to https://ripledd.com/api/channel/mine.php with header HTTP-SECURE-ID: <SECURE_ID>

Response [ { "id": 1666, "email": null, "uname": "Django Devs", "password": null, "avatar": "default/default-avatar.png", "banner": "default/default-banner.png", "secure_id": "ad0e1xxxxxxbb118d586-c-sub", "user_url": "djangodevs", "followers": 0, "quote_text": null, "bio_link": null, "bio_about": null, "join_date": "15/06/24", "status": null, "restriction": null, "owner": "1", "type": "sub-basic", "change_id": null }, # --SNIP-- ]

Use the secure_id from the above response to create posts on Ripledd with sub channel.

Isn't that easy? After these steps your bot is connected to Ripledd's posting API. Email or password changes on your account also requires to change connection information in your bot script.




3. Bot Model

This is an open source bot which posts Dogecoin crypto data to Ripledd. Check out @dogecoinme channel, that posts everyday DogeCoin's price and Market Cap.

from requests import Request, Session import json API_KEY = '---' RIPLEDD_AUTH_SECURE_ID = "XXXXXXXXXXXXXXX" # Secure id of main account RIPLEDD_DOGEBOT_SECURE_ID = "XXXXXXXXXXXXXXX" # Secure id of dogebot account url = 'https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest' parameters = {'symbol': 'DOGE'} headers = {'Accepts': 'application/json', 'X-CMC_PRO_API_KEY': API_KEY} session = Session() session.headers.update(headers) response = session.get(url, params=parameters) data = json.loads(response.text) print ('Current Price (USD): ' + str(data['data']['DOGE']['quote']['USD']['price'])) print ('24h Volume (USD): ' + str(data['data']['DOGE']['quote']['USD']['volume_24h'])) print ('Market Cap (USD): ' + str(data['data']['DOGE']['quote']['USD']['market_cap'])) doge_price = str(data['data']['DOGE']['quote']['USD']['price']) market_cap = str(data['data']['DOGE']['quote']['USD']['market_cap']) from datetime import datetime time = datetime.now() time = str(time) comp_data = '🚀' + '1 Doge =' + ' ' + doge_price + ' ' + '(USD)' + ' ' + ' • Time:' + ' ' + time + ' • Market Cap: ' + market_cap + '🚀' import requests #the data that we need to Post post_data = {'content': comp_data, 'channel_id': RIPLEDD_DOGEBOT_SECURE_ID, 'cateogry': 'Automated'} #Sending the data requests.post( url="https://ripledd.com/api/post/create.php", data=post_data, headers={"HTTP-SECURE-ID": RIPLEDD_AUTH_SECURE_ID} )

For More Info you can check the API Docs



4. Widgets

Widgets allows you to integrate Ripledd into your website or other projects. For example you are able to create your channel's feed widget. These widgets are updating alongside with changes you make on your channel or content. Below documentation will show you different widgets and their code. All widgets are working via "Iframe" tag.



Channel preview:
<iframe style="transform:scale(0.6);border:solid 1px transparent;" src="https://ripledd.com/embed/u?u=ripledd" width="470px;" height="500px;"></iframe>
Replace "ripledd" after "u=" with own channel url. You can control scale by modifying "transform:scale(0.6);".



Channel feed:
<iframe width="450" height="700" src="https://ripledd.com/embed/channel?dark-c=scosmology" title="Ripledd - Channel" frameborder="0" allow="accelerometer; autoplay; encrypted-media; picture-in-picture" allowfullscreen></iframe>
Replace "scosmology" after "c=" with own channel url. To change feed theme to light replace "dark-c=" with just "c=".



Post/Mediaplayer:


<iframe style="transform: scale(0.7);" width="560" height="315" src="https://ripledd.com/content/8e9b3d9569" scrolling="no" title="Ripledd video player" frameborder="0" allow="accelerometer; autoplay; encrypted-media; picture-in-picture" allowfullscreen></iframe>
Add post's id after "p=" in which you want to embed media from. You can control scale by modifying "transform:scale(0.7);".





5. Source Code

Ripledd is an open source project. You can view and use our code in your projects here. There are still some exceptions, please read RFSL license before accessing Ripledd's open source structure.

You can read RFSL license on these sources:
-> Read on page
-> Open as PDF

For companies or group of people:
The license above allows use by up to 10 number of users per company or any other group. For determining the number of users, "you" includes all affiliates, meaning legal entities controlling, controlled by, or under common control with you. If you exceed the Use Limitation, your use is subject to payment of Licensor’s then-current list price for licenses. The price for individual group that exceeds this limitation is not stable, please contact support@ripledd.com for more information.