{"id":8230,"date":"2022-06-21T14:00:01","date_gmt":"2022-06-21T14:00:01","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=8230"},"modified":"2022-06-24T17:41:44","modified_gmt":"2022-06-24T17:41:44","slug":"web-api-top-page","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-top-page\/","title":{"rendered":"Web API, Top Page"},"content":{"rendered":"<p>This article describes the content of the Web API services and the Top Page in greater detail.<\/p>\n<p>The <a href=\"https:\/\/www.use-snip.com\/downloads\/snip_web\/\">Web API Plug-In<\/a> provides a way to perform daily management of your Caster remotely using any browser.\u00a0\u00a0 This provides two immediate advantages.\u00a0 First, you can access <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> to get status reports and manage user connections and base stations from anywhere, including your cell phone while in the field.\u00a0 Second, you no longer need allow someone to be logged onto the <strong><span style=\"color: #0000ff;\">SNIP<\/span><\/strong> host machine in order to do this.\u00a0\u00a0 So your tech support staff can now access key controls and information in <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> but not have access to the host machine itself or to various core Caster settings.<\/p>\n<p>If you resell time on your Caster, or you allow some of your your Customer accounts to manage their own <strong>User Accounts<\/strong> and \/ or <strong>Base Stations<\/strong>, the Web API Plug-In provides further features you will want to use.\u00a0 For each Customer account you can enable the use of the Web API Plug-In in either a <em>read-write<\/em> or <em>read-only<\/em> mode of use. [In fact, because each account has two passwords assigned to it, you can do both.]\u00a0 You can set the number of users and base that the account is allowed to create and manage. The customer accounts you setup in this way can then create, manage, and troubleshoot their own NTRIP Client connections.<\/p>\n<h3>The Top Page<\/h3>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignright wp-image-8457\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage-161x300.png\" alt=\"\" width=\"230\" height=\"430\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage-161x300.png 161w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage-548x1024.png 548w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage-27x50.png 27w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage-600x1121.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage-320x598.png 320w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_TopPage.png 720w\" sizes=\"auto, (max-width: 230px) 100vw, 230px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>When you first <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-login\/\" target=\"_blank\" rel=\"noopener\">login<\/a> to the Web API you are presented with a top page listing all the major operations your account is allowed to perform. For example, when using a <em>read-only<\/em> account you are allowed to show various detailed reports about Users and Bases; but are not allowed to create \/ edit \/ delete the content in any User or Base entry.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>The top page is divided into five sections as follow<\/p>\n<p>The first section has some basic reports <strong>about the Caster<\/strong> (such as as the SNIP::STATUS report).<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-8458 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-1.png?_t=1656091824\" alt=\"\" width=\"720\" height=\"90\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-1.png 720w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-1-300x38.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-1-50x6.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-1-600x75.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-1-320x40.png 320w\" sizes=\"auto, (max-width: 720px) 100vw, 720px\" \/><\/a><\/p>\n<p>The second section deals with <strong>User Accounts<\/strong>.\u00a0 Here you can show, edit, create and delete User Accounts that are assigned to your Customer Account.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-8462 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-2.png?_t=1656091824\" alt=\"\" width=\"720\" height=\"220\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-2.png 720w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-2-300x92.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-2-50x15.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-2-600x183.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-2-320x98.png 320w\" sizes=\"auto, (max-width: 720px) 100vw, 720px\" \/><\/a><\/p>\n<p>The third section shows<strong> Base stations<\/strong> connecting with methods other than as a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-pushed-streams-tab\/\" target=\"_blank\" rel=\"noopener\">Push-In<\/a> type.\u00a0 This section is shown only to Admin users.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-3.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-8461 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-3.png?_t=1656091824\" alt=\"\" width=\"720\" height=\"180\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-3.png 720w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-3-300x75.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-3-50x13.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-3-600x150.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-3-320x80.png 320w\" sizes=\"auto, (max-width: 720px) 100vw, 720px\" \/><\/a><\/p>\n<p>The fourth section shows Base station connections and Reservations using the <strong>Push-In<\/strong> connection type.\u00a0 Here you can show, edit, create and delete the Push-In Reservation that are assigned to your Customer Account. [Again, the Admin account sees everything.]<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-4.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-8460 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-4.png?_t=1656091824\" alt=\"\" width=\"720\" height=\"220\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-4.png 720w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-4-300x92.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-4-50x15.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-4-600x183.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-4-320x98.png 320w\" sizes=\"auto, (max-width: 720px) 100vw, 720px\" \/><\/a><\/p>\n<p>The fifth section show <strong>IP connections<\/strong>.\u00a0 Here you can show reports on how each IP has been used.\u00a0 This section is shown only to Admin users.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-5.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-8459 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-5.png?_t=1656091824\" alt=\"\" width=\"720\" height=\"160\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-5.png 720w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-5-300x67.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-5-50x11.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-5-600x133.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/tp-5-320x71.png 320w\" sizes=\"auto, (max-width: 720px) 100vw, 720px\" \/><\/a><\/p>\n<p>A final section shows the same information about general Caster usage as the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/uptime-report\/\">Up Time<\/a> report<\/p>\n<hr \/>\n<p>&nbsp;<\/p>\n<h3>Transversal through the Web API Pages<\/h3>\n<p>When you first <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-login\/\" target=\"_blank\" rel=\"noopener\">login<\/a> to the Web API you are presented with a top page listing all the major operations your account is allowed to perform. For example, when using a <em>read-only<\/em> account you are allowed to show various detailed reports about Users and Bases; but are not allowed to create \/ edit \/ delete the content in any User or Base entry.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-8360\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-300x181.png\" alt=\"\" width=\"606\" height=\"365\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-300x181.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-1024x617.png 1024w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-768x463.png 768w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-50x30.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-920x554.png 920w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-600x361.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages-320x193.png 320w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/06\/WebAPI_mainPages.png 1212w\" sizes=\"auto, (max-width: 606px) 100vw, 606px\" \/><\/a><\/p>\n<p>In the diagram above the major steps are shown graphically from left to right (click to enlarge).\u00a0 After a successful login, the top page is shown.\u00a0 This is composed of five major sections.<\/p>\n<p style=\"padding-left: 40px;\">The first section has some basic reports <strong>about the Caster<\/strong> (such as as the SNIP::STATUS report).<\/p>\n<p style=\"padding-left: 40px;\">The second section deals with <strong>User Accounts<\/strong>.\u00a0 Here you can show, edit, create and delete User Accounts that are assigned to your Customer Account.<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>To See a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-user-reports\/\" target=\"_blank\" rel=\"noopener\">User Report<\/a><\/li>\n<li>To <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-add-a-user\/\" target=\"_blank\" rel=\"noopener\">Add a User<\/a><\/li>\n<li>To <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-add-a-user\/\" target=\"_blank\" rel=\"noopener\">Edit a User<\/a><\/li>\n<li>To <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-delete-a-user\/\" target=\"_blank\" rel=\"noopener\">Delete a User<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p style=\"padding-left: 40px;\">The third section shows<strong> Base stations<\/strong> connecting with methods other than as a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-pushed-streams-tab\/\" target=\"_blank\" rel=\"noopener\">Push-In<\/a> type.\u00a0 This section is shown only to Admin users.<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>To See a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-base-reports\/\" target=\"_blank\" rel=\"noopener\">Base Station Report<\/a><\/li>\n<li>To <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-map-baseusers\/\" target=\"_blank\" rel=\"noopener\">Plot a Base and its Users<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p style=\"padding-left: 40px;\">The fourth section shows Base station connections and Reservations using the <strong>Push-In<\/strong> connection type.\u00a0 Here you can show, edit, create and delete the Push-In Reservation that are assigned to your Customer Account. [Again, the Admin account sees everything.]<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>To See a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-base-reports\/\" target=\"_blank\" rel=\"noopener\">Base Station Report<\/a><\/li>\n<li>To <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-add-a-base\/\" target=\"_blank\" rel=\"noopener\">Add a Base Station<\/a><\/li>\n<li>To <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-add-a-base\/\" target=\"_blank\" rel=\"noopener\">Edit a Base Station<\/a><\/li>\n<li>To <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-delete-a-base\/\" target=\"_blank\" rel=\"noopener\">Delete a Base Station<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p style=\"padding-left: 40px;\">The fifth section show <strong>IP connections<\/strong>.\u00a0 Here you can show reports on how each IP has been used.\u00a0 This section is shown only to Admin users.<\/p>\n<p>These sections produce a list of items (Users, Bases, or IPs) in a table which can then be selected and operated on.\u00a0 Each of these has a <strong>filter<\/strong> aspect to manage the size of the returned table.\u00a0 You can enter a name or partial name (the filter is case insensitive) to filter the resulting list to a subset. If the filter is left blank all the items which the account is authorized to see are shown.\u00a0 The reports in these three item are heavily cross linked to each other to make exploring the Caster easier.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-5943 aligncenter\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2019\/01\/LLLsm.png\" alt=\"\" width=\"256\" height=\"256\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2019\/01\/LLLsm.png 256w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2019\/01\/LLLsm-150x150.png 150w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2019\/01\/LLLsm-50x50.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2019\/01\/LLLsm-60x60.png 60w\" sizes=\"auto, (max-width: 256px) 100vw, 256px\" \/><\/p>\n<p>The typical process is to log in, select the operation you wish to perform from the top page, select the User or MountPt that you are interested in from the displayed table, and then <em>show<\/em> \/ <em>edit<\/em> \/ <em>delete<\/em> or <em>create<\/em> it.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This article describes the content of the Web API services and the Top Page in greater detail. The Web API Plug-In provides a way to perform daily management of your Caster remotely using any browser.\u00a0\u00a0 This provides two immediate advantages.\u00a0 First, you can access SNIP to get status reports and [&hellip;]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[418],"ht-kb-tag":[438,201,518],"class_list":["post-8230","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-reports","ht_kb_tag-login","ht_kb_tag-reports","ht_kb_tag-web-api"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8230","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=8230"}],"version-history":[{"count":17,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8230\/revisions"}],"predecessor-version":[{"id":8467,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8230\/revisions\/8467"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=8230"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=8230"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=8230"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}