{% extends "default.html" %} {% block title %} {{SITE_NAME}} - API {% endblock %} {% block content %}


API Guide for Bots


This page explains how to obtain and use an access token.

Step 1: Create your Application

In the apps tab of Drama settings, fill in and submit the form to request an access token. You will need:

Don't worry too much about accuracy; you will be able to change all of these later.

Drama administrators will review and approve or deny your request for an access token. You'll know when your request has been approved when you get a private message with an access token tied to your account.

DO NOT reveal your Client ID or Access Token. Anyone with these information will be able to pretend to be you. You are responsible for keeping them a secret!

Step 2: Using the Access Token

To use the access token, include the following header in subsequent API requests to Drama: Authorization: access_token_goes_here

Python example:

	import requests

	headers={"Authorization": "access_token_goes_here"}

	url="https://rdrama.net/@carpathianflorist"

	r=requests.get(url, headers=headers)

	print(r.json())

The expected result of this would be a large JSON representation of the posts posted by @carpathianflorist








API Guide for Applications


The OAuth2 authorization flow is used to enable users to authorize third-party applications to access their Drama account without having to provide their login information to the application.

This page explains how to obtain API application keys, how to prompt a user for authorization, and how to obtain and use access tokens.

Step 1: Create your Application

In the apps tab of Drama settings, fill in and submit the form to request new API keys. You will need:

Don't worry too much about accuracy; you will be able to change all of these later.

Drama administrators will review and approve or deny your request for API keys. You'll know when your request has been approved when you get a private message with an access token tied to your account.

DO NOT reveal your Client ID or Access Token. Anyone with these information will be able to pretend to be you. You are responsible for keeping them a secret!

Step 2: Prompt Your User for Authorization

Send your user to https://rdrama.net/authorize/?client_id=YOUR_CLIENT_ID

If done correctly, the user will see that your application wants to access their Drama account, and be prompted to approve or deny the request.

Step 3: Catch the redirect

The user clicks "Authorize". Drama will redirect the user's browser to GET the designated redirect URI. The access token URL parameter will be included in the redirect, which your server should process.

Step 4: Using the Access Token

To use the access token, include the following header in subsequent API requests to Drama: Authorization: access_token_goes_here

Python example:

	import requests

	headers={"Authorization": "access_token_goes_here"}

	url="https://rdrama.net/@carpathianflorist"

	r=requests.get(url, headers=headers)

	print(r.json())

The expected result of this would be a large JSON representation of the submissions submitted by @carpathianflorist

{% endblock %}