Aptoide - Web Services Documentation

setCommentVote

URLS:

POST

https://ws75-primary.aptoide.com/api/7/comment/setVote

https://ws75-primary.aptoide.com/api/7/setCommentVote

Supported Formats:

JSON

Supported Methods:

POST

Description:

Set a comment vote

Arguments:

Name

Description

Input

Details

access_token

Authentication access token.

TOKEN

Default:	null
Properties:	• Max length: 512
Example:	"cGF1bG8udHJlemVudG9zQGFwdG9pZGUuY29tOkF"

comment_id

Comment ID.

+INT31

Default:	null
Example:	1472559

info

Show API info page.

BOOLEAN

Default:	false
Example:	true

language

Language.

STRING

Default:	"en"
Properties:	• Min length: 2 • Max length: 6
Example:	"pt_PT"

vote

Vote.

STRING

Default:	null
Properties:	• Allowed values: "up", "down"
Example:	"up"

Mandatory arguments:

This endpoint requires 1 of the following possible combinations of arguments:

• comment_id AND vote

Arguments Aliases:

This endpoint has the following possible arguments aliases:

• language : lang

Inputs:

Name	Description	Examples
+INT31	31 bits positive integer: 1 to 2147483647	• 1 • 5024 • 70733
BOOLEAN	Boolean: FALSE (0, f, false, no, off) or TRUE (1, t, true, yes, on)	• 0 • 1 • true • "f"
STRING	String of characters	• "a" • "foobar" • "Some text"
TOKEN	Tokenized string of characters	• "ja-HK_1" • "AjgI74-ash_86jhgasorw-5234" • "1Eiayn9Suo3fcgKrQq8qHwCz3MP"

Response:

• application/json

Error Codes:

Name	Description	Http Code
API-1	Invalid value ... for argument '...'	400 Bad Request
API-2	Invalid output '...'	400 Bad Request
API-3	Missing mandatory arguments '...'	400 Bad Request
API-4	At least 1 node must be set	400 Bad Request
API-5	Malformed node at ...	400 Bad Request
API-6	Invalid node '...'	400 Bad Request
API-7	Missing mandatory arguments '...' for condition '...'	400 Bad Request
AUTH-1	Authentication required	401 Unauthorized
AUTH-2	Authentication failed: invalid '...'	401 Unauthorized
AUTH-3	Authentication failed: expired '...'	401 Unauthorized
AUTH-4	Authentication error	500 Internal Server Error
AUTH-5	Access denied: access level ... required	403 Forbidden
AUTH-6	Access denied: not in allowed groups	403 Forbidden
AUTH-7	Access denied: not in allowed countries	403 Forbidden
AUTH-8	Access denied: not in allowed IP addresses	403 Forbidden
AUTH-9	Access denied: not in allowed domains	403 Forbidden
AUTH-10	Access denied: not in allowed origins (CORS)	403 Forbidden
AUTH-11	Access denied: unauthorized user	403 Forbidden
AUTH-12	Access denied: unauthorized operation	403 Forbidden
COMMENT-1	Comment '...' not found	404 Not Found
COMMENT-2	Operation not allowed for comment	403 Forbidden
SYS-0	(╯°□°）╯︵ ┻━┻	417 Expectation Failed
SYS-1	An unknown system error occurred, please try again	500 Internal Server Error
SYS-2	The system is down for maintenance, please try again later	503 Service Unavailable
SYS-3	Operation timed out, please try again later	504 Gateway Timeout

Sample Request URL:

https://ws75-primary.aptoide.com/api/7/comment/setVote

Request POST data:

comment_id : 24114

vote : "up"

Sample Response (json):

{
   "info": {
      "status": "OK",
      "time": {
         "seconds": 0.015180110931396,
         "human": "15 milliseconds"
      }
   }
}