发表评论接口

注意:AKCMS已于2019年12月27日宣布停止更新,此文档仅供老用户参考,不建议新用户选择AKCMS建站。
注意:AKCMS6.1.2已取消授权机制,文档中关于授权、服务、技术支持等的内容均已失效。

【3.0.2后可用】

AKCMS安装成功后会在站点根目录生成一系列接口文件,其中akcms_comment.php是发表评论接口。与AKCMS的其他接口一样,此接口也不建议直接调用,建议将接口包装一下再调用。

<?php
include("akcms_comment.php");
?>

此接口接受评论默认是需要验证码的,请将验证码的sid和用户输入按照下方介绍传过来。如果不想开启验证码,需要在包装接口时,在include之前增加一句:$nocaptcha = 1;

这个接口通过POST方式接受页面传过来的评论信息,接受以下字段:

itemid:评论的文章ID(必填)
comment:评论内容(必填)
username:评论人姓名
title:评论题目
captcha:用户填写的验证码
sid:验证码的唯一ID

如果后台开启了评论验证码功能,则captcha和sid两个字段也必须提供。

评论提交后以数字的形式返回评论结果,数字码代表的含义如下:
0 成功
1 itemid未提供
2 comment未提供
3 要评论的文章不存在
101 开启验证码,但未传值
102 验证码错误

可以通过Ajax方式调用评论接口,然后根据返回的数字给出对应的提示信息。