Custom API Howto (zh_CN)

设定API

设定API需要在登录界面内，因为认证方式复杂，所以目前必须重新登录。

右上角第一个菜单项就是“编辑API”

一般情况下后两项不需要也不能修改

###JTAPI###

####OpenShift####

假设 "https://jtapi.rhcloud.com/" 是你的jtapi地址。

API URL Format 设定为 "https://jtapi.rhcloud.com/domain.[DOMAIN]/"

认证方式选择 "OAuth" 。

点击“自定义主机映射”，从映射列表中排除“jtapi.rhcloud.com”。

####AppEngine（被墙）####

假设 "https://myjtapi.appspot.com/" 是你的jtapi地址。

API URL Format 设定为 "https://[DOMAIN].myjtapi.appspot.com/"

认证方式选择 "OAuth" 。

点击右上角的扳手进入“设定”-“网络”。启用“忽略SSL错误”（可选：启用“TCP DNS 查询方式”）。

点击“自定义主机映射”，添加一项。第一行写“appspot.com”，第二行写“www.google.com”或者从SmartHosts项目中找到的你喜欢的Google的IP。

###GTAP###

假设 "mygtap" 是你的应用ID。

API URL Format 设定为 https://mygtap.appspot.com/[DOMAIN]/

认证方式选择 "Basic" 。

###Twip###

请更新到twip最新版

• Twip O 模式

假设 "https://example.com/twip/o/password/" 是你获得的API地址。

API URL Format 设定为 "https://example.com/twip/o/password/"

• Twip T 模式

假设 "https://example.com/twip/" 是你的twip地址。

REST Base URL 设定为 "https://example.com/twip/t/1.1/" （不要丢了末尾的 "/" ！）

OAuth Base URL 设定为 "https://example.com/twip/t/oauth/" （不要丢了末尾的 "/" ！）

认证方式选择 "OAuth" 。

搭建API

###Nginx 反向代理###

###Twidere-API-Proxy-Go###

###jtapi 太麻烦，弃了###

• 假设你部署时想用 myjtapi 作为 AppID。

• 去 Google App Engine 用 Google Account 账户登录，申请一个新的 app。别的不用管。假设 https://myjtapi.appspot.com/"是你的API地址。

• 可能需要 Oracle 的 JDK，需要JDK 7以上。

• 下载并解压 appengine-java-sdk

• 到 jtapi 的页面，找到 dist 目录，点击下载最新版，假设最新版为0.5，那么它的整数版本号就是5。

• 解压，找到 WEB-INF 目录。为了方便起见，我们在App Engine SDK的目录下创建目录 jtapi ，并把 WEB-INF 复制到 jtapi 中。

  • Windows下的部署

  假设我们把下载好的 appengine-java-sdk-1.8.9.zip 解压到了 D:\ 下面。执行如下命令。

  打开命令提示符。

  D:\
  cd appengine-java-sdk-1.8.9
  bin\appcfg.cmd -A myjtapi update jtapi
  bin\appcfg.cmd -A myjtapi set_default_version jtapi 5
  

  • Linux下的部署

  打开终端

  假设我们把下载好的 appengine-java-sdk-1.8.9.zip 解压到了 ~/ 下面。执行如下命令。

  cd ~/appengine-java-sdk-1.8.9
  ./bin/appcfg.sh -A myjtapi update jtapi
  ./bin/appcfg.sh -A myjtapi set_default_version jtapi 5

在提示输入用户名密码时输入后，看到 “Update completed successfully.” 你就成功了，用浏览器打开的话，应该会看到如下内容：

JTAPI 0.5 is running!
--------------------------------
Rest Base URL:		https://api.myjtapi.appspot.com/1.1/
OAuth Base URL: 	https://api.myjtapi.appspot.com/oauth/
--------------------------------
How to use with Twidere:
Enable "Ignore SSL Error", then set above URLs (It's better to use HTTPS.)
--------------------------------