====== JSON命令参考 ======

(添加这里完成JSON命令参考)

===== 编码 =====

JSON数据使用UTF-8编码。

二进制字段 (如 sig_p 字段签名来自B编码的DHT资源) 必须被转换到十六进制表示为字符串。

===== 快速JSON命令例子 =====

来使用JSON-RPC您必须使用命令行或配置文件来设置用户名/密码/端口号。这和Bitcoin很相似，只是twister的配置文件在 /home/user/.twister/twister.conf

==== 添加数据库用户 ====

来创建一个新的(本地)用户私钥:

<code>
./twisterd createwalletuser 用户名
</code>

该命令将返回一个用户私钥并且可用于访问账户，用户应该将此私钥记录下来，并且不要泄漏。

新创建的用户只存在于本地数据库，所以在用户能够充分利用本系统前（如发送消息），他的公共密钥必须被使用下一个命令传播到网络上。

==== 发送新用户合同 ====

<code>
./twisterd sendnewusertransaction 用户名
</code>

根据您的CPU运算能力，上述命令可能需要几秒来运行，这很正常。

==== 发新帖 ====

来创建第一个公开的帖子：

<code>
./twisterd newpostmsg 用户名 1 "hello world"
</code>

==== 关注 ====

来填加一些用户到关注列表

<code>
./twisterd follow 用户名 '["用户名","被关注对象用户名"]'
</code>

==== 获取帖子 ====

来从我们关注的用户中获取最后5条帖子

<code>
./twisterd getposts 5 '[{"username":"用户名"},{"username":"被关注对象用户名"}]'
</code>

==== 新私信 ====

来发送一个新的（私人）信件：

<code>
./twisterd newdirectmsg 用户名 2 接收者 "秘密消息内容"
</code>

请注意 ''newdirectmsg'':

  * 帖子编号（2）是按照与'newpostmsg`相同编号方式而来的（使用编号2是因为我们已经使用上面那个命令已经使用编号1发了个帖子了），请确保他们不冲突。
  * 接收者必须是关注您的人。

==== 获取私信 ====

来获取最后10条向指定人员发送或接收的私信

<code>
./twisterd getdirectmsgs 我的用户名 10 '[{"username":"对方用户名"}]'
</code>

请注意 `getdirectmsgs`:

  * 这些私信ID (max_id, since_id 等) 与发贴id没有关系。该编号是本地的并且只用于特定的主题。
  * 该函数会返回已接收或已发送此同一台计算机被成功解密消息。在不同的电脑上使用相同的帐户将会看到同样的已接收的信息，但看不到同一个发送的消息。

==== dht命令 ====

详情在 [[zh:开发:dht_协议:结构#基本结构]]

=== dhtput ===

来设置您的个人资料

<code>
./twisterd dhtput 用户名 profile s '{"fullname":"我的昵称","bio":"自我介绍","location":"当前位置（随便写，如tianchao）","url":"个人网站（如：xiaolan.me）"}' 用户名 1
</code>

提示: 增加修订号 (最后一个参数) 当您想使用dhtput来更新一些东西的话。

=== dhtget ===

来获得其他用户的资料

<code>
./twisterd dhtget 其他人的帐号 profile s
</code>

去获得完整的命令列表

<code>
./twisterd help
</code>