/
gettingstarted_off_platform.html
163 lines (141 loc) · 7.76 KB
/
gettingstarted_off_platform.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'>
<meta name='myds_document_id' Content='37870'>
<title>Getting Started Off Platform Apps</title>
<meta name='description' content=''>
<meta name='keywords' content=''>
<link rel=stylesheet href='site/1210/1210.format-1.1.1.css'>
<link rel="shortcut icon" href='site/1210/favicon.ico'>
<link rel="stylesheet" href="/jscripts/css/prettify.css"/><link rel="stylesheet" href="/jscripts/jqueryui/darkness.css"/><script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.4/jquery.min.js" type="text/javascript"></script><script src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8.16/jquery-ui.min.js" type="text/javascript"></script><script src="site/1210/1210.home-1.0.10.js" type="text/javascript"></script>
<script src="/jscripts/prettify.js" type="text/javascript"></script>
<link rel="stylesheet" href="site/1210/1210.format.messaging.001.css"><link rel="stylesheet" href="site/1210/1210.invite.css">
</head>
<script language="JavaScript">
var msOnDemandDocumentId = 37870;
var mydigitalstructureDocumentId = 37870;
var msOnDemandContextId = '';
var mydigitalstructureContextId = '';
var msOnDemandSiteId = 1210;
var mydigitalstructureSiteId = 1210;
function cmdPrint_OnClick() {window.print();}
function cmdAllSections_OnClick() {window.location.href = 'document_PublicView.asp?select=37870&allsections=True&site=1210';}
function PageSetup2(){}
</script>
<body>
<table myds='LayoutTable1' width='100%' height='100%' border=0 cellpadding=0 cellspacing=0><tr>
<td myds='LayoutTable1.LeftBorder' height='100%' width='' Class='border1 borderLeft' >
</td><td myds='LayoutTable1.MainTable1' valign=TOP width='900' height='100%'>
<table width='900' myds='MainTable1' width='100%' height='100%' border=0 cellpadding=0 cellspacing=0>
<tr><td myds='MainTable1.HeaderTable1' valign=TOP height=0>
<table myds='HeaderTable1' width='100%' height='100%' border=0 cellpadding=0 cellspacing=0>
<tr><td myds='HeaderTable1' valign=TOP height='100%'>
</td></tr>
</table>
</td></tr>
<tr><td valign=TOP height='100%'>
<table myds='MainTable2' width='100%' height='100%' border=0 cellpadding=0 cellspacing=0>
<tr>
<td myds='MainTable1.Main' valign=TOP height='100%'>
<div id="container">
<div id="header"><a href="http://ibCom.biz" target="_blank"> </a>
<div id="logo"><a href="http://ibCom.biz" target="_blank"></a><a href="http://ibCom.biz" target="_blank"><img src="site/1210/ibCom_Vertical_Light_17.png" alt="" /></a></div>
<div id="logon"></div>
<div id="nav" style="padding-left: 12px;">
<ul>
<li value="0"><a href="index.html">home</a></li>
<li value="0"><a href="gettingstarted_signup.html">sign up</a></li>
<li value="0"><a href="https://console.mydigitalstructure.com">log on</a></li>
<li value="0"><a href="gettingstarted.html">getting started</a></li>
<li value="0"><a href="documentation.html">documentation</a></li>
<li value="0"><a href="endpoints.html">endpoints</a></li>
<li value="0"><a href="examples.html">examples</a></li>
<li value="0"><a href="developwith.html">blog</a></li>
<li value="0"><a class="last" href="contact.html">contact</a></li>
</ul>
</div>
</div>
<div id="main"><table style="width: 100%;" border="0" cellspacing="0" cellpadding="4">
<tbody>
<tr>
<td style="width: 25px;" valign="top"> </td>
<td><strong><span style="font-size: 18pt; color: #888888; line-height: 32px;">GETTING STARTED</span><br /><span style="font-size: 24pt;">"OFF-PLATFORM" APP DEVELOPMENT<br /></span><br />Using the API directly.<br /></strong></td>
<td style="width: 25px;"><strong> </strong></td>
</tr>
<tr>
<td style="width: 25px;" valign="top"> </td>
<td>
<p>When accessing the mydigitalstructure api, the type of app hosting client makes a difference:</p>
<ul>
<li>"Closed code" native - ie iOS app, Android app<br /><br /></li>
<li>"Open scripted" user agent - ie Web Browser</li>
</ul>
<p><br />Closed code native apps can access the api directly using standard API access.</p>
<p>With open scripted environments there are security restrictions - for guidance on this read on.</p>
</td>
<td> </td>
</tr>
<tr>
<td style="width: 25px;" valign="top"> </td>
<td>
<p><span style="font-size: 14pt;"><strong>OPEN SCRIPTED CLIENTS</strong></span></p>
</td>
<td> </td>
</tr>
<tr>
<td style="width: 25px;" valign="top"> </td>
<td>When developing open scripted user-agent based clients (ie a web browser hosted) you need to be aware of the inherent internet level <a href="http://en.wikipedia.org/wiki/Cross-origin_resource_sharing" target="_blank">cross origin (domain) resource sharing</a> (CORS) protection. By default all requests from the user-agent to the host <strong>must be on the same domain</strong> that is hosting the application.
<p>If you are using mydigitalstructure and the 1blankspace.com domain to host your web app, as in scenario <span style="color: #ff9900;"><strong>A</strong></span> below, then it is inherent and no further action is required</p>
<p>If you are using scenario <span style="color: #ff9900;"><strong>B</strong></span> - then you need to be aware of the restriction and need to consider the CORS & HTTP headers section below.</p>
</td>
<td> </td>
</tr>
<tr>
<td> </td>
<td><img title="mydigitalstructure_off_platform_1.0" src="site/1210/mydigitalstructure_off_platform_1.0.png" alt="mydigitalstructure_off_platform_1.0" width="469" height="249" /></td>
<td> </td>
</tr>
<tr>
<td> </td>
<td>
<p><span style="font-size: 14pt;"><strong>CORS & HTTP HEADERS</strong></span></p>
<p>To enable cross origin resource sharing (<a href="http://en.wikipedia.org/wiki/Cross-origin_resource_sharing" target="_blank">CORS</a>) on your website/app, that is hosted on another domain, to access mydigitalstructure.com you will need to add the <a href="http://enable-cors.org/" target="_blank">Access-Control-Allow-Origin</a> HTTP Header.</p>
<p>To do this you can use the <span><a href="SETUP_SITE_HTTP_HEADER_MANAGE.html">SETUP_SITE_HTTP_HEADER_MANAGE</a></span> method.</p>
<p>The most common header being: </p>
<pre><span><span style="font-family: 'courier new', courier;">Access-Control-Allow-Origin</span>: [your domain or *]</span></pre>
</td>
<td> </td>
</tr>
</tbody>
</table>
<div style="width: 100%; text-align: right; padding-right: 15px; padding-top: 20px;"><a target="_blank" href="http://community.ibcom.biz"><img src="site/1210/ibCom_help.png" alt="Help!" /></a> <a class="twitter-share-button" href="https://twitter.com/share">Tweet</a>
<script type="text/javascript">// <![CDATA[
!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");
// ]]></script>
</div>
</div>
<div id="footer"></div>
</div></td myds='MainTable1.Main'></tr>
</table>
</td></tr>
</table myds='MainTable1'>
</td myds='LayoutTable1.MainTable1' >
<td myds='LayoutTable1.RightBorder' height='100%' width='' Class='border2 borderRight' >
</td myds='LayoutTable1.MainTable1/LayoutTable1.RightBorder'>
</tr>
</table myds='LayoutTable1'>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-27776845-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</body>
</html>