{"_id":"55bb614f7313650d00c46e88","category":{"_id":"5540ce1c31827a0d007ab1d0","version":"5540ce1c31827a0d007ab1cf","pages":["5540ce1d31827a0d007ab1d2","5540ff9dbb9e762d00f59557","554109205cf9682100d61b65","554109c35cf9682100d61b6b","55a635b6249a40190051d9a2","55bb5de0a8400c2d00873e19","55bb5f4174f10a0d002209a2","55bb607374f10a0d002209a6","55bb614f7313650d00c46e88","55bb61d8a8400c2d00873e20","55bb629874f10a0d002209aa","55bb6318a8400c2d00873e23","55bb63a07313650d00c46e8a","55d5dc84988e130d000b4110","5620b53d40e2c30d0002a848","567cfe57221af70d00fc5498","567d01fd221af70d00fc549c"],"project":"5540ce1b31827a0d007ab1cc","__v":17,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-29T12:27:08.888Z","from_sync":false,"order":1,"slug":"remote-api","title":"Remote API"},"parentDoc":null,"project":"5540ce1b31827a0d007ab1cc","__v":9,"user":"5540cdbf5cf9682100d61a97","version":{"_id":"5540ce1c31827a0d007ab1cf","project":"5540ce1b31827a0d007ab1cc","__v":31,"createdAt":"2015-04-29T12:27:08.390Z","releaseDate":"2015-04-29T12:27:08.390Z","categories":["5540ce1c31827a0d007ab1d0","5540d91bbb9e762d00f594ad","5540e5f131827a0d007ab212","5540e5febb9e762d00f594d3","5540e61331827a0d007ab213","5540e6195cf9682100d61afa","5540e62631827a0d007ab214","5540e63031827a0d007ab215","5540e63531827a0d007ab216","5540e63e5cf9682100d61afc","5540e6445cf9682100d61afd","5540e64a5cf9682100d61afe","55a4ff5b2e70c0250038050f","55acb28318eefd0d0071d504","55ae1abe8576b92300291c80","55ae453ef302af23000ac109","55af586d555b900d0036d296","55af91dac8a85321007a53c3","55b9fee204775a2f00628071","55b9ff0e04775a2f00628072","55b9ff4604775a2f00628073","55b9ff5fd72d1e1900276a38","55b9ff7f04775a2f00628074","55b9ff90eb08801900f833e5","55b9ffa5d72d1e1900276a39","55b9ffca04775a2f00628075","55b9fffdd72d1e1900276a3a","56bc2f033ee9e70d008b46af","56c2f6efbbf9ec2d00e0fe4f","57595bbb18760817001e8bbe","57d8d9793916800e003dde53"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-07-31T11:51:43.049Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","examples":{"codes":[{"code":"{\n   \"request\":{\n      \"application\":\"DEAD0-BEEF0\",\n      \"hwid\": \"device hardware id\",\n      \"tags\": {\n           \"StringTag\": \"string value\",\n           \"IntegerTag\": 42,\n           \"ListTag\": [\"string1\",\"string2\"],\n\t         \"DateTag\": \"2015-10-02 22:11\", //note the time is in UTC\n           \"BooleanTag\": true,  // valid values are - true, 1, false, 0, null\n      }  \n   }\n}","language":"json"}]},"method":"post","results":{"codes":[{"name":"","code":"{\n   \"status_code\":200,\n   \"status_message\":\"OK\",\n   \"response\": null\n}","language":"json","status":200}]},"auth":"required","params":[{"_id":"58a642eabb4c130f00dbbb2e","ref":"","in":"body","required":true,"desc":"Your Pushwoosh application ID","default":"","type":"string","name":"request.application"},{"_id":"58a642eabb4c130f00dbbb2d","ref":"","in":"body","required":true,"desc":"Hardware device id used in `/registerDevice` function call","default":"","type":"string","name":"request.hwid"},{"_id":"58a642eabb4c130f00dbbb2c","ref":"","in":"body","required":true,"desc":"JSON Object of tags to set, send `null` to remove the value","default":"","type":"object","name":"request.tags"}],"url":"/setTags"},"isReference":false,"order":9,"body":"Set tag values for the device.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"The method is called from SDK. It is possible to call it remotely from your backend, however you need to maintain an up-to-date database of hwid’s on the backend side.\",\n  \"title\": \"Important\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Please avoid setting more that 50 tag values in a single /setTags request.\"\n}\n[/block]\n## Status codes: \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"HTTP Status code\",\n    \"h-1\": \"status_code\",\n    \"h-2\": \"Description\",\n    \"0-2\": \"Tags have been successfully set\",\n    \"1-2\": \"Argument error. See status_message for more info\",\n    \"2-2\": \"Malformed request string\",\n    \"3-2\": \"Internal error\",\n    \"3-0\": \"500\",\n    \"3-1\": \"500\",\n    \"2-1\": \"N/A\",\n    \"1-1\": \"210\",\n    \"0-1\": \"200\",\n    \"0-0\": \"200\",\n    \"1-0\": \"200\",\n    \"2-0\": \"400\"\n  },\n  \"cols\": 3,\n  \"rows\": 4\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?php\\n//see http://gomoob.github.io/php-pushwoosh/set-tags.html\\nuse Gomoob\\\\Pushwoosh\\\\Model\\\\Request\\\\SetTagsRequest;\\n\\n// Creates the request instance\\n$request = SetTagsRequest::create()\\n    ->setTags(\\n        array(\\n            'StringTag' => 'string value',\\n            'IntegerTag' => 'integer value',\\n            'ListTag' => ['string1', 'string2']\\n        )\\n    )\\n    ->setHwid('HWID');\\n\\n// Call the '/setTags' Web Service\\n$response = $pushwoosh->setTags($request);\\n\\nif($response->isOk()) {\\n    print 'Ok, operation successful.';\\n} else {\\n    print 'Oups, the operation failed :-('; \\n    print 'Status code : ' . $response->getStatusCode();\\n    print 'Status message : ' . $response->getStatusMessage();\\n}\",\n      \"language\": \"php\"\n    }\n  ]\n}\n[/block]","excerpt":"Set tag values for the device. (Called from the SDK)","slug":"settags","type":"endpoint","title":"/setTags"}

post/setTags

Set tag values for the device. (Called from the SDK)

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

request.application:
required
string
Your Pushwoosh application ID
request.hwid:
required
string
Hardware device id used in `/registerDevice` function call
request.tags:
required
object
JSON Object of tags to set, send `null` to remove the value

Examples


Result Format


Documentation

Set tag values for the device. [block:callout] { "type": "info", "body": "The method is called from SDK. It is possible to call it remotely from your backend, however you need to maintain an up-to-date database of hwid’s on the backend side.", "title": "Important" } [/block] [block:callout] { "type": "warning", "body": "Please avoid setting more that 50 tag values in a single /setTags request." } [/block] ## Status codes: [block:parameters] { "data": { "h-0": "HTTP Status code", "h-1": "status_code", "h-2": "Description", "0-2": "Tags have been successfully set", "1-2": "Argument error. See status_message for more info", "2-2": "Malformed request string", "3-2": "Internal error", "3-0": "500", "3-1": "500", "2-1": "N/A", "1-1": "210", "0-1": "200", "0-0": "200", "1-0": "200", "2-0": "400" }, "cols": 3, "rows": 4 } [/block] [block:code] { "codes": [ { "code": "<?php\n//see http://gomoob.github.io/php-pushwoosh/set-tags.html\nuse Gomoob\\Pushwoosh\\Model\\Request\\SetTagsRequest;\n\n// Creates the request instance\n$request = SetTagsRequest::create()\n ->setTags(\n array(\n 'StringTag' => 'string value',\n 'IntegerTag' => 'integer value',\n 'ListTag' => ['string1', 'string2']\n )\n )\n ->setHwid('HWID');\n\n// Call the '/setTags' Web Service\n$response = $pushwoosh->setTags($request);\n\nif($response->isOk()) {\n print 'Ok, operation successful.';\n} else {\n print 'Oups, the operation failed :-('; \n print 'Status code : ' . $response->getStatusCode();\n print 'Status message : ' . $response->getStatusMessage();\n}", "language": "php" } ] } [/block]

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}