Aepona V1 0 Femto Zonal Presence REST

download Aepona V1 0 Femto Zonal Presence REST

of 21

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%+%".