diff --git a/app/Users/Controllers/UserApiController.php b/app/Users/Controllers/UserApiController.php index 880165e1b..1ccfecd73 100644 --- a/app/Users/Controllers/UserApiController.php +++ b/app/Users/Controllers/UserApiController.php @@ -90,7 +90,7 @@ class UserApiController extends ApiController public function create(Request $request) { $data = $this->validate($request, $this->rules()['create']); - $sendInvite = ($data['send_invite'] ?? false) === true; + $sendInvite = boolval($data['send_invite'] ?? false) === true; $user = null; DB::transaction(function () use ($data, $sendInvite, &$user) { diff --git a/resources/views/api-docs/parts/getting-started.blade.php b/resources/views/api-docs/parts/getting-started.blade.php index 75b71c6be..229fe7dce 100644 --- a/resources/views/api-docs/parts/getting-started.blade.php +++ b/resources/views/api-docs/parts/getting-started.blade.php @@ -66,6 +66,12 @@
+
+
+ * Form requests can accept boolean (true
/false
) values via a 1
or 0
.
+
+
Regardless of format chosen, ensure you set a Content-Type
header on requests so that the system can correctly parse your request data.
The API is primarily designed to be interfaced using JSON, since responses are always in JSON format, hence examples in this documentation will be shown as JSON.
@@ -82,17 +88,19 @@
{
"name": "My new item",
+ "locked": true,
"books": [105, 263],
"tags": [{"name": "Tag Name", "value": "Tag Value"}],
}
x-www-form-urlencoded
-name=My%20new%20item&books%5B0%5D=105&books%5B1%5D=263&tags%5B0%5D%5Bname%5D=Tag%20Name&tags%5B0%5D%5Bvalue%5D=Tag%20Value
+name=My%20new%20item&locked=1&books%5B0%5D=105&books%5B1%5D=263&tags%5B0%5D%5Bname%5D=Tag%20Name&tags%5B0%5D%5Bvalue%5D=Tag%20Value
x-www-form-urlencoded (Decoded for readability)
name=My new item
+locked=1
books[0]=105
books[1]=263
tags[0][name]=Tag Name
diff --git a/tests/Api/UsersApiTest.php b/tests/Api/UsersApiTest.php
index 6ad727257..a0c67d0d2 100644
--- a/tests/Api/UsersApiTest.php
+++ b/tests/Api/UsersApiTest.php
@@ -143,6 +143,23 @@ class UsersApiTest extends TestCase
Notification::assertSentTo($user, UserInviteNotification::class);
}
+ public function test_create_with_send_invite_works_with_value_of_1()
+ {
+ $this->actingAsApiAdmin();
+ Notification::fake();
+
+ $resp = $this->postJson($this->baseEndpoint, [
+ 'name' => 'Benny Boris',
+ 'email' => 'bboris@example.com',
+ 'send_invite' => '1', // Submissions via x-www-form-urlencoded/form-data may use 1 instead of boolean
+ ]);
+
+ $resp->assertStatus(200);
+ /** @var User $user */
+ $user = User::query()->where('email', '=', 'bboris@example.com')->first();
+ Notification::assertSentTo($user, UserInviteNotification::class);
+ }
+
public function test_create_name_and_email_validation()
{
$this->actingAsApiAdmin();