node-red-contrib-knx-ultimate
Version:
Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.
395 lines (365 loc) • 78.5 kB
HTML
<!DOCTYPE html><html lang="en-US"><head><script type="text/javascript" async="async" src="https://smetrics.marketing.meethue.com/b/ss/lightingprod/10/JS-2.20.0/s09483604732933?AQB=1&ndh=1&pf=1&callback=s_c_il%5B1%5D.doPostbacks&et=1&t=15%2F9%2F2025%208%3A29%3A39%203%20-120&d.&nsid=0&jsonv=1&.d&sdid=01694221DE301ED0-43342292181294F7&mid=67299572199683621102052901774297391420&aamlh=6&ce=UTF-8&ns=philipslighting&cdp=2&pageName=CP%3Ahue_developer_program_portal%3Aaccount&g=https%3A%2F%2Fdevelopers.meethue.com%2Fdevelop%2Fhue-api-v2%2Fgetting-started%2F&r=https%3A%2F%2Fdevelopers.meethue.com%2Fdevelop%2Fhue-api-v2%2F&c.&cm.&ssf=0&.cm&.c&cc=EUR&ch=CP%3Ahue_developer_program_portal&server=developers.meethue.com&events=event38&aamb=6G1ynYcLPuiQxYZrsz_pkqfLG9yMXBpb2zX5dvJdYQJzPXImdj0y&c1=global&h1=CP%2Fhue_developer_program_portal%2Faccount&c2=en&c3=CP&h3=com%2Fmeethue%2Fdevelopers&c4=D%3Dg&c5=CP%3Ahue_developer_program_portal%3Aaccount&c6=CP%3Ahue_developer_program_portal%3Alevel_not_set%3AL1%3Aaccount&v6=D%3Dmid&c7=CP%3Ahue_developer_program_portal%3Alevel_not_set%3AL1%3Aaccount&v7=D%3DpageName&c8=CP%3Ahue_developer_program_portal%3Alevel_not_set%3AL1%3Aaccount&c9=CP%3Ahue_developer_program_portal%3Alevel_not_set%3AL1%3Aaccount&c10=New&c11=CP%3Ahue_developer_program_portal%3Aexplore%3Ahue_apps_showcase&c12=45&v12=D%3Dc1&c15=Getting%20started%20-%20Philips%20Hue%20Developer%20Program&v15=D%3Dch&v16=D%3Dc5&c17=1.11.19&v17=D%3Dc6&c18=D%3DUser-Agent&v18=D%3Dc7&c19=D%3Ds_vi&v19=D%3Dc8&v20=D%3Dc9&v21=D%3Dc23&c23=92833469536034720&v26=D%3Dc3&v29=D%3Dg&c36=unknown&c37=645&c44=45%7C45&c45=1512x982&c46=1512x982&v46=2025-10-15%2006%3A00%20UTC&c47=L&v68=D%3Dr&c70=AM%3D2.20.0%3BjQ%3D3.5.1%3BTMS%3Dundefined%3BAT%3D2.8.0%3BSSL%3D1%3B3xx%3D0%3BCCN%3D1&v76=D%3Dc2&v111=D%3DUser-Agent&s=1512x982&c=24&j=1.6&v=N&k=Y&bw=1512&bh=982&mcorgid=AF93936257A37E0A7F000101%40AdobeOrg&AQE=1"></script>
<script src="https://www.lighting.philips.com/assets/scripts/tms_code.js"></script>
<meta charset="utf-8">
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="profile" href="http://gmpg.org/xfn/11">
<meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1">
<!-- Meta Tag Manager -->
<meta name="PHILIPS.METRICS.DIVISION" content="CP">
<meta name="PHILIPS.METRICS.COUNTRY" content="Global">
<meta name="PHILIPS.METRICS.LANGUAGE" content="En">
<meta name="PHILIPS.METRICS.SECTION" content="hue_developer_program_portal">
<meta name="PHILIPS.METRICS.MICROSITEID" content="UNKNOWN">
<meta name="PHILIPS.METRICS.PAGENAME" content="home">
<meta name="PHILIPS.METRICS.PAGENAME" content="explore">
<meta name="PHILIPS.METRICS.PAGENAME" content="develop">
<meta name="PHILIPS.METRICS.PAGENAME" content="support">
<meta name="PHILIPS.METRICS.PAGENAME" content="job_vacancies">
<meta name="PHILIPS.METRICS.PAGENAME" content="forum">
<meta name="PHILIPS.METRICS.PAGENAME" content="my_apps">
<meta name="PHILIPS.METRICS.PAGENAME" content="account">
<!-- / Meta Tag Manager -->
<!-- This site is optimized with the Yoast SEO plugin v23.5 - https://yoast.com/wordpress/plugins/seo/ -->
<title>Getting started - Philips Hue Developer Program</title>
<link rel="canonical" href="index.html">
<meta property="og:locale" content="en_US">
<meta property="og:type" content="article">
<meta property="og:title" content="Getting started - Philips Hue Developer Program">
<meta property="og:description" content="Follow 3 Easy Steps Step 1 First make sure your bridge is connected to your network and is functioning properly. Test that the official Philips Hue mobile app can control the lights on the same network. Step 2 Then you need to discover the IP address of the bridge on your network. You can do […]">
<meta property="og:url" content="https://developers.meethue.com/develop/hue-api-v2/getting-started/">
<meta property="og:site_name" content="Philips Hue Developer Program">
<meta property="article:modified_time" content="2022-05-05T07:34:41+00:00">
<meta property="og:image" content="https://developers.meethue.com/wp-content/uploads/2021/10/1-certificate-verification.png">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@philipshuedev">
<meta name="twitter:label1" content="Est. reading time">
<meta name="twitter:data1" content="7 minutes">
<script type="application/ld+json" class="yoast-schema-graph">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","@id":"https://developers.meethue.com/develop/hue-api-v2/getting-started/","url":"https://developers.meethue.com/develop/hue-api-v2/getting-started/","name":"Getting started - Philips Hue Developer Program","isPartOf":{"@id":"https://developers.meethue.com/#website"},"primaryImageOfPage":{"@id":"https://developers.meethue.com/develop/hue-api-v2/getting-started/#primaryimage"},"image":{"@id":"https://developers.meethue.com/develop/hue-api-v2/getting-started/#primaryimage"},"thumbnailUrl":"https://developers.meethue.com/wp-content/uploads/2021/10/1-certificate-verification.png","datePublished":"2021-09-19T23:44:01+00:00","dateModified":"2022-05-05T07:34:41+00:00","breadcrumb":{"@id":"https://developers.meethue.com/develop/hue-api-v2/getting-started/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https://developers.meethue.com/develop/hue-api-v2/getting-started/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https://developers.meethue.com/develop/hue-api-v2/getting-started/#primaryimage","url":"https://developers.meethue.com/wp-content/uploads/2021/10/1-certificate-verification.png","contentUrl":"https://developers.meethue.com/wp-content/uploads/2021/10/1-certificate-verification.png","width":778,"height":236},{"@type":"BreadcrumbList","@id":"https://developers.meethue.com/develop/hue-api-v2/getting-started/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://developers.meethue.com/"},{"@type":"ListItem","position":2,"name":"Develop","item":"https://developers.meethue.com/develop/"},{"@type":"ListItem","position":3,"name":"Hue API V2","item":"https://developers.meethue.com/develop/hue-api-v2/"},{"@type":"ListItem","position":4,"name":"Getting started"}]},{"@type":"WebSite","@id":"https://developers.meethue.com/#website","url":"https://developers.meethue.com/","name":"Philips Hue Developer Program","description":"Philips Hue Developer Program","publisher":{"@id":"https://developers.meethue.com/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://developers.meethue.com/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https://developers.meethue.com/#organization","name":"Signify","url":"https://developers.meethue.com/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https://developers.meethue.com/#/schema/logo/image/","url":"https://developers.meethue.com/wp-content/uploads/2019/03/Philips_Hue_Freestanding_1P_Vert_Jul20176.png","contentUrl":"https://developers.meethue.com/wp-content/uploads/2019/03/Philips_Hue_Freestanding_1P_Vert_Jul20176.png","width":591,"height":427,"caption":"Signify"},"image":{"@id":"https://developers.meethue.com/#/schema/logo/image/"},"sameAs":["https://x.com/philipshuedev"]}]}</script>
<!-- / Yoast SEO plugin. -->
<link rel="alternate" type="application/rss+xml" title="Philips Hue Developer Program » Feed" href="../../../feed/index.rss">
<link rel="alternate" type="application/rss+xml" title="Philips Hue Developer Program » Comments Feed" href="../../../comments/feed/index.rss">
<script type="text/javascript">
/* <![CDATA[ */
window._wpemojiSettings = {"baseUrl":"https:\/\/s.w.org\/images\/core\/emoji\/14.0.0\/72x72\/","ext":".png","svgUrl":"https:\/\/s.w.org\/images\/core\/emoji\/14.0.0\/svg\/","svgExt":".svg","source":{"concatemoji":"https:\/\/developers.meethue.com\/wp-includes\/js\/wp-emoji-release.min.js"}};
/*! This file is auto-generated */
!function(i,n){var o,s,e;function c(e){try{var t={supportTests:e,timestamp:(new Date).valueOf()};sessionStorage.setItem(o,JSON.stringify(t))}catch(e){}}function p(e,t,n){e.clearRect(0,0,e.canvas.width,e.canvas.height),e.fillText(t,0,0);var t=new Uint32Array(e.getImageData(0,0,e.canvas.width,e.canvas.height).data),r=(e.clearRect(0,0,e.canvas.width,e.canvas.height),e.fillText(n,0,0),new Uint32Array(e.getImageData(0,0,e.canvas.width,e.canvas.height).data));return t.every(function(e,t){return e===r[t]})}function u(e,t,n){switch(t){case"flag":return n(e,"\ud83c\udff3\ufe0f\u200d\u26a7\ufe0f","\ud83c\udff3\ufe0f\u200b\u26a7\ufe0f")?!1:!n(e,"\ud83c\uddfa\ud83c\uddf3","\ud83c\uddfa\u200b\ud83c\uddf3")&&!n(e,"\ud83c\udff4\udb40\udc67\udb40\udc62\udb40\udc65\udb40\udc6e\udb40\udc67\udb40\udc7f","\ud83c\udff4\u200b\udb40\udc67\u200b\udb40\udc62\u200b\udb40\udc65\u200b\udb40\udc6e\u200b\udb40\udc67\u200b\udb40\udc7f");case"emoji":return!n(e,"\ud83e\udef1\ud83c\udffb\u200d\ud83e\udef2\ud83c\udfff","\ud83e\udef1\ud83c\udffb\u200b\ud83e\udef2\ud83c\udfff")}return!1}function f(e,t,n){var r="undefined"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?new OffscreenCanvas(300,150):i.createElement("canvas"),a=r.getContext("2d",{willReadFrequently:!0}),o=(a.textBaseline="top",a.font="600 32px Arial",{});return e.forEach(function(e){o[e]=t(a,e,n)}),o}function t(e){var t=i.createElement("script");t.src=e,t.defer=!0,i.head.appendChild(t)}"undefined"!=typeof Promise&&(o="wpEmojiSettingsSupports",s=["flag","emoji"],n.supports={everything:!0,everythingExceptFlag:!0},e=new Promise(function(e){i.addEventListener("DOMContentLoaded",e,{once:!0})}),new Promise(function(t){var n=function(){try{var e=JSON.parse(sessionStorage.getItem(o));if("object"==typeof e&&"number"==typeof e.timestamp&&(new Date).valueOf()<e.timestamp+604800&&"object"==typeof e.supportTests)return e.supportTests}catch(e){}return null}();if(!n){if("undefined"!=typeof Worker&&"undefined"!=typeof OffscreenCanvas&&"undefined"!=typeof URL&&URL.createObjectURL&&"undefined"!=typeof Blob)try{var e="postMessage("+f.toString()+"("+[JSON.stringify(s),u.toString(),p.toString()].join(",")+"));",r=new Blob([e],{type:"text/javascript"}),a=new Worker(URL.createObjectURL(r),{name:"wpTestEmojiSupports"});return void(a.onmessage=function(e){c(n=e.data),a.terminate(),t(n)})}catch(e){}c(n=f(s,u,p))}t(n)}).then(function(e){for(var t in e)n.supports[t]=e[t],n.supports.everything=n.supports.everything&&n.supports[t],"flag"!==t&&(n.supports.everythingExceptFlag=n.supports.everythingExceptFlag&&n.supports[t]);n.supports.everythingExceptFlag=n.supports.everythingExceptFlag&&!n.supports.flag,n.DOMReady=!1,n.readyCallback=function(){n.DOMReady=!0}}).then(function(){return e}).then(function(){var e;n.supports.everything||(n.readyCallback(),(e=n.source||{}).concatemoji?t(e.concatemoji):e.wpemoji&&e.twemoji&&(t(e.twemoji),t(e.wpemoji)))}))}((window,document),window._wpemojiSettings);
/* ]]> */
</script>
<style id="wp-emoji-styles-inline-css" type="text/css">img.wp-smiley, img.emoji {
display: inline !important;
border: none !important;
box-shadow: none !important;
height: 1em !important;
width: 1em !important;
margin: 0 0.07em !important;
vertical-align: -0.1em !important;
background: none !important;
padding: 0 !important;
}
</style>
<link rel="stylesheet" id="wp-block-library-css" href="../../../wp-includes/css/dist/block-library/style.min.css" type="text/css" media="all">
<style id="classic-theme-styles-inline-css" type="text/css">/*! This file is auto-generated */
.wp-block-button__link{color:#fff;background-color:#32373c;border-radius:9999px;box-shadow:none;text-decoration:none;padding:calc(.667em + 2px) calc(1.333em + 2px);font-size:1.125em}.wp-block-file__button{background:#32373c;color:#fff;text-decoration:none}
</style>
<style id="global-styles-inline-css" type="text/css">body{--wp--preset--color--black: #000000;--wp--preset--color--cyan-bluish-gray: #abb8c3;--wp--preset--color--white: #ffffff;--wp--preset--color--pale-pink: #f78da7;--wp--preset--color--vivid-red: #cf2e2e;--wp--preset--color--luminous-vivid-orange: #ff6900;--wp--preset--color--luminous-vivid-amber: #fcb900;--wp--preset--color--light-green-cyan: #7bdcb5;--wp--preset--color--vivid-green-cyan: #00d084;--wp--preset--color--pale-cyan-blue: #8ed1fc;--wp--preset--color--vivid-cyan-blue: #0693e3;--wp--preset--color--vivid-purple: #9b51e0;--wp--preset--gradient--vivid-cyan-blue-to-vivid-purple: linear-gradient(135deg,rgba(6,147,227,1) 0%,rgb(155,81,224) 100%);--wp--preset--gradient--light-green-cyan-to-vivid-green-cyan: linear-gradient(135deg,rgb(122,220,180) 0%,rgb(0,208,130) 100%);--wp--preset--gradient--luminous-vivid-amber-to-luminous-vivid-orange: linear-gradient(135deg,rgba(252,185,0,1) 0%,rgba(255,105,0,1) 100%);--wp--preset--gradient--luminous-vivid-orange-to-vivid-red: linear-gradient(135deg,rgba(255,105,0,1) 0%,rgb(207,46,46) 100%);--wp--preset--gradient--very-light-gray-to-cyan-bluish-gray: linear-gradient(135deg,rgb(238,238,238) 0%,rgb(169,184,195) 100%);--wp--preset--gradient--cool-to-warm-spectrum: linear-gradient(135deg,rgb(74,234,220) 0%,rgb(151,120,209) 20%,rgb(207,42,186) 40%,rgb(238,44,130) 60%,rgb(251,105,98) 80%,rgb(254,248,76) 100%);--wp--preset--gradient--blush-light-purple: linear-gradient(135deg,rgb(255,206,236) 0%,rgb(152,150,240) 100%);--wp--preset--gradient--blush-bordeaux: linear-gradient(135deg,rgb(254,205,165) 0%,rgb(254,45,45) 50%,rgb(107,0,62) 100%);--wp--preset--gradient--luminous-dusk: linear-gradient(135deg,rgb(255,203,112) 0%,rgb(199,81,192) 50%,rgb(65,88,208) 100%);--wp--preset--gradient--pale-ocean: linear-gradient(135deg,rgb(255,245,203) 0%,rgb(182,227,212) 50%,rgb(51,167,181) 100%);--wp--preset--gradient--electric-grass: linear-gradient(135deg,rgb(202,248,128) 0%,rgb(113,206,126) 100%);--wp--preset--gradient--midnight: linear-gradient(135deg,rgb(2,3,129) 0%,rgb(40,116,252) 100%);--wp--preset--font-size--small: 13px;--wp--preset--font-size--medium: 20px;--wp--preset--font-size--large: 36px;--wp--preset--font-size--x-large: 42px;--wp--preset--spacing--20: 0.44rem;--wp--preset--spacing--30: 0.67rem;--wp--preset--spacing--40: 1rem;--wp--preset--spacing--50: 1.5rem;--wp--preset--spacing--60: 2.25rem;--wp--preset--spacing--70: 3.38rem;--wp--preset--spacing--80: 5.06rem;--wp--preset--shadow--natural: 6px 6px 9px rgba(0, 0, 0, 0.2);--wp--preset--shadow--deep: 12px 12px 50px rgba(0, 0, 0, 0.4);--wp--preset--shadow--sharp: 6px 6px 0px rgba(0, 0, 0, 0.2);--wp--preset--shadow--outlined: 6px 6px 0px -3px rgba(255, 255, 255, 1), 6px 6px rgba(0, 0, 0, 1);--wp--preset--shadow--crisp: 6px 6px 0px rgba(0, 0, 0, 1);}:where(.is-layout-flex){gap: 0.5em;}:where(.is-layout-grid){gap: 0.5em;}body .is-layout-flow > .alignleft{float: left;margin-inline-start: 0;margin-inline-end: 2em;}body .is-layout-flow > .alignright{float: right;margin-inline-start: 2em;margin-inline-end: 0;}body .is-layout-flow > .aligncenter{margin-left: auto !important;margin-right: auto !important;}body .is-layout-constrained > .alignleft{float: left;margin-inline-start: 0;margin-inline-end: 2em;}body .is-layout-constrained > .alignright{float: right;margin-inline-start: 2em;margin-inline-end: 0;}body .is-layout-constrained > .aligncenter{margin-left: auto !important;margin-right: auto !important;}body .is-layout-constrained > :where(:not(.alignleft):not(.alignright):not(.alignfull)){max-width: var(--wp--style--global--content-size);margin-left: auto !important;margin-right: auto !important;}body .is-layout-constrained > .alignwide{max-width: var(--wp--style--global--wide-size);}body .is-layout-flex{display: flex;}body .is-layout-flex{flex-wrap: wrap;align-items: center;}body .is-layout-flex > *{margin: 0;}body .is-layout-grid{display: grid;}body .is-layout-grid > *{margin: 0;}:where(.wp-block-columns.is-layout-flex){gap: 2em;}:where(.wp-block-columns.is-layout-grid){gap: 2em;}:where(.wp-block-post-template.is-layout-flex){gap: 1.25em;}:where(.wp-block-post-template.is-layout-grid){gap: 1.25em;}.has-black-color{color: var(--wp--preset--color--black) !important;}.has-cyan-bluish-gray-color{color: var(--wp--preset--color--cyan-bluish-gray) !important;}.has-white-color{color: var(--wp--preset--color--white) !important;}.has-pale-pink-color{color: var(--wp--preset--color--pale-pink) !important;}.has-vivid-red-color{color: var(--wp--preset--color--vivid-red) !important;}.has-luminous-vivid-orange-color{color: var(--wp--preset--color--luminous-vivid-orange) !important;}.has-luminous-vivid-amber-color{color: var(--wp--preset--color--luminous-vivid-amber) !important;}.has-light-green-cyan-color{color: var(--wp--preset--color--light-green-cyan) !important;}.has-vivid-green-cyan-color{color: var(--wp--preset--color--vivid-green-cyan) !important;}.has-pale-cyan-blue-color{color: var(--wp--preset--color--pale-cyan-blue) !important;}.has-vivid-cyan-blue-color{color: var(--wp--preset--color--vivid-cyan-blue) !important;}.has-vivid-purple-color{color: var(--wp--preset--color--vivid-purple) !important;}.has-black-background-color{background-color: var(--wp--preset--color--black) !important;}.has-cyan-bluish-gray-background-color{background-color: var(--wp--preset--color--cyan-bluish-gray) !important;}.has-white-background-color{background-color: var(--wp--preset--color--white) !important;}.has-pale-pink-background-color{background-color: var(--wp--preset--color--pale-pink) !important;}.has-vivid-red-background-color{background-color: var(--wp--preset--color--vivid-red) !important;}.has-luminous-vivid-orange-background-color{background-color: var(--wp--preset--color--luminous-vivid-orange) !important;}.has-luminous-vivid-amber-background-color{background-color: var(--wp--preset--color--luminous-vivid-amber) !important;}.has-light-green-cyan-background-color{background-color: var(--wp--preset--color--light-green-cyan) !important;}.has-vivid-green-cyan-background-color{background-color: var(--wp--preset--color--vivid-green-cyan) !important;}.has-pale-cyan-blue-background-color{background-color: var(--wp--preset--color--pale-cyan-blue) !important;}.has-vivid-cyan-blue-background-color{background-color: var(--wp--preset--color--vivid-cyan-blue) !important;}.has-vivid-purple-background-color{background-color: var(--wp--preset--color--vivid-purple) !important;}.has-black-border-color{border-color: var(--wp--preset--color--black) !important;}.has-cyan-bluish-gray-border-color{border-color: var(--wp--preset--color--cyan-bluish-gray) !important;}.has-white-border-color{border-color: var(--wp--preset--color--white) !important;}.has-pale-pink-border-color{border-color: var(--wp--preset--color--pale-pink) !important;}.has-vivid-red-border-color{border-color: var(--wp--preset--color--vivid-red) !important;}.has-luminous-vivid-orange-border-color{border-color: var(--wp--preset--color--luminous-vivid-orange) !important;}.has-luminous-vivid-amber-border-color{border-color: var(--wp--preset--color--luminous-vivid-amber) !important;}.has-light-green-cyan-border-color{border-color: var(--wp--preset--color--light-green-cyan) !important;}.has-vivid-green-cyan-border-color{border-color: var(--wp--preset--color--vivid-green-cyan) !important;}.has-pale-cyan-blue-border-color{border-color: var(--wp--preset--color--pale-cyan-blue) !important;}.has-vivid-cyan-blue-border-color{border-color: var(--wp--preset--color--vivid-cyan-blue) !important;}.has-vivid-purple-border-color{border-color: var(--wp--preset--color--vivid-purple) !important;}.has-vivid-cyan-blue-to-vivid-purple-gradient-background{background: var(--wp--preset--gradient--vivid-cyan-blue-to-vivid-purple) !important;}.has-light-green-cyan-to-vivid-green-cyan-gradient-background{background: var(--wp--preset--gradient--light-green-cyan-to-vivid-green-cyan) !important;}.has-luminous-vivid-amber-to-luminous-vivid-orange-gradient-background{background: var(--wp--preset--gradient--luminous-vivid-amber-to-luminous-vivid-orange) !important;}.has-luminous-vivid-orange-to-vivid-red-gradient-background{background: var(--wp--preset--gradient--luminous-vivid-orange-to-vivid-red) !important;}.has-very-light-gray-to-cyan-bluish-gray-gradient-background{background: var(--wp--preset--gradient--very-light-gray-to-cyan-bluish-gray) !important;}.has-cool-to-warm-spectrum-gradient-background{background: var(--wp--preset--gradient--cool-to-warm-spectrum) !important;}.has-blush-light-purple-gradient-background{background: var(--wp--preset--gradient--blush-light-purple) !important;}.has-blush-bordeaux-gradient-background{background: var(--wp--preset--gradient--blush-bordeaux) !important;}.has-luminous-dusk-gradient-background{background: var(--wp--preset--gradient--luminous-dusk) !important;}.has-pale-ocean-gradient-background{background: var(--wp--preset--gradient--pale-ocean) !important;}.has-electric-grass-gradient-background{background: var(--wp--preset--gradient--electric-grass) !important;}.has-midnight-gradient-background{background: var(--wp--preset--gradient--midnight) !important;}.has-small-font-size{font-size: var(--wp--preset--font-size--small) !important;}.has-medium-font-size{font-size: var(--wp--preset--font-size--medium) !important;}.has-large-font-size{font-size: var(--wp--preset--font-size--large) !important;}.has-x-large-font-size{font-size: var(--wp--preset--font-size--x-large) !important;}
.wp-block-navigation a:where(:not(.wp-element-button)){color: inherit;}
:where(.wp-block-post-template.is-layout-flex){gap: 1.25em;}:where(.wp-block-post-template.is-layout-grid){gap: 1.25em;}
:where(.wp-block-columns.is-layout-flex){gap: 2em;}:where(.wp-block-columns.is-layout-grid){gap: 2em;}
.wp-block-pullquote{font-size: 1.5em;line-height: 1.6;}
</style>
<link rel="stylesheet" id="tabulate-timepicker-css" href="../../../wp-content/plugins/tabulate/assets/jquery-ui-timepicker-addon.css" type="text/css" media="all">
<link rel="stylesheet" id="tabulate-leaflet-css" href="../../../wp-content/plugins/tabulate/assets/leaflet/css/leaflet.css" type="text/css" media="all">
<link rel="stylesheet" id="tabulate-jquery-ui-css" href="../../../wp-content/plugins/tabulate/assets/jquery-ui/themes/base/jquery-ui.min.css" type="text/css" media="all">
<link rel="stylesheet" id="tabulate-styles-css" href="../../../wp-content/plugins/tabulate/assets/style.css" type="text/css" media="all">
<link rel="stylesheet" id="hue_developer_theme-style-css" href="../../../wp-content/themes/hue_developer_theme/style.css" type="text/css" media="all">
<link rel="stylesheet" id="newsletter-css" href="../../../wp-content/plugins/newsletter/style.css" type="text/css" media="all">
<link rel="stylesheet" id="enlighterjs-css" href="../../../wp-content/plugins/enlighter/cache/enlighterjs.min.css" type="text/css" media="all">
<link rel="stylesheet" id="um_fonticons_ii-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-fonticons-ii.css" type="text/css" media="all">
<link rel="stylesheet" id="um_fonticons_fa-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-fonticons-fa.css" type="text/css" media="all">
<link rel="stylesheet" id="select2-css" href="../../../wp-content/plugins/ultimate-member/assets/css/select2/select2.min.css" type="text/css" media="all">
<link rel="stylesheet" id="um_crop-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-crop.css" type="text/css" media="all">
<link rel="stylesheet" id="um_modal-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-modal.css" type="text/css" media="all">
<link rel="stylesheet" id="um_styles-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-styles.css" type="text/css" media="all">
<link rel="stylesheet" id="um_profile-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-profile.css" type="text/css" media="all">
<link rel="stylesheet" id="um_account-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-account.css" type="text/css" media="all">
<link rel="stylesheet" id="um_misc-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-misc.css" type="text/css" media="all">
<link rel="stylesheet" id="um_fileupload-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-fileupload.css" type="text/css" media="all">
<link rel="stylesheet" id="um_datetime-css" href="../../../wp-content/plugins/ultimate-member/assets/css/pickadate/default.css" type="text/css" media="all">
<link rel="stylesheet" id="um_datetime_date-css" href="../../../wp-content/plugins/ultimate-member/assets/css/pickadate/default.date.css" type="text/css" media="all">
<link rel="stylesheet" id="um_datetime_time-css" href="../../../wp-content/plugins/ultimate-member/assets/css/pickadate/default.time.css" type="text/css" media="all">
<link rel="stylesheet" id="um_raty-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-raty.css" type="text/css" media="all">
<link rel="stylesheet" id="um_scrollbar-css" href="../../../wp-content/plugins/ultimate-member/assets/css/simplebar.css" type="text/css" media="all">
<link rel="stylesheet" id="um_tipsy-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-tipsy.css" type="text/css" media="all">
<link rel="stylesheet" id="um_responsive-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-responsive.css" type="text/css" media="all">
<link rel="stylesheet" id="um_default_css-css" href="../../../wp-content/plugins/ultimate-member/assets/css/um-old-default.css" type="text/css" media="all">
<link rel="stylesheet" id="um_old_css-css" href="../../../wp-content/uploads/ultimatemember/um_old_settings.css" type="text/css" media="all">
<link rel="stylesheet" id="icwp-wpsf-userprofile-css" href="../../../wp-content/plugins/wp-simple-firewall/assets/dist/shield-userprofile.bundle%EF%B9%96mtime=1755510308.css" type="text/css" media="all">
<script type="text/javascript" src="https://code.jquery.com/jquery-3.5.1.min.js" id="jquery-core-js"></script>
<script type="text/javascript" src="https://code.jquery.com/jquery-migrate-3.3.2.min.js" id="jquery-migrate-js"></script>
<script type="text/javascript" src="../../../wp-content/themes/hue_developer_theme/js/my-scripts.js" id="my-scripts-js"></script>
<script type="text/javascript" src="../../../wp-content/plugins/ultimate-member/assets/js/um-gdpr.min.js" id="um-gdpr-js"></script>
<link rel="EditURI" type="application/rsd+xml" title="RSD" href="https://developers.meethue.com/xmlrpc.php?rsd">
<link rel="shortlink" href="../../../login/index%EF%B9%96redirect_to=https%EF%B9%95%EA%A4%B7%EA%A4%B7developers.meethue.com%EA%A4%B7develop%EA%A4%B7hue-api-v2%EA%A4%B7getting-started%EA%A4%B7.html">
<style type="text/css">.um_request_name {
display: none !important;
}
</style>
<link rel="icon" href="../../../wp-content/uploads/2025/09/cropped-hue_site_icon-32x32.png" sizes="32x32">
<link rel="icon" href="../../../wp-content/uploads/2025/09/cropped-hue_site_icon-192x192.png" sizes="192x192">
<link rel="apple-touch-icon" href="../../../wp-content/uploads/2025/09/cropped-hue_site_icon-180x180.png">
<meta name="msapplication-TileImage" content="https://developers.meethue.com/wp-content/uploads/2025/09/cropped-hue_site_icon-270x270.png">
<style type="text/css" id="wp-custom-css">div #gridcontainer h2 {
margin-top:0;
margin-bottom:0;
}
div #gridcontainer p{
float:left;
}
div #gridcontainer h2 a {
height:auto;
margin-bottom:0px;
}
div #gridcontainer .postimage {
height:0;
}
div #gridcontainer .postimage img {
height:0;
}
div.entry-content a, div.entry-content a:link,div.entry-contenta:visited, div.entry-content a:hover {
color:orange;!important
}
</style>
<script src="https://assets.adobedtm.com/ebfef13a1211/25cafe808aa4/a74bf0525572/RC40eb993e1e964b68837df495423a7487-source.min.js" async=""></script></head>
<body class="page-template-default page page-id-3438 page-child parent-pageid-3311 logged-in wp-custom-logo">
<div id="page" class="site">
<a class="skip-link screen-reader-text" href="#content">Skip to content</a>
<header>
<a href="../../../index.html"><img id="imgm" class="" src="../../../wp-content/themes/hue_developer_theme/img/moblogo.png"></a>
<div class="bannerDev">
<nav id="site-navigation" class="main-navigation">
<div class="myNavigation">
<div class="hueLogo"><a href="../../../index.html"><img id="imgd" class="" src="../../../wp-content/themes/hue_developer_theme/img/site_logo.png.jpeg"></a>
</div>
<br>
<div class="primary-menu-div">
<div class="menu-main-menu-loggedin-container"><ul id="primary-menu" class="menu"><li id="menu-item-1137" class="leftMain menu-item menu-item-type-custom menu-item-object-custom menu-item-has-children menu-item-1137"><a href="#">Explore</a>
<ul class="sub-menu">
<li id="menu-item-1138" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-1138"><a href="../../../explore/why-develop-for-hue/index.html">Why Develop for Hue</a></li>
<li id="menu-item-2664" class="menu-item menu-item-type-custom menu-item-object-custom menu-item-2664"><a href="../../../explore/hue-app-showcase/index.html">Hue App Showcase</a></li>
</ul>
</li>
<li id="menu-item-1140" class="leftMain menu-item menu-item-type-custom menu-item-object-custom current-menu-ancestor current-menu-parent menu-item-has-children menu-item-1140 active"><a href="#">Develop</a>
<ul class="sub-menu">
<li id="menu-item-3907" class="menu-item menu-item-type-post_type menu-item-object-page current-menu-item page_item page-item-3438 current_page_item menu-item-3907"><a href="index.html" aria-current="page">Getting started</a></li>
<li id="menu-item-3903" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-3903"><a href="../../application-design-guidance/index.html">Application Design Guidance</a></li>
<li id="menu-item-1143" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-1143"><a href="../../hue-api/index.html">Hue API V1</a></li>
<li id="menu-item-3537" class="menu-item menu-item-type-post_type menu-item-object-page current-page-ancestor current-page-parent menu-item-3537"><a href="../index.html">Hue API V2</a></li>
<li id="menu-item-1354" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-1354"><a href="../../hue-entertainment/index.html">Hue Entertainment</a></li>
<li id="menu-item-1144" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-1144"><a href="../../tools-and-sdks/index.html">Tools and SDKs</a></li>
</ul>
</li>
<li id="menu-item-1145" class="leftMain menu-item menu-item-type-post_type menu-item-object-page menu-item-1145"><a href="../../../support/index.html">Support</a></li>
<li id="menu-item-1452" class="leftMain menu-item menu-item-type-post_type menu-item-object-page menu-item-1452"><a href="../../../job-vacancies/index.html">Job Vacancies</a></li>
<li id="menu-item-1147" class="leftMain menu-item menu-item-type-custom menu-item-object-custom menu-item-1147"><a href="../../../forum/index.html">Forum</a></li>
<li id="menu-item-1148" class="rightMain menu-item menu-item-type-custom menu-item-object-custom menu-item-has-children menu-item-1148"><a href="#">Massimo</a>
<ul class="sub-menu">
<li id="menu-item-1181" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-1181"><a href="../../../my-apps/index.html">Remote Hue API appids</a></li>
<li id="menu-item-1321" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-1321"><a href="../../../account/supergiovane/index.html">Profile</a></li>
<li id="menu-item-1150" class="menu-item menu-item-type-custom menu-item-object-custom last_item menu-item-1150"><a href="../../../index.html">Log out</a></li>
</ul>
</li>
</ul></div> </div>
<p class="titleExplore">How to <span class="boldTitle">develop for Hue?</span></p> </div>
</nav><!-- #site-navigation -->
</div>
</header><!-- #masthead -->
<div id="content" class="site-content">
<div id="primary" class="">
<div class="localnavDiv">
<ul class="localNav">
<div class="menu-develop_menulocal-menu-container"><ul id="menu-develop_menulocal-menu" class="localNav"><li id="menu-item-174" class="localLeft menu-item menu-item-type-custom menu-item-object-custom current-menu-ancestor current-menu-parent menu-item-has-children menu-item-174"><a href="#">Develop</a>
<ul class="sub-menu">
<li id="menu-item-160" class="localRight menu-item menu-item-type-post_type menu-item-object-page menu-item-160"><a href="../../tools-and-sdks/index.html">Tools and SDKs</a></li>
<li id="menu-item-1361" class="localRight menu-item menu-item-type-post_type menu-item-object-page menu-item-1361"><a href="../../hue-entertainment/index.html">Hue Entertainment</a></li>
<li id="menu-item-3531" class="localRight menu-item menu-item-type-post_type menu-item-object-page current-page-ancestor current-page-parent menu-item-3531 active"><a href="../index.html">Hue API V2</a></li>
<li id="menu-item-161" class="localRight menu-item menu-item-type-post_type menu-item-object-page menu-item-161"><a href="../../hue-api/index.html">Hue API V1</a></li>
<li id="menu-item-3900" class="localRight menu-item menu-item-type-post_type menu-item-object-page menu-item-3900"><a href="../../application-design-guidance/index.html">Application Design Guidance</a></li>
<li id="menu-item-3904" class="localRight menu-item menu-item-type-post_type menu-item-object-page current-menu-item page_item page-item-3438 current_page_item last_item menu-item-3904"><a href="index.html" aria-current="page">Getting started</a></li>
</ul>
</li>
</ul></div>
</ul>
</div>
<main id="main" class="site-main">
<div class="menu-clipv2-container"><ul id="menu-clipv2" class="nav-menu"><li id="menu-item-3395" class="localLi menu-item menu-item-type-post_type menu-item-object-page current-page-ancestor current-page-parent menu-item-3395"><a href="../index.html">Hue API V2</a></li>
<li id="menu-item-3392" class="localLi menu-item menu-item-type-post_type menu-item-object-page menu-item-3392"><a href="../../../login/index%EF%B9%96redirect_to=https%EF%B9%95%EA%A4%B7%EA%A4%B7developers.meethue.com%EA%A4%B7develop%EA%A4%B7hue-api-v2%EA%A4%B7migration-guide-to-the-new-hue-api%EA%A4%B7.html">Migration Guide to the new Hue API</a></li>
<li id="menu-item-3442" class="localLi menu-item menu-item-type-post_type menu-item-object-page current-menu-item page_item page-item-3438 current_page_item menu-item-3442 active"><a href="index.html" aria-current="page">Getting started</a></li>
<li id="menu-item-3443" class="localLi menu-item menu-item-type-post_type menu-item-object-page menu-item-3443"><a href="../../../login/index%EF%B9%96redirect_to=https%EF%B9%95%EA%A4%B7%EA%A4%B7developers.meethue.com%EA%A4%B7develop%EA%A4%B7hue-api-v2%EA%A4%B7core-concepts%EA%A4%B7.html">Core Concepts</a></li>
<li id="menu-item-3396" class="localLi menu-item menu-item-type-custom menu-item-object-custom menu-item-3396"><a href="../../../login/index%EF%B9%96redirect_to=https%EF%B9%95%EA%A4%B7%EA%A4%B7developers.meethue.com%EA%A4%B7develop%EA%A4%B7hue-api-v2%EA%A4%B7api-reference%EA%A4%B7.html">API Reference</a></li>
<li id="menu-item-3595" class="localLi menu-item menu-item-type-post_type menu-item-object-page last_item menu-item-3595"><a href="../../../login/index%EF%B9%96redirect_to=https%EF%B9%95%EA%A4%B7%EA%A4%B7developers.meethue.com%EA%A4%B7develop%EA%A4%B7hue-api-v2%EA%A4%B7cloud2cloud-getting-started%EA%A4%B7.html">Cloud2Cloud Getting Started</a></li>
</ul></div>
<article id="post-3438" class="post-3438 page type-page status-publish hentry category-clipv2-articles">
<header class="entry-header">
<h1 class="entry-title">Getting started</h1> <span style="font-family:CentraleSans-Light; ;font-size:18px;">The fastest way to learn how to build apps which control the hue system is to use a simple API testing tool. This lets you directly input commands and send them to the lights. In this article we'll use Postman, but any HTTP client should work. <span>
</span></span></header><!-- .entry-header -->
<img id="imgm" class="" src="../../../wp-content/themes/hue_developer_theme/img/moblogo.png">
<div class="entry-content">
<h2 id="findme"><a id="follow-3-easy-steps"></a>Follow 3 Easy Steps</h2>
<p>Step 1</p>
<p>First make sure your bridge is connected to your network and is functioning properly. Test that the official Philips Hue mobile app can control the lights on the same network.</p>
<p>Step 2</p>
<p>Then you need to discover the IP address of the bridge on your network. You can do this in a few ways.</p>
<p>NOTE – When you are ready to make a production app, you need to discover the bridge automatically using <span style="color: #ff6600;"><a style="color: #ff6600;" href="../../../login/index%EF%B9%96redirect_to=https%EF%B9%95%EA%A4%B7%EA%A4%B7developers.meethue.com%EA%A4%B7develop%EA%A4%B7application-design-guidance%EA%A4%B7hue-bridge-discovery%EA%A4%B7.html">Hue Bridge Discovery Guide</a></span>.</p>
<p>1. Go to the settings menu in the app. Go to Hue Bridges. Select your bridge. The ip address of the bridge will show.<br>
2. Use an mDNS discovery app to find Philips hue in your network.<br>
3. Use our broker server discover process by visiting <span style="color: #ff6600;"><a style="color: #ff6600;" href="https://discovery.meethue.com/">https://discovery.meethue.com</a></span><br>
4. Log into your wireless router and look Philips hue up in the DHCP table.</p>
<p>Step 3</p>
<p>Download, install, and open the Postman tool (or any other API testing tool to your liking) and disable ‘SSL certificate verification’ in File – Settings menu.</p>
<p>NOTE – When you are ready to make a production app, you need to properly validate the certificate, see <span style="color: #ff6600;"><a style="color: #ff6600;" href="../../../login/index%EF%B9%96redirect_to=https%EF%B9%95%EA%A4%B7%EA%A4%B7developers.meethue.com%EA%A4%B7develop%EA%A4%B7application-design-guidance%EA%A4%B7using-https%EA%A4%B7.html">Using HTTPS</a></span>.</p>
<p><a href="../../../wp-content/uploads/2021/10/1-certificate-verification.png"><img fetchpriority="high" decoding="async" class="alignnone size-full wp-image-3460" src="../../../wp-content/uploads/2021/10/1-certificate-verification.png" alt="" width="778" height="236" srcset="../../../wp-content/uploads/2021/10/1-certificate-verification.png 778w, ../../../wp-content/uploads/2021/10/1-certificate-verification-300x91.png 300w, ../../../wp-content/uploads/2021/10/1-certificate-verification-768x233.png 768w" sizes="(max-width: 778px) 100vw, 778px"></a></p>
<p>Using an API testing tool you can populate the components of an HTTPS request – the basis of all web traffic and of the hue API.</p>
<p><b>1. URL:</b> this is actually the local address of a specific resource (thing) inside the hue system. It could be device, light, room, scene or many more things. This is the object you’ll be interacting with in this command.</p>
<p><b>2. Request method:</b> here you have a choice of the 4 HTTPS methods the hue system uses.<br>
<b>GET:</b> this is the command to fetch all information about the addressed resource<br>
<b>PUT:</b> this is the command to modify an addressed resource<br>
<b>POST:</b> this is the command to create a new resource inside the addressed resource<br>
<b>DELETE:</b> this is the command to delete the addressed resource</p>
<p><b>3. Request body:</b> this is the part of the message which describes what you want to change and how. Here you enter, in JSON format, the resource name and value you’d like to change/add.<br>
<b></b></p>
<p><b>4. Response code: </b>This will indicate whether your request succeeded or failed.<br>
<b></b></p>
<p><b>5. Response body: </b>Here you’ll see the response to your command. Also in JSON format.</p>
<h2 id="findme1"><a id="so-lets-get-started"></a>So let’s get started…</h2>
<p>First let’s do a very simple request and get information about the devices in your hue system.</p>
<p>Fill in the details below leaving the body empty and press the Send button.</p>
<table style="height: 48px;">
<tbody>
<tr style="height: 24px;">
<td style="height: 24px;">URL</td>
<td style="height: 24px;"><code>https://<bridge ip address>/clip/v2/resource/device</code></td>
</tr>
<tr style="height: 24px;">
<td style="height: 24px;">Method</td>
<td style="height: 24px;"><code>GET</code></td>
</tr>
</tbody>
</table>
<p>Make sure you are on the same network as the bridge, and that you use the ip you obtained in step 2. Now you should see the response code 403 Forbidden:</p>
<p><a href="../../../wp-content/uploads/2021/10/2-403-forbidden.png"><img decoding="async" class="alignnone size-full wp-image-3461" src="../../../wp-content/uploads/2021/10/2-403-forbidden.png" alt="" width="772" height="201" srcset="../../../wp-content/uploads/2021/10/2-403-forbidden.png 772w, ../../../wp-content/uploads/2021/10/2-403-forbidden-300x78.png 300w, ../../../wp-content/uploads/2021/10/2-403-forbidden-768x200.png 768w" sizes="(max-width: 772px) 100vw, 772px"></a></p>
<p>That’s because we did not yet provide a hue-application-key header for authorization.</p>
<p>We need to use the randomly generated application key that the bridge creates for you. Fill in the info below and press the Send button.</p>
<table style="height: 72px;">
<tbody>
<tr style="height: 24px;">
<td style="height: 24px; width: 58px;">URL</td>
<td style="height: 24px; width: 360.667px;"><code>https://<bridge ip address>/api</code></td>
</tr>
<tr style="height: 24px;">
<td style="height: 24px; width: 58px;">Body</td>
<td style="height: 24px; width: 360.667px;"><code>{"devicetype":"app_name#instance_name", "generateclientkey":true}</code></td>
</tr>
<tr style="height: 24px;">
<td style="height: 24px; width: 58px;">Method</td>
<td style="height: 24px; width: 360.667px;"><code>POST</code></td>
</tr>
</tbody>
</table>
<p>You should get back an error message letting you know that you have to press the link button.</p>
<p><a href="../../../wp-content/uploads/2021/10/3-link-button.png"><img decoding="async" class="alignnone size-full wp-image-3462" src="../../../wp-content/uploads/2021/10/3-link-button.png" alt="" width="764" height="516" srcset="../../../wp-content/uploads/2021/10/3-link-button.png 764w, ../../../wp-content/uploads/2021/10/3-link-button-300x203.png 300w" sizes="(max-width: 764px) 100vw, 764px"></a></p>
<p>This is our security step so that only apps you want to control your lights can. By pressing the button we prove that the user has physical access to the bridge.</p>
<p>Go and press the button on the bridge and then press the Send button again and you should get a success response like below.</p>
<p><a href="../../../wp-content/uploads/2021/10/4-username.png"><img loading="lazy" decoding="async" class="alignnone size-full wp-image-3463" src="../../../wp-content/uploads/2021/10/4-username.png" alt="" width="763" height="493" srcset="../../../wp-content/uploads/2021/10/4-username.png 763w, ../../../wp-content/uploads/2021/10/4-username-300x194.png 300w" sizes="(max-width: 763px) 100vw, 763px"></a></p>
<p>You’ve now created an authorized username, which we’ll use as the hue-application-key from now on.</p>
<h2 id="findme2"><a id="retrieving-device-list"></a>Retrieving device list</h2>
<p>In the Headers section you should add a header with name <code>hue-application-key</code> and value the username (<code>sFlEGnMAFXO6RtZV17aViNUB95G2uXWw64texDzD</code> in above example). From here on we will refer to this username as appkey. Now if you do the first GET request again you should get a 200 OK response code with a whole lot of information about what devices you have and what services they offer in the response body. This data is all in JSON format so can be easily processed by your applications.</p>
<table>
<tbody>
<tr>
<td>Address</td>
<td><code>https://<bridge ip address>/clip/v2/resource/device</code></td>
</tr>
<tr>
<td>Method</td>
<td><code>GET</code></td>
</tr>
<tr>
<td>Header</td>
<td><code><span style="font-size: 16px;">hue-application-key: <appkey></span></code></td>
</tr>
</tbody>
</table>
<p><a href="../../../wp-content/uploads/2021/10/5-devices.png"><img loading="lazy" decoding="async" class="alignnone size-full wp-image-3464" src="../../../wp-content/uploads/2021/10/5-devices.png" alt="" width="776" height="722" srcset="../../../wp-content/uploads/2021/10/5-devices.png 776w, ../../../wp-content/uploads/2021/10/5-devices-300x279.png 300w, ../../../wp-content/uploads/2021/10/5-devices-768x715.png 768w" sizes="(max-width: 776px) 100vw, 776px"></a></p>
<p>Congratulations you’ve just sent you first authorized CLIP command!</p>
<h2 id="findme3"><a id="controlling-a-light"></a>Controlling a light</h2>
<p>Okay now that we have a hue-application-key with permission to use the system lets start having some fun.</p>
<p>You should see that most Hue devices offer a light service. Each light service has its own URL, which you can construct using the “rtype” and “rid” of the service. Let’s get information about the light service with rid <code>fc2daa74-0d44-4712-a373-e39a9c2b426d</code> by filling that in the id part of the address below. In your case you need to take the rid of the light service reported by your device.</p>
<table>
<tbody>
<tr>
<td>Address</td>
<td><code> https://<bridge ip address>/clip/v2/resource/light/<id></code></td>
</tr>
<tr>
<td>Method</td>
<td><code>GET</code></td>
</tr>
<tr>
<td>Header</td>
<td><code><span style="font-size: 16px;">hue-application-key: <appkey></span></code></td>
</tr>
</tbody>
</table>
<p>In this response you can see all of the properties this light service has. The most interesting ones are the feature objects on, dimming, color_temperature, and color. These are the ones we’ll use to control the light.</p>
<p><a href="../../../wp-content/uploads/2021/10/6-light.png"><img loading="lazy" decoding="async" class="alignnone size-full wp-image-3465" src="../../../wp-content/uploads/2021/10/6-light.png" alt="" width="771" height="501" srcset="../../../wp-content/uploads/2021/10/6-light.png 771w, ../../../wp-content/uploads/2021/10/6-light-300x195.png 300w, ../../../wp-content/uploads/2021/10/6-light-768x499.png 768w" sizes="(max-width: 771px) 100vw, 771px"></a></p>
<p>Let’s start with the “on” object. This is a very simple object with an on attribute that can have 2 values: true and false. So let’s try turning the light off.</p>
<table>
<tbody>
<tr>
<td>Address</td>
<td><code> https://<bridge ip address>/clip/v2/resource/light/<id></code></td>
</tr>
<tr>
<td>Method</td>
<td><code>PUT</code></td>
</tr>
<tr>
<td>Header</td>
<td><code><span style="font-size: 16px;">hue-application-key: <appkey></span></code></td>
</tr>
<tr>
<td>Body</td>
<td><code>{"on":{"on":false}}</code></td>
</tr>
</tbody>
</table>
<p>Looking at the command you are sending we’re addressing the “on” object of the light service and telling it to modify the “on” value inside it to false (i.e. off). When you press the Send button the light should turn off.</p>
<p><a href="../../../wp-content/uploads/2021/10/7-on.png"><img loading="lazy" decoding="async" class="alignnone size-full wp-image-3466" src="../../../wp-content/uploads/2021/10/7-on.png" alt="" width="772" height="295" srcset="../../../wp-content/uploads/2021/10/7-on.png 772w, ../../../wp-content/uploads/2021/10/7-on-300x115.png 300w, ../../../wp-content/uploads/2021/10/7-on-768x293.png 768w" sizes="(max-width: 772px) 100vw, 772px"></a></p>
<p>Change the value in the body to true and after pressing Send the light will turn on again.</p>
<p>Now let’s do something a bit more fun and start changing some colors. Enter the command below.</p>
<table style="height: 69px;" width="492">
<tbody>
<tr>
<td style="width: 58px;">Address</td>
<td style="width: 525px;"><code>https://<bridge ip address>/clip/v2/resource/light/<id></code></td>
</tr>
<tr>
<td style="width: 58px;">Method</td>
<td style="width: 525px;"><code>PUT</code></td>
</tr>
<tr>
<td>Header</td>
<td><code><span style="font-size: 16px;">hue-application-key: <appkey></span></code></td>
</tr>
<tr>
<td style="width: 58px;">Body</td>
<td style="width: 525px;"><code>{"dimming":{"brightness":50.0},"color":{"xy":{"x":0.4605,"y":0.2255}}}</code></td>
</tr>
</tbody>
</table>
<p>Now we’re modifying a couple more attributes to set the brightness to 50% and the color to purple at the same time.</p>
<p><a href="../../../wp-content/uploads/2021/10/8-brightness-color-1.png"><img loading="lazy" decoding="async" class="alignnone size-full wp-image-3517" src="../../../wp-content/uploads/2021/10/8-brightness-color-1.png" alt="" width="773" height="407" srcset="../../../wp-content/uploads/2021/10/8-brightness-color-1.png 773w, ../../../wp-content/uploads/2021/10/8-brightness-color-1-300x158.png 300w, ../../../wp-content/uploads/2021/10/8-brightness-color-1-768x404.png 768w" sizes="(max-width: 773px) 100vw, 773px"></a></p>
<p>The x and y values for color vary between 0 and 1. Try changing the values and keep pressing the Send button and see the color of your light changing. You can use this image to see what values correspond to which colors.</p>
<p><img decoding="async" class="images" src="../../../wp-content/uploads/2018/02/color.png"></p>
<p>There is also an eventing mechanism to automatically receive changes to resources bu