App API (Expired)

1. Batch Create And Update Apps

1.1 Request URL

https://api.toponad.net/v1/deal_app

1.2 Request method

POST

1.3 Request params

params	type	required	notes
count	Int	Y	Quantity of created apps
apps.app_id	String	N	App ID (Incoming when modified)
apps.app_name	String	Y	App name
apps.platform	Int	Y	Platform 1 or 2 (1:android, 2:iOS)
apps.market_url	String	N	Need to be in compliance with requirements of app store links
apps.screen_orientation	Int	Y	1: Portrait 2: Landscape 3: Both
apps.package_name	String	N	Need to be in compliance with requirements of app package name. com.xxx
apps.category	String	N	Category. See the appendix (APP category and sub category enum) App that is not in the store at the time of creation must be passed.
apps.sub_category	String	N	Sub Category. See the appendix (APP category and sub category enum) App that is not in the store at the time of creation must be passed.
apps.coppa	String	N	Whether to comply with COPPA protocol. Default: no  1: No 2: Yes
apps.ccpa	String	N	Whether to comply with CCPA protocol. Default: no 1: No 2: Yes

1.4 Return data

fields	type	required	notes
app_id	String	Y	App ID
app_name	String	Y	App name
errors	String	N	Error messages
platform	Int	Y	Platform 1 or 2 (1:android, 2:iOS)
screen_orientation	Int	Y	1: Portrait 2: Landscape 3: Both
apps.coppa	String	N	Whether to comply with COPPA protocol. Default: no 1: No 2: Yes
apps.ccpa	String	N	Whether to comply with CCPA protocol. Default: no 1: No 2: Yes

1.5 Sample

Request sample:

{
    "count": 1,
    "apps": [
        {
            "app_name": "oddman",
            "platform": 1,
            "screen_orientation":1,
            "market_url": "https://play.google.com/store/apps/details?id=com.hunantv.imgo.activity.inter"
        }
    ]
}

Return sample:

[
    {
        "app_name": "oddman",
        "app_id": "",
        "platform": 1,
        "screen_orientation": 1,
        "errors": "repeat app name error"
    }
]

2. Get App List

2.1 Request URL

https://api.toponad.net/v1/apps

2.2 Request method

POST

2.3 Request params

params	type	required	notes
app_ids	Array[String]	N	["abc", "acc"] (Cannot be used with the following parameters)
start	Int	N	Default 0
limit	Int	N	Default 100 , [0, 100]

2.4 Return data

fields	type	required	notes
app_id	String	Y	App ID
app_name	String	Y	App name
platform	Int	Y	Platform 1 or 2 (1: android, 2: iOS)
market_url	String	N	-
screen_orientation	Int	Y	1: Portrait 2: Landscape 3: Both
package_name	String	N	-
category	String	N	-
sub-category	String	N	-
apps.coppa	String	N	Whether to comply with COPPA protocol. Default: no  1: No 2: Yes
apps.ccpa	String	N	Whether to comply with CCPA protocol. Default: no 1: No 2: Yes

2.5 Sample

Request sample:

{
    "limit":1
}

Return sample:

[
    {
        "app_name": "uparputest",
        "app_id": "a5bc9921f7fdb4",
        "platform": 2,
        "market_url": "https://itunes.apple.com/cn/app/%E7%A5%9E%E5%9B%9E%E9%81%BF/id1435756371?mt=8",
        "category": "Game",
        "sub_category": "Action",
        "screen_orientation": 3
    }
]

3. Batch Delete Apps

3.1 Request URL

https://api.toponad.net/v1/del_apps

3.2 Request method

POST

3.3 Request params

params	type	required	notes
app_ids	Array[String]	Y	["abc", "acc"]

3.4 Return data

None. If it is an error, errors will be returned.

3.5 Sample

Request sample:

{
    "app_ids": ["a1bu2thutsq3mn"]
}

Return sample:

None. If it is an error, errors will be returned.