collection.json

{
	"variables": [],
	"info": {
		"name": "NineCardsV2",
		"_postman_id": "7601ac68-2dd7-e1a6-c4d2-e8c501937867",
		"description": "",
		"schema": "https://schema.getpostman.com/json/collection/v2.0.0/collection.json"
	},
	"item": [
		{
			"name": "Accounts of Clients, Users and Installations",
			"description": "Endpoints to create a Nine Cards user account and to edit its details",
			"item": [
				{
					"name": "Signup",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/login",
						"method": "POST",
						"header": [
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n    \"email\": \"user@example.com\",\n    \"androidId\":\"111a-bbb2-cc3-4444f\",\n    \"tokenId\":\"{{OBTAIN_TOKEN_ID}}\"\n}"
						},
						"description": "Signs up a client (user and device) within the Nine Cards Backend.\n\nIts response should include the new client's session token and its api key."
					},
					"response": []
				},
				{
					"name": "Update installation",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/installations",
						"method": "PUT",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": " { \n     \"deviceToken\": \"anndevtok\" \n }"
						},
						"description": ""
					},
					"response": []
				}
			]
		},
		{
			"name": "Android Apps",
			"description": "Endpoints for querying data about applications.",
			"item": [
				{
					"name": "Categorize a list of Apps",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/applications/categorize",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"items\" : [\n\t\t\"com.google.android.youtube\",\n\t\t\"com.google.android.gm\",\n\t\t\"com.facebook.katana\",\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n\t]\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Details of a list of apps",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/applications/details",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"items\" : [\n\t\t\"com.google.android.youtube\",\n\t\t\"com.google.android.gm\",\n\t\t\"com.facebook.katana\",\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n\t]\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Rank a list of Apps",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/applications/rank",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"location\" : \"ES\",\n\t\"items\" : {\n\t\t\"NEWS_AND_MAGAZINES\" : [ \"flipboard.app\", \"com.twitter.android\" ],\n\t\t\"VIDEO_PLAYERS\" : [ \"com.google.android.videos\", \"com.google.android.youtube\"]\n\t}\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Icon and Name of Apps ",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/applications/details?slice=icon",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"items\" : [\n\t\t\"com.google.android.youtube\",\n\t\t\"com.google.android.gm\",\n\t\t\"com.facebook.katana\",\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n\t]\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Store an App Data as Permanent",
					"request": {
						"auth": {
							"type": "basic",
							"basic": {
								"username": "local",
								"password": "local",
								"saveHelperData": true,
								"showPassword": false
							}
						},
						"url": "{{scheme}}://{{authority}}{{root_path}}/applications/details/one.false.package",
						"method": "PUT",
						"header": [
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Authorization",
								"value": "Basic bG9jYWw6bG9jYWw=",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"title\" : \"The False APP\",\n\t\"free\" : true,\n\t\"icon\" : \"http://the.false.icon\",\n\t\"downloads\": \"millions and billions\",\n\t\"stars\" : 1.414236562,\n\t\"categories\": [\"SOCIAL\"],\n\t\"screenshots\" : [\"http://one.false.screenshot\"]\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Rank a list of Widgets",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/widgets/rank",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"location\" : \"ES\",\n\t\"items\" : [ \n\t\t\"com.buzzpia.aqua.appwidget.clock\",\n\t\t\"com.google.android.apps.genie.geniewidget\", \n\t\t\"com.google.android.deskclock\"\n\t],\n\t\"moments\": [\"NIGHT\"],\n\t\"limit\" : 10 \n}"
						},
						"description": ""
					},
					"response": []
				}
			]
		},
		{
			"name": "Collections",
			"description": "",
			"item": [
				{
					"name": "Get Published Collections",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/collections",
						"method": "GET",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": ""
						},
						"description": "Gets the list of collections that a user (the sender) has published. "
					},
					"response": []
				},
				{
					"name": "Publish (create) a new  Shared Collection",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/collections",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n    \"author\": \"John Doe\",\n    \"name\": \"Social World\",\n    \"category\": \"SOCIAL\",\n    \"community\": true,\n    \"icon\": \"social\",\n    \"installations\" : 11,\n    \"views\" : 12,\n    \"packages\": [\n        \"com.whatsapp\",\n        \"org.telegram.messenger\",\n        \"com.snapchat.android\",\n        \"com.facebook.katana\"\n    ]\n}"
						},
						"description": "This endpoint allows a user, the sender, to publish a shared collection as the author of it."
					},
					"response": []
				},
				{
					"name": "Read a Collection",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/collections/{{collection_id}}",
						"method": "GET",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": ""
						},
						"description": "Read the details of an existing Collection,"
					},
					"response": []
				},
				{
					"name": "Edit a Collection",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/collections/{{collection_id}}",
						"method": "PUT",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"collectionInfo\" : {\n\t\t\"title\" : \"Social Plus, the greatest collection of Social apps!\"\n\t},\n    \"packages\": [\n        \"com.whatsapp\",\n        \"com.snapchat.android\",\n        \"com.facebook.katana\",\n        \"com.google.android.apps.plus\"\n    ]\n}"
						},
						"description": "Edit a collection that was publish by the user. "
					},
					"response": []
				}
			]
		},
		{
			"name": "Rankings",
			"description": "Endpoints to query and update the application rankings that \nare kept for each country or continent",
			"item": [
				{
					"name": "Get Rankings of Country",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/rankings/countries/ES",
						"method": "GET",
						"header": [
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \t\"packages\" : [ \n\t\t\"com.google.android.youtube\",\n\t\t\"com.google.android.gm\",\n\t\t\"com.facebook.katana\"\n  \t],\n  \t\"excludePackages\" : [\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n  \t],\n  \t\"limitPerApp\" : 4,\n  \t\"limit\" : 10\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Get Rankings of World",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/rankings/world",
						"method": "GET",
						"header": [
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \t\"packages\" : [ \n\t\t\"com.google.android.youtube\",\n\t\t\"com.google.android.gm\",\n\t\t\"com.facebook.katana\"\n  \t],\n  \t\"excludePackages\" : [\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n  \t],\n  \t\"limitPerApp\" : 4,\n  \t\"limit\" : 10\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Reload Rankings of Country",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/rankings/countries/ES",
						"method": "POST",
						"header": [
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "X-Google-Analytics-Token",
								"value": "{{google_analytics_token}}",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"startDate\": \"2016-01-01\",\n  \"endDate\": \"2016-03-31\",\n  \"rankingLength\": 10\n}\n"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Reload Rankings of World",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/rankings/world",
						"method": "POST",
						"header": [
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "X-Google-Analytics-Token",
								"value": "{{google_analytics_token}}",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"startDate\": \"2016-01-01\",\n  \"endDate\": \"2016-03-31\",\n  \"rankingLength\": 10\n}\n"
						},
						"description": ""
					},
					"response": []
				}
			]
		},
		{
			"name": "Recommend Applications",
			"description": "",
			"item": [
				{
					"name": "Recommend by list of apps",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/recommendations",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \t\"packages\" : [ \n\t\t\"com.google.android.youtube\",\n\t\t\"com.google.android.gm\",\n\t\t\"com.facebook.katana\"\n  \t],\n  \t\"excludePackages\" : [\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n  \t],\n  \t\"limitPerApp\" : 4,\n  \t\"limit\" : 10\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Recommend by Category",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/recommendations/SOCIAL/FREE",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \t\"excludePackages\" : [\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n  \t],\n  \t\"limit\" : 10\n}"
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Search apps by Word",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/applications/search",
						"method": "POST",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{user_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{user_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "X-Google-Play-Token",
								"value": "{{google_play_token}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"query\" : \"Write\" , \n  \t\"excludePackages\" : [\n\t\t\"com.twitter.android\",\n\t\t\"flipboard.app\"\n  \t],\n  \t\"limit\" : 10\n}"
						},
						"description": ""
					},
					"response": []
				}
			]
		},
		{
			"name": "Subscriptions",
			"description": "Endpoints about the subscription relations between a user \n(the sender) and other users' collections. ",
			"item": [
				{
					"name": "List of Subscribed Collections",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/collections/subscriptions",
						"method": "GET",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{subscriber_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{subscriber_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{}"
						},
						"description": "This endpoint gives the list of shared collections a user (the sender) is subscribed to"
					},
					"response": []
				},
				{
					"name": "Subscribe Shared Collection",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/collections/subscriptions/{{collection_id}}",
						"method": "PUT",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{subscriber_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{subscriber_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							},
							{
								"key": "Content-Type",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": ""
						},
						"description": ""
					},
					"response": []
				},
				{
					"name": "Unsubscribe Shared Collection",
					"request": {
						"url": "{{scheme}}://{{authority}}{{root_path}}/collections/subscriptions/{{collection_id}}",
						"method": "DELETE",
						"header": [
							{
								"key": "X-Session-Token",
								"value": "{{subscriber_sessionToken}}",
								"description": ""
							},
							{
								"key": "X-Android-ID",
								"value": "{{subscriber_androidId}}",
								"description": ""
							},
							{
								"key": "X-Auth-Token",
								"value": "{{COMPUTE_AUTH_TOKEN}}",
								"description": ""
							},
							{
								"key": "Accept",
								"value": "application/json",
								"description": ""
							}
						],
						"body": {
							"mode": "raw",
							"raw": ""
						},
						"description": ""
					},
					"response": []
				}
			]
		}
	]
}