Differences

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

--- guides:ws_payloads [2019/10/03 18:07] – brett.zamora
+++ guides:ws_payloads [2020/08/23 15:46] (current) – brett.zamora
@@ Line 1: / Line 1: @@
-==== Web Service: Payloads ====
+==== payloads:get_repository_names ====
-The Payloads web service is a general purpose web service that derives its functionality based on syntax used when calling the web service. The following paragraphs outline the various functions and syntax supported by the Payloads web service. Each function is shown in a green font.
+The payloads web service is a REST structured service that derives its functionality based on syntax used when calling the web service. In it's simplest form, with no parameters supplied, the payload service returns a list of supported repository names and a count of the number of payloads in each repository.
 ----
-**FUNCTION:** <color #22b14c>Get supported repository names with payload counts.</color>
+**Purpose:** <color #22b14c>**Get Supported Repository Names With Payload Counts.**</color>
@@ Line 89: / Line 87: @@
-**FUNCTION:** <color #22b14c>Get payload file names for selected repository</color>
+**FUNCTION:** <color #22b14c>**Get Payload File Names For Selected Repository**</color>
@@ Line 209: / Line 207: @@
 }
 </code>
+**FUNCTION:** <color #22b14c>**Retrieve A Payload From A Repository**</color>
+<color #7092be>Request Endpoint</color>
+{{tablelayout?colwidth="75px,575px"&rowsFixed=1&rowsVisible=10&float=center}}
+^ Method ^ URL ^
+| GET | <nowiki>https://apex-prd.certna.org/APEX/Service/APEXPublicServer.svc/payloads</nowiki> |
+<color #7092be>Request Body</color>
+N/A
+<color #7092be>Request Headers</color>
+{{tablelayout?colwidth="150px,450px"&rowsFixed=1&rowsVisible=10&float=center}}
+^ Key ^ Value ^
+| access_token | {soft-token} |
+<color #7092be>JSON Request Parameters</color>
+N/A
+**Notes:**
+Any condition that results in an unsuccessful call to the payloads web service will produce a JSON formatted response with a code and message property populated.
+<color #7092be>Sample Request</color>
+**Endpoint:**
+<nowiki>https://apex-prd.certna.org/APEX/Service/APEXPublicServer.svc/payloads</nowiki>
+<color #7092be>Sample Response</color>
+Status Code: 200
+<code json>
+[
+    {
+        "Count": 0,
+        "RepositoryName": "Responses"
+    },
+    {
+        "Count": 0,
+        "RepositoryName": "Requests"
+    },
+    {
+        "Count": 96,
+        "RepositoryName": "Processed"
+    },
+    {
+        "Count": 0,
+        "RepositoryName": "Invalid"
+    }
+]
+</code>
+**OR**
+Status Code: 500  (When an error occurs.)
+<code json>
+{
+    "Exception": {
+        "Code": "InvalidUserCredentials",
+        "Message": "Invalid Session Id"
+    }
+}
+</code>
+----