model_driven_api 3.5.7 → 3.5.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df0f02193f91b162df1248961aabf8c4281440c49dc7f3147cb400db371f68d0
-  data.tar.gz: d0c42164dbde60bbb752110daa5e8b757ac8a7e0bfcc5e9b6a67898a02555ec8
+  metadata.gz: f9f41789e4969e40d7ea928d17463c69b067109d104f4c5c14d2d8885670c08d
+  data.tar.gz: df3716c785822a97d1a17374d64193eb40408735bfc93982f1d12f9ec044a2fe
 SHA512:
-  metadata.gz: e4e3c99b867169e19e966832ef085d5d8ffd67399a6a4047fa504a950c75a63b1a96719502d8c9d01dca6efd5d32ae7d9b07d69c8c7ad361a561cde24b957d65
-  data.tar.gz: 6bcff8f0e6c408ead804305dd386e827edf582b0e950774bcf9c79cdb9c24fe7577dab86d813e0c1a9cb8ff7e3355079f451d23eb1a8327df658824cd876b167
+  metadata.gz: 0d6a4d31ecdb991590f78fdafca0b955f833e01abce3796cc69b70626d65201023fe2582b610941aab91834a621849f37fead2241cec4b497a3c758fb3f5b376
+  data.tar.gz: de120a2d0bfbe673d69695a44e2105fe8f16c13b422cefefa6f97ad93a8e40e04fa376e06242fd6b6005b796d0e3e00580fb3b77da2fe7d44d34eeb576a9ac82

data/app/controllers/api/v2/info_controller.rb

@@ -1303,6 +1303,62 @@ const handleUpdate = async () => {
   });
 };
 
+```
+
+Here is the addition to the documentation showing the raw HTTP requests.
+
+---
+
+## 4. Bare Metal HTTP Requests
+
+If you were to inspect the network traffic or manually construct the request (e.g., using raw sockets or a tool like Postman/Insomnia), this is exactly what the payload looks like "over the wire."
+
+### A. POST Request (Upload)
+
+Notice how `multipart/form-data` uses a **boundary** string (randomly generated by the client) to separate different fields.
+
+```http
+POST /api/products HTTP/1.1
+Host: localhost:3000
+Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
+
+------WebKitFormBoundary7MA4YWxkTrZu0gW
+Content-Disposition: form-data; name="product[title]"
+
+My New Product
+------WebKitFormBoundary7MA4YWxkTrZu0gW
+Content-Disposition: form-data; name="product[assets][]"; filename="camera_shot.jpg"
+Content-Type: image/jpeg
+
+(Binary image data goes here...)
+------WebKitFormBoundary7MA4YWxkTrZu0gW
+Content-Disposition: form-data; name="product[assets][]"; filename="gallery_photo.png"
+Content-Type: image/png
+
+(Binary image data goes here...)
+------WebKitFormBoundary7MA4YWxkTrZu0gW--
+
+```
+
+### B. PATCH Request (Deletion via IDs)
+
+When sending the `remove_assets` array via `FormData`, the key is repeated for every ID. This is how HTTP handles arrays in form data.
+
+```http
+PATCH /api/products/100 HTTP/1.1
+Host: localhost:3000
+Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryXyZ123
+
+------WebKitFormBoundaryXyZ123
+Content-Disposition: form-data; name="product[remove_assets][]"
+
+12
+------WebKitFormBoundaryXyZ123
+Content-Disposition: form-data; name="product[remove_assets][]"
+
+45
+------WebKitFormBoundaryXyZ123--
+
 ```
     MARKDOWN
     info

data/lib/model_driven_api/version.rb

@@ -1,3 +1,3 @@
 module ModelDrivenApi
-  VERSION = "3.5.7".freeze
+  VERSION = "3.5.8".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: model_driven_api
 version: !ruby/object:Gem::Version
-  version: 3.5.7
+  version: 3.5.8
 platform: ruby
 authors:
 - Gabriele Tassoni