Added api for thread update in json

boards/views/api.py

@@ -15,6 +15,10 b' from boards.views import _datetime_to_ep'
 PARAMETER_TRUNCATED = 'truncated'
 PARAMETER_TAG = 'tag'
 PARAMETER_OFFSET = 'offset'
+PARAMETER_DIFF_TYPE = 'type'
+
+DIFF_TYPE_HTML = 'html'
+DIFF_TYPE_JSON = 'json'
 
 
 @transaction.atomic
@@ -37,10 +41,15 b' def api_get_threaddiff(request, thread_i'
     updated_posts = Post.objects.filter(thread_new=thread,
                                         pub_time__lte=filter_time,
                                         last_edit_time__gt=filter_time)
+
+    diff_type = DIFF_TYPE_HTML
+    if PARAMETER_DIFF_TYPE in request.GET:
+        diff_type = request.GET[PARAMETER_DIFF_TYPE]
+
     for post in added_posts:
-        json_data['added'].append(get_post(request, post.id).content.strip())
+        json_data['added'].append(_get_post_data(post.id, diff_type, request))
     for post in updated_posts:
-        json_data['updated'].append(get_post(request, post.id).content.strip())
+        json_data['updated'].append(_get_post_data(post.id, diff_type, request))
     json_data['last_update'] = _datetime_to_epoch(thread.last_edit_time)
 
     return HttpResponse(content=json.dumps(json_data))
@@ -127,16 +136,8 b' def api_get_threads(request, count):'
     for thread in threads:
         opening_post = thread.get_opening_post()
 
-        # TODO Add pub time, tags, replies and images count
-        post_json = {
-            'id': opening_post.id,
-            'title': opening_post.title,
-            'text': opening_post.text.rendered,
-        }
-        if opening_post.image:
-            post_json['image'] = opening_post.image.url
-            post_json['image_preview'] = opening_post.image.url_200x150
-        opening_posts.append(post_json)
+        # TODO Add tags, replies and images count
+        opening_posts.append(_get_post_data(opening_post.id))
 
     return HttpResponse(content=json.dumps(opening_posts))
 
@@ -171,7 +172,17 b' def api_get_thread_posts(request, openin'
     json_post_list = []
 
     for post in posts:
-        # TODO Add pub time and replies
+        json_post_list.append(_get_post_data(post.id))
+
+    return HttpResponse(content=json.dumps(json_post_list))
+
+
+# TODO Add pub time and replies
+def _get_post_data(post_id, format_type=DIFF_TYPE_JSON, request=None):
+    if format_type == DIFF_TYPE_HTML:
+        return get_post(request, post_id).content.strip()
+    elif format_type == DIFF_TYPE_JSON:
+        post = get_object_or_404(Post, id=post_id)
         post_json = {
             'id': post.id,
             'title': post.title,
@@ -180,6 +191,4 b' def api_get_thread_posts(request, openin'
         if post.image:
             post_json['image'] = post.image.url
             post_json['image_preview'] = post.image.url_200x150
-        json_post_list.append(post_json)
-
-    return HttpResponse(content=json.dumps(json_post_list))
+        return post_json

docs/api.markdown

@@ -7,30 +7,50 b' Tha data is returned in the json format '
 
 # METHODS #
 
+## Threads ##
+
     /api/threads/N/?offset=M&tag=O
 
-Get a thread list. You will get N threads (required parameter) starting from
-Mth one (optional parameter, default is 0) with the tag O (optional parameter,
+Get a thread list. You will get ``N`` threads (required parameter) starting from
+``M``th one (optional parameter, default is 0) with the tag ``O`` (optional parameter,
 threads with any tags are shown by default).
 
+## Tags ##
+
     /api/tags/
 
 Get all active tag list. Active tag is a tag that has at least 1 active thread
 associated with it.
 
+## Thread ##
+
     /api/thread/N/
 
-Get all Nth thread post. N is an opening post ID for the thread.
+Get all ``N``th thread post. ``N`` is an opening post ID for the thread.
+
+## Thread diff ##
+
+    /api/diff_thread/N/M/?type=O
+
+Get the diff of the thread with id=``N`` from the ``M`` timestamp in the ``O`` 
+format. 2 formats are available: ``html`` (used in AJAX thread update) and 
+``json``. The default format is ``html``. Return list format:
+
+* ``added``: list of added posts
+* ``updated``: list of updated posts
+* ``last_update``: last update timestamp
+
+## General info ##
 
 In case of incorrect request you can get http error 404.
 
 Response JSON contains:
 
-* id
-* title
-* text
-* image (if image available)
-* image_preview (if image available)
+* ``id``
+* ``title``
+* ``text``
+* ``image`` (if image available)
+* ``image_preview`` (if image available)
 
 In future, it will also contain: