gistfile1.txt

141{
142    REQ_CMD: "APP:CMD" 
143    REQ:
144    {
145        app_id*:            <string>
146        profile_id*:        <string>
147        cmd: "POST:TOP_LEVEL_COMMENTS:GET" 
148        params:
149        {
150            entity_id*:                         <string>
151            // from 0 to 10
152            include_sub_level_comments_number:  <integer>
153            // default: "desc" 
154            sort_order:                         <asc|desc>
155            // default: 101 (default mongodb batch size)
156            limit_total:                        <integer>
157            limit_after_comment_id:             <string>
158            limit_before_comment_id:            <string>
159        }
160    }
161}
162
163// success reply
164{
165    REP_TYPE:   "REPLY" 
166    REP_STATUS: "SUCCESS" 
167    REP:
168    {
169        data: {
170            comments: [
171                { /* comment object */ },
172                // ...
173            ]
174            // this is number of all comments for the supplied "entity_id" 
175            comments_total:             <integer>
176            // only top-level comments for the supplied "entity_id" 
177            top_level_comments_total:   <integer>
178            meta: {
179                revision:                       <string>
180                entity_comments_notifications:  <boolean>
181                user: {
182                    comments_total:             <integer>
183                }
184            }
185        }
186    }
187}