Aepona V1 0 Femto Zonal Presence REST
-
Upload
knsvel2000 -
Category
Documents
-
view
230 -
download
0
Transcript of Aepona V1 0 Femto Zonal Presence REST
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
1/21
UNIVERSAL SERVICE PLATFORMUNIVERSAL SERVICE PLATFORM 3.33.3
TELECOM WEB SERVICESTELECOM WEB SERVICES3.43.4
FEMTOFEMTO
ZONAL PRESENCE REST V1.0ZONAL PRESENCE REST V1.0
DOCUMENT VERSION: 1.1DOCUMENT VERSION: 1.1
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
2/21
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
3/21
Zonal Presence REST V1.0 Document Version: 1.1
T',% o Co&"%&"
1 Zonal Presence REST Overview....................................................................................................5
2 Authentication..................................................................................................................................5
!etho"s............................................................................................................................................5
".# $%&s................................................................................................................................................6
# $nitiate Su%scri&tion to Zonal Presence 'oti(ications.................................................................7
'.#.# %euest..............................................................................................................................7
'.#.) %euest *arameters..........................................................................................................7
'.#." %esponse...........................................................................................................................8
'.#.' %esponse *arameters.......................................................................................................8
) *ancel Su%scri&tion to Zonal Presence 'oti(ications.................................................................9
+.#.# %euest..............................................................................................................................9
+.#.) %euest *arameters .........................................................................................................9
+.#." %esponse...........................................................................................................................9
+.#.' %esponse *arameters ......................................................................................................9
+ Zonal Presence 'oti(ication...........................................................................................................9
, -uer Zone /ist..............................................................................................................................11
.#.# %euest............................................................................................................................11
.#.) %euest *arameters........................................................................................................11
.#." %esponse.........................................................................................................................11
.#.' %esponse *arameters.....................................................................................................11
-uer Zone Status.........................................................................................................................12
-.#.# %euest............................................................................................................................12
-.#.) %euest *arameters........................................................................................................12
-.#." %esponse.........................................................................................................................12
-.#.' %esponse *arameters.....................................................................................................12
-uer a name" set o( Access Point Status................................................................................13
.#.# %euest............................................................................................................................13
Pae
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
4/21
Zonal Presence REST V1.0 Document Version: 1.1
.#.) %euest *arameters........................................................................................................13
.#." %esponse.........................................................................................................................13
.#.' %esponse *arameters.....................................................................................................14
10 -uer all Access Point Status......................................................................................................14
#/.#.# %euest............................................................................................................................14
#/.#.) %euest *arameters........................................................................................................14
#/.#." %esponse.........................................................................................................................14
#/.#.' %esponse *arameters.....................................................................................................15
11 -uer a 3ser within a Zone..........................................................................................................16
##.#.# %euest............................................................................................................................16
##.#.) %euest *arameters........................................................................................................16
##.#." %esponse.........................................................................................................................16
##.#.' %esponse *arameters.....................................................................................................17
12 -uer all 3sers on an Access Point............................................................................................17
#).#.# %euest............................................................................................................................17
#).#.) %euest *arameters........................................................................................................17
#).#." %esponse.........................................................................................................................17
#).#.' %esponse *arameters.....................................................................................................18
1 -uer all 3sers within a Zone......................................................................................................18
#".#.# %euest............................................................................................................................18
#".#.) %euest *arameters........................................................................................................18
#".#." %esponse.........................................................................................................................18
#".#.' %esponse *arameters.....................................................................................................19
1# Res&onse *o"es 4 E5ce&tions....................................................................................................19
#'.# %esponse 0odes..........................................................................................................................19
#'.) 1xceptions...................................................................................................................................20
#'.).# 2ervice 1xceptions..........................................................................................................20
#'.).) *olicy 1xceptions.............................................................................................................20
Pae #
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
5/21
Zonal Presence REST V1.0 Document Version: 1.1
1 Zo&', Pr%%&5% REST O6%r6i%7
T!% Zo&', Pr%%&5% i&"%r'5% ',,o7 ' W% 'pp,i5'"io& "o +5ri% "o &o"ii5'"io& o 7!%& ' (oi,% )%6i5%
%&"%r* %8i" or (o6% %"7%%& '55% poi&" 7i"!i& ' 9o&%. I" 5'& ',o +%ry "!% "'"+ o +%r* '55%
poi&" '&) 9o&%.
W!%& +i& "!i )o5+(%&" yo+ 7i,, ',o &%%) "o r%%r "o "!% ;O&%API V#.0 Co((o& I&or('"io&
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
6/21
Zonal Presence REST V1.0 Document Version: 1.1
3.1 RI
I&i"i'"% "!% +5rip"io& "o r%5%i6% 9o&', pr%%&5% &o"ii5'"io& o +%r %&"%ri&* %8i"i& or "r'&%rri&
%"7%%& '55% poi&" 7i"!i& ' 9o&%
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+5rip"io&>?9o&%I)@
C'&5%, "!% +5rip"io& "o 9o&', pr%%&5% &o"ii5'"io&
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+5rip"io&>?9o&%I)@>
?+5rip"io&I)@
+%ry "o r%"ri%6% ' ,i" o 9o&% "!% 'pp,i5'"io& i '+"!ori9%) "o +%
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+%ri%>9o&%
+%ry "o r%"ri%6% "!% "'"+ o ' 9o&% '&) r%,%6'&" "'"i"i5
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+%ri%>9o&%S"'"+9o&%I)B?9o&%I)@
+%ry ' &'(%) %" o '55% poi&" "'"+ i& ' 9o&%
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+%ri%>'55%Poi&"S"'"+
9o&%I)B?9o&%I)@'55%Poi&"I)B?'55%Poi&"I)@
+%ry "o r%"ri%6% "!% "'"+ o ',, '55% poi&" i& ' 9o&%
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+%ri%>'55%Poi&"S"'"+
9o&%I)B?9o&%I)@
+%ry "o r%"ri%6% "!% "'"+ o ' +%r 7i"!i& ' 9o&%
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+%ri%>+%rS"'"+
9o&%I)B?9o&%I)@'))r%B?'))r%@
+%ry "o r%"ri%6% "!% "'"+ o ',, +%r 7i"!i& '& '55% poi&"
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+%ri%>+%rS"'"+
9o&%I)B?9o&%I)@'55%Poi&"I)B?'55%Poi&"I)@
+%ry "o r%"ri%6% "!% "'"+ o ',, +%r 7i"!i& ' 9o&%
!""p:>>%8'(p,%.5o(>?'pi 6%rio&@>9o&',pr%%&5%>+%ri%>+%rS"'"+9o&%I)B?9o&%I)@
%8'(p,%.5o( i r%p,'5%) y "!% !o"&'(% o "!% O&%API %r6%r yo+ 'r% '55%i&. 'pi 6%rio& i&)i5'"%
"!% 6%rio& o Zo&', Pr%%&5% yo+ 'r% '55%i&.
R%pr%%&"'"io& or('" "!% r%po&% 5o&"%&" "yp% or "!% Zo&', Pr%%&5% API i
'pp,i5'"io&>SON.
Pae +
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
7/21
Zonal Presence REST V1.0 Document Version: 1.1
4 I&i"i'"% S+5rip"io& "o Zo&', Pr%%&5% No"ii5'"io&
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +5ri% "o 9o&', pr%%&5% &o"ii5'"io&.
4.1.1 R%+%"
POST http://example.com/1/zonalpresence/subscriptions/yumscoffee HTTP/1.1
Host: example.com:80
ontent!Type: application/"son
#ccept: application/"son$
%zonePresenceSubscribe&: $
%callbac'(eference&: $
%notify)(*&: %http://+++.yoururl.here/notification/&,
%callbac'-ata&: %oSomethin&,
%notificationormat&: %2*&
3,
%clientorrelator&: %14567&
3
3
4.1.# R%+%" P'r'(%"%r
T' , % 1 : S+5 r i % "o Zo&' , P r%%&5% No" i i 5 ' " i o& R%+% " P' r'(%"% r
P'r'(%"%r D%5rip"io& Op"io&',
&o"iyURL T!i i +%) y "!% %r6%r "o POST "!% &o"ii5'"io&
yo+ o i&5,+)% "!% URL o yo+r o7& ,i"%&%r
'pp,i5'"io&.
No
5',,'5/D'"' D'"' "!% 'pp,i5'"io& 5'& r%i"%r 7i"! "!% %r6%r 7!%&
+5rii& "o &o"ii5'"io&* '&) "!'" 'r% p'%) '5/
+&5!'&%) i& %'5! o "!% r%,'"%) &o"ii5'"io&. T!%%
)'"' 5'& % +%) y "!% 'pp,i5'"io& i& "!% pro5%i&
o "!% &o"ii5'"io&* %.. or 5orr%,'"io& p+rpo%.
%
&o"ii5'"io&For('" D%'+,": GML
App,i5'"io& 5'& p%5iy or('" o "!% r%o+r5%
r%pr%%&"'"io& i& &o"ii5'"io& "!'" 'r% r%,'"%) "o "!i
+5rip"io&. T!% 5!oi5% i %"7%%& ?GML* SON@.
%
5,i%&"Corr%,'"or U&i+%,y i)%&"ii% "!i 5r%'"% +5rip"io& r%+%". I
"!%r% i 5o((+&i5'"io& 'i,+r% )+ri& "!% r%+%"*
+i& "!% '(% 5,i%&"Corr%,'"or 7!%& r%"ryi& '
r%+%" ',,o7 "!% op%r'"or "o '6oi) 5r%'"i& '
%
Pae ,
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
8/21
Zonal Presence REST V1.0 Document Version: 1.1
)+p,i5'"% +5rip"io&.
4.1.3 R%po&%
HTTP/1.1 401 reate
ontent!Type: application/"son
*ocation: http://example.com/1/zonalpresence/subscriptions/yumscoffee/14567
-ate: Thu 06, une 4009 04:71:79 2T
ontent!*enth: 1046
$
%eli;ery(eceiptSubscription&: $
%callbac'(eference&: $
%notify)(*&: %http://www.yoururl.here/notification/&,
%callbac'-ata&: %oSomethin&,
%notificationormat&: %2*&
3,
%clientorrelator&: %14567&,
%resource)(*&:%http://example.com/1/zonalpresence/subscriptions/yumscoffee/14567& 3
3
4.1.4 R%po&% P' r'(%"% r
A ;#01; r%o+r5% i&)i5'"% "!% +5rip"io& !' %%& 5r%'"%) '" "!% URL i& "!% Lo5'"io& !%')%r. ;1#342;
i&)i5'"% "!% +5rip"io&ID "!'" 7i,, % +%) 7!%& 5'&5%,,i& "!% +5rip"io&.
T' , % # : S+5 r i p " i o& o Zo&' , P r%%&5% No" i i 5 ' " i o& R%po&% P' r'(%"% r
P'r'(%"%r D%5rip"io& Op"io&',
&o"iyURL T!i i +%) y "!% %r6%r "o POST "!% &o"ii5'"io&
yo+ o i&5,+)% "!% URL o yo+r o7& ,i"%&%r
'pp,i5'"io&.
No
5',,'5/D'"' D'"' "!% 'pp,i5'"io& 5'& r%i"%r 7i"! "!% %r6%r 7!%&
+5rii& "o &o"ii5'"io&* '&) "!'" 'r% p'%) '5/
+&5!'&%) i& %'5! o "!% r%,'"%) &o"ii5'"io&. T!%%
)'"' 5'& % +%) y "!% 'pp,i5'"io& i& "!% pro5%i&
o "!% &o"ii5'"io&* %.. or 5orr%,'"io& p+rpo%.
%
&o"ii5'"io&For('" D%'+,": GML
App,i5'"io& 5'& p%5iy or('" o "!% r%o+r5%
r%pr%%&"'"io& i& &o"ii5'"io& "!'" 'r% r%,'"%) "o "!i+5rip"io&. T!% 5!oi5% i %"7%%& ?GML* SON@.
%
Pae
http://example.com/1/zonalpresence/subscriptions/yumscoffee/12345http://www.yoururl.here/notification/http://example.com/1/zonalpresence/subscriptions/yumscoffee/12345http://www.yoururl.here/notification/ -
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
9/21
Zonal Presence REST V1.0 Document Version: 1.1
5,i%&"Corr%,'"or U&i+%,y i)%&"ii% "!i 5r%'"% +5rip"io& r%+%". I
"!%r% i 5o((+&i5'"io& 'i,+r% )+ri& "!% r%+%"*
+i& "!% '(% 5,i%&"Corr%,'"or 7!%& r%"ryi& '
r%+%" ',,o7 "!% op%r'"or "o '6oi) 5r%'"i& '
)+p,i5'"% +5rip"io&.
%
r%o+r5%URL T!% URL "!'" '))r%% "!% r%o+r5%. M'"5!% "!%
i&or('"io& i& "!% Lo5'"io& !%')%r.
No
2 C'&5%, S+5rip"io& "o Zo&', Pr%%&5% No"ii5'"io&
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o 5'&5%, "!% +5rip"io& "o 9o&', pr%%&5% &o"ii5'"io&.
2.1.1 R%+%"
DELETE http://example.com/1/zonalpresence/subscriptions/yumscoffee/1234 !TT"/1.1
!ost: example.com:#$
%ccept: application/&son
2.1.# R%+%" P'r'(%"% r
No&%
2.1.3 R%po&%
HTTP/1.1 406
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
10/21
Zonal Presence REST V1.0 Document Version: 1.1
%user>;ent&: ?
$
%timestamp&: %4011!04!01T14:00:00&,
%aress&: %tel:@1A1514567AB&,
%zone>nter&: $
%current#ccessPoint&: %femto01&
3
3,
$
%timestamp&: %4011!04!01T14:00:00&,
%aress&: %tel:@1A151456000&,
%zone>xit&: $
%current#ccessPoint&: %femto04&
3
3,
$
%timestamp&: %4011!04!01T14:00:00&,
%aress&: %tel:@1A151457000&,
%zoneTransfer&: $
%current#ccessPoint&: %femto04&,
%pre;ious#ccessPoint&: %femto01&
3
3
C
3
3
T' , % 3 : Zo&' , P r%%&5% No" i i 5 ' " i o& P' r'(%"% r
T!% SON r%po&% i '& o%5" &'(%) 9o&',Pr%1%&5%No"i0i5'"io&. T!i 5o&"'i& "!% 5',,4'5/D'"'*
"i(%1"'(p* 9o&%I)* '&) '" ,%'" o&% +1%rE6%&"o%5"* 7!i5! i 5o(pri%) o "!% o,,o7i& p'r'(%"%r:
P'r'(%"%r D%5rip"io& Op"io&',
"i(%S"'(p D'"% '&) "i(% o )'y o "!% %6%&". No
'))r% T!% i)%&"i"y o "!% +%r* %i"!%r ' MSISDN or
A&o&y(o+ C+"o(%r R%%r%&5% JACRK
No
+%rE6%&" C'& % o&% o "!% o,,o7i&:
9o&%E&"%r7!i5! ,i" "!% 5+rr%&"A55%Poi&"
9o&%E8i"7!i5! ,i" "!% 5+rr%&"A55%Poi&"
9o&%Tr'&%r7!i5! ,i" "!%5+rr%&"A55%Poi&" '&) pr%6io+A55%Poi&"
No
Pae 10
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
11/21
Zonal Presence REST V1.0 Document Version: 1.1
+%ry Zo&% Li"
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +%ry or ',, "!% 9o&% i)%&"ii%r i" i '+"!ori9%) "o +%.
.1.1 R%+%"
>T http://example.com/1/zonalpresence/Dueries/zone HTTP/1.1
Host: example.com:80
#ccept: application/"son
.1.# R%+%" P'r'(%"%r
No&%
.1.3 R%po&%
HTTP/1.1 400 OE
ontent!Type: application/"son
ontent!*enth: 1046
-ate: Thu 06, une 4009 04:71:79 2T
$
%zone*ist&: $
%zone&: ?
$
%zone=&: %yumscoffee&
3,
$
%zone=&: %yumsmuseum&
3
C
3
3
.1.4 R%po&% P' r'(%"% r
T!% SON r%po&% + '& o%5" &'(%) 9o&%Li1"7!i5! ('y 5o&"'i& '& o%5" &'(%) 9o&%* 7!i5! i& "+r&
5o&"'i& '" ,%'" o&% o "!% o,,o7i&:
T' , % 4 : +% r y Zo&% L i " R% po&% P ' r '(% " % r
P'r'(%"%r D%5rip"io& Op"io&',
9o&%I) U&i+% i)%&"ii%r or "!% 9o&%. No
Pae 11
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
12/21
Zonal Presence REST V1.0 Document Version: 1.1
+%ry Zo&% S"'"+
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +%ry ' 9o&% or i"; "'"+ '&) o"!%r r%,%6'&" i&or('"io&.
M.1.1 R%+%"
>T http://example.com/1/zonalpresence/Dueries/zoneStatusFzone=Gyumscoffee HTTP/1.1
Host: example.com:80
#ccept: application/"son
M.1.# R%+%" P'r'(%"%r
T!% 9o&%I)i p'%) ' '& '""ri+"% i& "!% =TTP r%+%".
M.1.3 R%po&%
HTTP/1.1 400 OE
ontent!Type: application/"son
ontent!*enth: 1046
-ate: Thu 06, une 4009 04:71:79 2T
'
%zone(tatus): '
%zone*+): ,yumscoffee)-
%numberfsers): 30-
%numberf%ccess"oints): 12-
%numberfnsericeable%ccess"oints): 1
3
M.1.4 R%po&% P' r'(%"% r
T!% SON r%po&% + '& o%5" &'(%) 9o&%S"'"+17!i5! 5o&"'i& "!% o,,o7i&:
T' , % 2 : +% r y Zo&% L i " R% po&% P ' r '(% " % r
P'r'(%"%r D%5rip"io& Op"io&',
9o&%I) U&i+% i)%&"ii%r or "!% 9o&%. No
&+(%rOU%r N+(%r o +%r 5+rr%&",y 5'(p%) o&"o "o "!% '55%
poi&" 7i"!i& "!% 9o&%.
No
&+(%rOA55%Poi&" N+(%r o '55% poi&" 7i"!i& "!% 9o&%. No
Pae 12
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
13/21
Zonal Presence REST V1.0 Document Version: 1.1
&+(%rOU&%r6i5%',%A55%Poi
&"
N+(%r o i&op%r',% '55% poi&" 7i"!i& "!% 9o&%. No
+%ry ' &'(%) %" o A55% Poi&" S"'"+
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +%ry ' &'(%) %" o '55% poi&" "'"+.
.1.1 R%+%"
>T http://example.com/1/zonalpresence/Dueries/accessPointStatusFzone=GyumscoffeeaccessPoint=Gfemto01 HTTP/1.1
Host: example.com:80
#ccept: application/"son
.1.# R%+%" P'r'(%"%r
T!% 9o&%I)'&) o&% or (or% '55%11Poi&"I)'r% p'%) ' '""ri+"% i& "!% =TTP r%+%".
.1.3 R%po&%
HTTP/1.1 400 OE
ontent!Type: application/"son
ontent!*enth: 1046
-ate: Thu 06, une 4009 04:71:79 2T
$
%accessPointStatus*ist&: $
%zone=&: %yumscoffee&,
%accessPointStatus&: ?
$
%accessPoint=&: %femto01&,
%accessType&: %femto&,
%numberOf)sers&: 1A,
%operationStatus&: %S>(I=>#J*>&,
%location=nfo&: $
%lonitue&: !B9.A50776,
%latitue&: 65.ABB445,
%altitue&: 100.0,
%accuracy&: 10.0
3
3
C
3
Pae 1
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
14/21
Zonal Presence REST V1.0 Document Version: 1.1
3
.1.4 R%po&% P' r'(%"% r
T!% SON r%po&% + '& o%5" &'(%) '55%11Poi&"S"'"+1 7!i5! 5o&"'i& "!% o,,o7i&:
T' , % H : +% r y A 5 5 % P o i & " S " ' " + R% po&% P ' r '(% " % r
P'r'(%"%r D%5rip"io& Op"io&',
'55%Poi&"I) U&i+% i)%&"ii%r or "!% '55% poi&". No
'55%Typ%T!% '55% "yp%. C'& % o&% o "!% o,,o7i&:
- %("o- 7ii- pi5o- ('r5o
- 7i('8
No
op%r'"io&S"'"+T!% 5+rr%&" "'"% o "!% '55% poi&". C'& %:
- S%r6i5%',%- U&%r6i5%',%
No
,o5'"io&I&oT!% 5oor)i&'"% o "!% '55% poi&" i&5+)i&:
- ,'"i"+)%- ,o&i"+)%- ',"i"+)%- '55+r'5yNo"%: i ,o5'"io&I&o i +pp,i%)* o&,y ,'"i"+)% '&),o&i"+)% 'r% ('&)'"ory* ',"i"+)% '&) '55+r'5y 'r%op"io&',.
%
10 +%ry ',, A55% Poi&" S"'"+
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +%ry ',, '55% poi&" "'"+;.
10.1.1 R%+%"
>T http://example.com/1/zonalpresence/Dueries/accessPointStatusFzone=GyumscoffeeHTTP/1.1
Host: example.com:80#ccept: application/"son
10.1.# R%+%" P'r'(%"%r
T!% 9o&%I)i p'%) ' '& '""ri+"% i& "!% =TTP r%+%".
10.1.3 R%po&%
HTTP/1.1 400 OEontent!Type: application/"son
Pae 1#
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
15/21
Zonal Presence REST V1.0 Document Version: 1.1
ontent!*enth: 1046
-ate: Thu 06, une 4009 04:71:79 2T
$
%accessPointStatus*ist&: $
%zone=&: %yumscoffee&,
%accessPointStatus&: ?
$
%accessPoint=&: %femto01&,
%accessType&: %femto&,
%numberOf)sers&: 1A,
%operationStatus&: %S>(I=>#J*>&,
%location=nfo&: $
%lonitue&: !B9.A50776,
%latitue&: 65.ABB445,
%altitue&: 100.0,
%accuracy&: 10.0
3
3,
$
%accessPoint=&: %femto04&,
%accessType&: %femto&,
%numberOf)sers&: 15,
%operationStatus&: %S>(I=>#J*>&,
%location=nfo&: $
%lonitue&: !80.A50776,
%latitue&: 66.ABB445,
%altitue&: 60.0,
%accuracy&: 10.0
3
3
C
3
3
10.1.4 R%po&% P'r'(%"%r
T!% SON r%po&% + '& o%5" &'(%) '55%11Poi&"S"'"+1 7!i5! 5o&"'i& "!% o,,o7i&:
T' , % : +% r y A 5 5 % P o i & " S " ' " + R% po&% P ' r '(% " % r
P'r'(%"%r D%5rip"io& Op"io&',
'55%Poi&"I) U&i+% i)%&"ii%r or "!% '55% poi&". No
'55%Typ%T!% '55% "yp%. C'& % o&% o "!% o,,o7i&:
No
Pae 1)
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
16/21
Zonal Presence REST V1.0 Document Version: 1.1
- %("o- 7ii- pi5o- ('r5o- 7i('8
op%r'"io&S"'"+T!% 5+rr%&" "'"% o "!% '55% poi&". C'& %:
- S%r6i5%',%- U&%r6i5%',%
No
,o5'"io&I&oT!% 5oor)i&'"% o "!% '55% poi&" i&5+)i&:
- ,'"i"+)%- ,o&i"+)%- ',"i"+)%- '55+r'5yNo"%: i ,o5'"io&I&o i +pp,i%)* o&,y ,'"i"+)% '&),o&i"+)% 'r% ('&)'"ory* ',"i"+)% '&) '55+r'5y 'r%op"io&',.
%
11 +%ry ' U%r 7i"!i& ' Zo&%
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +%ry o&% or (or% +%rJK 7i"!i& ' 9o&%.
11.1.1 R%+%"
>T http://example.com/1/zonalpresence/Dueries/userStatusFzone=GyumscoffeearessGtel:@1A151456000 HTTP/1.1
Host: example.com:80
#ccept: application/"son
11.1.# R%+%" P'r'(%"%r
T!% 9o&%I)'&) o&% or (or% '))r%11'r% p'%) ' '""ri+"% i& "!% =TTP r%+%".
11.1.3 R%po&%
HTTP/1.1 400 OE
ontent!Type: application/"son
ontent!*enth: 1046
-ate: Thu 06, une 4009 04:71:79 2T
$
%userStatus*ist&: $
%zone=&: %yumscoffee&,
%userStatus&: ?
$
%aress&: %tel:@1A151456000&,
%accessPoint=& : %femto04&
3 C
Pae 1+
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
17/21
Zonal Presence REST V1.0 Document Version: 1.1
33
11.1.4 R%po&% P'r'(%"%r
T!% SON r%po&% + '& o%5" &'(%) +1%rS"'"+1Li1"7!i5! 5o&"'i& ' 9o&%I)'&) ' +1%rS"'"+17i"! "!%
o,,o7i&:
T' , % M : +% r y % r 7 i" ! i & ' Zo&% R% po&% P ' r'(% " % r
P'r'(%"%r D%5rip"io& Op"io&',
'))r% T!% i)%&"i"y o "!% +%r* %i"!%r ' MSISDN or
A&o&y(o+ C+"o(%r R%%r%&5% JACRK.
No
'55%Poi&"ID U&i+% i)%&"ii%r or "!% '55% poi&". No
1# +%ry ',, U%r o& '& A55% Poi&"
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +%ry ',, "!% +%r o& '& '55% poi&".
1#.1.1 R%+%"
>T http://example.com/1/zonalpresence/Dueries/userStatusFzone=GyumscoffeeaccessPoint=Gfemto04 HTTP/1.1
Host: example.com:80
#ccept: application/"son
1#.1.# R%+%" P'r'(%"%r
T!% 9o&%I)'&) '55%11Poi&"I)'r% p'%) ' '""ri+"% i& "!% =TTP r%+%".
1#.1.3 R%po&%
HTTP/1.1 400 OE
ontent!Type: application/"son
ontent!*enth: 1046
-ate: Thu 06, une 4009 04:71:79 2T
$
%userStatus*ist&: $
%zone=&: %yumscoffee&,
%userStatus&: ?
$
%aress&: %tel:@1A151456000&,
%accessPoint=& : %femto04&
Pae 1,
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
18/21
Zonal Presence REST V1.0 Document Version: 1.1
3,
$
%aress&: %tel:@1A151457000&,
%accessPoint=& : %femto04&
3 C
33
1#.1.4 R%po&% P'r'(%"%r
T!% SON r%po&% + '& o%5" &'(%) +1%rS"'"+1Li1"7!i5! 5o&"'i& ' 9o&%I)'&) ' +1%rS"'"+17i"! "!%
o,,o7i&:
T' , % : +% r y % r o& '& A 5 5 % Po i & " R% po&% P ' r'(% " % r
P'r'(%"%r D%5rip"io& Op"io&',
'))r% T!% i)%&"i"y o "!% +%r* %i"!%r ' MSISDN or
A&o&y(o+ C+"o(%r R%%r%&5% JACRK.
No
'55%Poi&"ID U&i+% i)%&"ii%r or "!% '55% poi&". No
13 +%ry ',, U%r 7i"!i& ' Zo&%
T!i (%"!o) ',,o7 "!% W% 'pp,i5'"io& "o +%ry ',, "!% +%r 7i"!i& ' 9o&%.
13.1.1 R%+%"
>T http://example.com/1/zonalpresence/Dueries/userStatusFzone=Gyumscoffee HTTP/1.1
Host: example.com:80
#ccept: application/"son
13.1.# R%+%" P'r'(%"%r
T!% 9o&%I)i p'%) ' '& '""ri+"% i& "!% =TTP r%+%".
13.1.3 R%po&%
HTTP/1.1 400 OE
ontent!Type: application/"son
ontent!*enth: 1046
-ate: Thu 06, une 4009 04:71:79 2T
$
%userStatus*ist&: $
Pae 1
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
19/21
Zonal Presence REST V1.0 Document Version: 1.1
%zone=&: %yumscoffee&,
%userStatus&: ?
$
%aress&: %tel:@1A151456000&,
%accessPoint=& : %femto04&
3,
$
%aress&: %tel:@1A151457000&,
%accessPoint=& : %femto04&
3,
$
%aress&: %tel:@1A1514567AB&,
%accessPoint=& : %femto01&
3 C
33
13.1.4 R%po&% P'r'(%"%r
T!% SON r%po&% + '& o%5" &'(%) +1%rS"'"+1Li1" 7!i5! 5o&"'i& ' 9o&%I)'&) ' +1%rS"'"+17i"! "!%
o,,o7i&:
T' , % 10 : +% r y % r o& '& A 5 5 % P o i & " R% po&% P ' r'(% " % r
P'r'(%"%r D%5rip"io& Op"io&',
'))r% T!% i)%&"i"y o "!% +%r* %i"!%r ' MSISDN or
A&o&y(o+ C+"o(%r R%%r%&5% JACRK.
No
'55%Poi&"ID U&i+% i)%&"ii%r or "!% '55% poi&". No
14 R%po&% Co)% E85%p"io&
14.1 R%po&% Co)%
=TTP r%po&% 5o)% 'r% +%) "o i&)i5'"%:
#00 S+55%
400 B') r%+%" 5!%5/ "!% %rror (%'% or )%"'i,
401 A+"!%&"i5'"io& 'i,+r%* 5!%5/ yo+r '+"!%&"i5'"io& )%"'i,
403 Fori))%& p,%'% pro6i)% '+"!%&"i5'"io& 5r%)%&"i',
404 No" o+&): (i"'/% i& "!% !o" or p'"! o "!% %r6i5% URI
402 M%"!o) &o" +ppor"%): or %8'(p,%* yo+ (i"'/%&,y +%) ' =TTP
-
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
20/21
Zonal Presence REST V1.0 Document Version: 1.1
200 T!% %r6%r %&5o+&"%r%) '& +&%8p%5"%) 5o&)i"io&. T!i 5o+,) % i&5orr%5" '+"!%&"i5'"io& )%"'i,
or ,i(i"%) +%r p%r(iio&
203 S%r6%r +y '&) %r6i5% +&'6'i,',%. P,%'% r%"ry "!% r%+%".
For (or% )%"'i, o& "!%%* r%%r "o http://www.ietf.org/rfc/rfc2616.txt .
14.# E85%p"io&
HTTP/1.1 600 Ja (eDuest
ontent!Type: application/"son
ontent!*enth: 1456
-ate: Thu, 06 un 4009 04:71:79 2T
$KreDuest>rrorK: $
Kser;ice>rrorK: $
Kmessae=K: KSI0004K,
KtextK: K =n;ali input ;alue for messae part L1K,
K;ariablesK: K tel:@1A509B00000K
3
3
T!i %5"io& ,i" "!% '6'i,',% %rror 5o)%* "!% poi,% r%'o& 7!y "!% %85%p"io& ('y !'6% o55+rr%)* '&)
poi,% o,+"io&.
14.#.1 S%r6i5% E85%p" io&
T!% o,,o7i& %r6i5% %85%p"io& ('y % "!ro7&:
T' , % 11: S% r6 i 5% E85%p " i o&
Error E8p,'&'"io&
SVC0001 S%r6i5% %rror o55+rr%) A %r6i5%-r%,'"%) %rror !' o55+rr%) ' ' r%+," o ' 5,i%&"
i&6o5'"io& o& "!% %r6i5%. T!i 5'"%ory 5'& % +%) ori(p,%(%&"'"io&-p%5ii5 %rror. Co&"'5" "!% +ppor" "%'(.
SVC000# I&6',i) i&p+" 6',+% A& i&p+" p'r'(%"%r 6',+% i &o" o "!% %8p%5"%) "yp%. C!%5/
"!% p'r'(%"%r "yp% '&) r%-+(i" yo+r r%+%".
SVC0004 No 6',i) '))r%J%K T!% r%+%"%) "%r(i&', )%6i5% '))r% )o% &o" %8i". U% '&
'))r% "!'" %8i".
14.#.# Po,i5y E85%p"io&
A po,i5y %85%p"io& (%'& "!'" "!% r%+%" y&"'8 i 6',i)* !o7%6%r '& op%r'"or po,i5y !' %%& ro/%&.
POL0001- Po,i5y %rror o55+rr%)
Pae 20
http://www.ietf.org/rfc/rfc2616.txthttp://www.ietf.org/rfc/rfc2616.txt -
8/12/2019 Aepona V1 0 Femto Zonal Presence REST
21/21
Zonal Presence REST V1.0 Document Version: 1.1
T!% 'o6% %85%p"io& ('y % "!ro7& "o i&)i5'"% ' '+," r%,'"i& "o ' po,i5y 'o5i'"%) 7i"! "!% %r6i5%. T!i
5'"%ory 5'& % +%) or i(p,%(%&"'"io&-p%5ii5 %rror +5! ':
T' , % 1# : Po , i 5 y E r ro r Co)%
Error E8p,'&'"io&
POL-00H: TPA %85%%)%) i"
('8i(+( ',,o7%) r'"% o
"r'&'5"io&
T!% ('8i(+( r'"% o "r'&'5"io& i %85%%)%). E&+r% "!'"
"!% r'"% o yo+r r%+%" i 7i"!i& "!% ,i(i" %" +p i& yo+r
SLA* %.. 10 TPS JTr'&'5"io& P%r S%5o&)K.
POL-00M: TPA i i&6',i) T!% T!ir) P'r"y App,i5'"io& '+"!%&"i5'"io& )%"'i, 'r%
i&5orr%5". C!%5/ yo+r 'i5 '+"!%&"i5'"io& +%r&'(% '&)
p'7or) 'r% 5orr%5" '&) r%-+(i" yo+r r%+%".
POL-014: W!i"% Li" i %&or5%)*
'&) '))r% i &o" i& W!i"% Li"
A 7!i"% ,i" i %&or5%) '&) "!% &+(%r i &o" i& "!% 7!i"% ,i".
C!%5/ yo+r SLA )%"'i,.
POL-012: B,'5/ Li" i %&or5%)*
'&) '))r% i i& B,'5/ Li"
A ,'5/ ,i" i %&or5%) '&) "!% &+(%r i i& "!% ,'5/ ,i".
C!%5/ yo+ SLA )%"'i,.
POL-01H: M'8 R%+%" i
%&or5%)* '&) ('8 r%+%" !'
%%& %85%%)%)
T!% ('8i(+( &+(%r o r%+%" or "!i %r6i5% i
%85%%)%). Co&"'5" "!% +ppor" "%'(.
POL-01: Op%r'"io& i &o" ',,o7%) T!% (%"!o)>op%r'"io& i &o" +ppor"%) i& yo+r 5+rr%&" SLA.
C!%5/ yo+r SLA '&) +% ' (%"!o) "!'" i +ppor"%).
POL-040: M'8 D%"i&'"io&A))r%% i %&or5%) '&)
('8i(+( )%"i&'"io& '))r%% !'
%%& %85%%)%)
A ('8i(+( )%"i&'"io& '))r% ,i(i" i %&or5%) '&) i" !'%%& %85%%)%). C!%5/ yo+r SLA or "!% ,i(i" '&) r%-+(i"
yo+r r%+%".