Differences

This shows you the differences between two versions of the page.

--- emis_public_rest_api [2022/06/01 19:21] – [Currently Working REST API to be Deprecated] ghachey
+++ emis_public_rest_api [2023/10/30 14:58] (current) – [Lookup Lists (Vocab)] ghachey
@@ Line 1: / Line 1: @@
 ====== Using the Pacific EMIS REST API ======
-There are a few things to note as convention for these docs.
+This page documents the Pacific EMIS REST API (or RESTful API). There are a few things to note as convention for these docs.
   * ''<emis_root>'' is used to designate the base URL of the EMIS system (e.g. fedemis.doe.fm for FSM).
@@ Line 80: / Line 80: @@
 <note tip>for example perhaps using the code table gives you additional ways of iterating over the standards or criteria.</note>
+==== Vocab lookup ====
+A special type of lookup you get when loading the app or starting to use the REST API is the "vocab". The vocab, short for vocabularies, is a means to localize the Pacific EMIS terminologies. Different countries have different terminologies, for example:
+  * Districts in FSM are States, in RMI they are Atolls/Islands and in Solomon Islands they are provinces, or
+  * Grades vs Grade Levels vs Class Levels
+While referred to differently in different countries, they are in essence the same things. So the Pacific EMIS uses one common term in the source code but in the UI it can easily be translated to the country's specific preferred terminology. For example, in the source code developers would work with "District" but in the web user interfaces the word District would translate to the country specific terminology (State in FSM, Atoll/Island in RMI, etc.). In the current web UI, this is achieve through the use of simple dynamic filters in the HTML. Any technique can be used. The important thing to know are the list of vocabs in use for a specific country which are available in the lookups' vocab object as shown below.
+{{ :rest-api:rest-api-vocab-1.png?nolink |}}
 ===== Entity Lists =====
@@ Line 607: / Line 619: @@
 ===== Currently Working REST API to be Deprecated  =====
-Some of the REST API that are currently available and working will be deprecated in favor of their final version 1. They will continue working for the foreseeable future but it will be necessary to migrate to the new ones that will soon be documented herein. Those currently working but soon be to improved are listed below.
+Some of the REST API that are currently available and working (and some no longer working) will be deprecated in favor of their final version 1. Anybody still using any of the Deprecate below needs to move to the Instead Use as soon as possible.
-<note warning>Some of the following needs to be discussed and finalized before any work begins to migrate them. Those with an explicit "**Instead use**" can be done.</note>
 ==== Used in Exams Dashboard ====
@@ Line 626: / Line 635: @@
 ==== Used in Schools Dashboard ====
-The following  are to be deprecated or not? They are still in use in Pacific EMIS web app and the backend code has no Deprecated attribute like other deprecated end point.
 Deprecate
@@ Line 638: / Line 645: @@
 Instead use
-<note important>Unsure yet what to replace this with</note>
+<note important>Unsure yet what to replace this with. It is actually still in use in Pacific EMIS web app and the backend code has no Deprecated attribute like other deprecated end points.</note>
 Deprecate
@@ Line 691: / Line 698: @@
 https://<emis_root>/api/warehouse/flow/school/{schoolNo}
 </code>
+Deprecate
+<code>
+https://<emis_root>/api/warehouse/schoolteachercount/{schoolNo}
+</code>
+Instead use
+<code>
+https://<emis_root>/api/warehouse/teachers/school/[schoolno]?report
+</code>
 ==== Used in Teachers Dashboard ====
@@ Line 718: / Line 740: @@
 </code>
+Deprecate
+<code>
+https://<emis_root>/api/warehouse/teachercount
+</code>
+Instead use
+<code>
+https://<emis_root>/api/warehouse/teachers?report
+</code>
+Deprecate
+<code>
+https://<emis_root>/api/warehouse/schoolteachercount
+</code>
+Instead use
+<code>
+https://<emis_root>/api/warehouse/teachers/school?report
+</code>
+==== Used elsewhere ====
+Deprecate
+<code>
+https://<emis_root>/api/warehouse/v0/edlevelage
+</code>
+Instead use
 <code>
-https://<emis_root>/api/warehouse/teacherqual (Teachers Dashboard)
+https://<emis_root>/api/warehouse/edlevelage
-https://<emis_root>/api/warehouse/classleveler (Indicators Dashboard)
-https://<emis_root>/api/warehouse/edleveler (Indicators Dashboard)
-https://<emis_root>/api/warehouse/flowrates (Indicators Dashboard)
-https://<emis_root>/api/warehouse/v0/edlevelage (Indicators Dashboard)
-https://<emis_root>/api/warehouse/edlevelage (Indicators Dashboard) ?
 </code>