No batch post requests for US street, zip, or extract that use embedded keys

CLAUDE.md

@@ -72,6 +72,7 @@ Single lookups are sent as GET with query parameters. Batch (2+) lookups use POS
 
 - `StaticCredentials`: Auth ID + Auth Token (server-to-server)
 - `SharedCredentials`: Web Token + Referer (browser/mobile)
+- Embedded/website keys are GET-only — not valid for batch (POST) requests or the US Extract API (POST-only): https://www.smarty.com/docs/cloud/authentication
 
 ### Test Mocks
 

src/main/java/examples/UsExtractExample.java

@@ -12,8 +12,8 @@
 public class UsExtractExample {
     public static void main(String[] args) {
         // We recommend storing your authentication credentials in environment variables.
-        // for client-side requests (browser/mobile), use this code:
-        // SharedCredentials credentials = new SharedCredentials(System.getenv("SMARTY_AUTH_WEB"), System.getenv("SMARTY_AUTH_REFERER"));
+        // The US Extract API is POST-only and embedded keys are restricted to GET, so this
+        // API requires secret keys: https://www.smarty.com/docs/cloud/authentication
         BasicAuthCredentials credentials = new BasicAuthCredentials(System.getenv("SMARTY_AUTH_ID"), System.getenv("SMARTY_AUTH_TOKEN"));
 
         try (Client client = new ClientBuilder(credentials).buildUsExtractApiClient()) {

src/main/java/examples/UsStreetMultipleAddressesExample.java

@@ -12,8 +12,8 @@
 public class UsStreetMultipleAddressesExample {
     public static void main(String[] args) {
         // We recommend storing your authentication credentials in environment variables.
-        // for client-side requests (browser/mobile), use this code:
-        // SharedCredentials credentials = new SharedCredentials(System.getenv("SMARTY_AUTH_WEB"), System.getenv("SMARTY_AUTH_REFERER"));
+        // Batch requests are sent via HTTP POST. Embedded keys are restricted to GET, so
+        // batches require secret keys: https://www.smarty.com/docs/cloud/authentication
         BasicAuthCredentials credentials = new BasicAuthCredentials(System.getenv("SMARTY_AUTH_ID"), System.getenv("SMARTY_AUTH_TOKEN"));
 
         try (Client client = new ClientBuilder(credentials)

src/main/java/examples/UsZipCodeMultipleLookupsExample.java

@@ -12,8 +12,8 @@
 public class UsZipCodeMultipleLookupsExample {
     public static void main(String[] args) {
         // We recommend storing your authentication credentials in environment variables.
-        // for client-side requests (browser/mobile), use this code:
-        // SharedCredentials credentials = new SharedCredentials(System.getenv("SMARTY_AUTH_WEB"), System.getenv("SMARTY_AUTH_REFERER"));
+        // Batch requests are sent via HTTP POST. Embedded keys are restricted to GET, so
+        // batches require secret keys: https://www.smarty.com/docs/cloud/authentication
         BasicAuthCredentials credentials = new BasicAuthCredentials(System.getenv("SMARTY_AUTH_ID"), System.getenv("SMARTY_AUTH_TOKEN"));
 
         try (Client client = new ClientBuilder(credentials).buildUsZipCodeApiClient()) {