add retrieve payload(s) functions (#227)

Author: jchen293

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Next Release
 
 - Adds `all` function to `Pickup` to retrieve all pickups
+- Adds `retrieveAllPayloads` and `retrievePayload` to retrieve all payloads or just a payload
 
 ## v6.1.0 (2023-01-11)
 

src/main/java/com/easypost/model/Payload.java

@@ -0,0 +1,16 @@
+package com.easypost.model;
+
+import java.util.Map;
+
+import lombok.Getter;
+
+@Getter
+public class Payload extends EasyPostResource {
+    private String requestUrl;
+    private Map<String, String> requestHeaders;
+    private Map<String, Object> requestBody;
+    private Map<String, String> responseHeaders;
+    private String responseBody;
+    private int responseCode;
+    private int totalTime;
+}

src/main/java/com/easypost/model/PayloadCollection.java

@@ -0,0 +1,10 @@
+package com.easypost.model;
+
+import lombok.Getter;
+
+import java.util.List;
+
+@Getter
+public class PayloadCollection {
+    private List<Payload> payloads;
+}

src/main/java/com/easypost/service/EventService.java

@@ -1,12 +1,15 @@
 package com.easypost.service;
 
+import java.util.List;
 import java.util.Map;
 
 import com.easypost.exception.EasyPostException;
 import com.easypost.http.Requestor;
 import com.easypost.http.Requestor.RequestMethod;
 import com.easypost.model.Event;
 import com.easypost.model.EventCollection;
+import com.easypost.model.Payload;
+import com.easypost.model.PayloadCollection;
 import com.easypost.utils.InternalUtilities;
 
 public class EventService {
@@ -44,4 +47,34 @@ public EventCollection all(final Map<String, Object> params) throws EasyPostExce
         return Requestor.request(RequestMethod.GET, InternalUtilities.classURL(Event.class), params,
                 EventCollection.class, client);
     }
+
+    /**
+     * Retrieve all payloads.
+     *
+     * @param eventId The ID of event.
+     * @return List of Payload objects.
+     * @throws EasyPostException when the request fails.
+     */
+    public List<Payload> retrieveAllPayloads(final String eventId) throws EasyPostException {
+        PayloadCollection payloads = Requestor.request(RequestMethod.GET,
+                String.format("%s/%s", InternalUtilities.instanceURL(Event.class, eventId), "payloads"), null,
+                PayloadCollection.class, client);
+
+        return payloads.getPayloads();
+    }
+
+    /**
+     * Retrieve a payload.
+     *
+     * @param eventId   The ID of event.
+     * @param payloadId The ID of payload.
+     * @return PayloadCollection object
+     * @throws EasyPostException when the request fails.
+     */
+    public Payload retrievePayload(final String eventId, final String payloadId) throws EasyPostException {
+        return Requestor.request(RequestMethod.GET,
+                String.format("%s/%s/%s", InternalUtilities.instanceURL(Event.class, eventId), "payloads", payloadId),
+                null,
+                Payload.class, client);
+    }
 }