From b47573a879d699d1c87e3b7b56be51bfded3182f Mon Sep 17 00:00:00 2001
From: Santo Cariotti <santo@dcariotti.me>
Date: Tue, 3 Sep 2024 10:03:26 +0200
Subject: Add examples on doc

---
 src/graphql/mutation.rs | 53 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

(limited to 'src/graphql/mutation.rs')

diff --git a/src/graphql/mutation.rs b/src/graphql/mutation.rs
index 1440ced..a389a04 100644
--- a/src/graphql/mutation.rs
+++ b/src/graphql/mutation.rs
@@ -15,6 +15,21 @@ pub struct Mutation;
 #[Object]
 impl Mutation {
     /// Make GraphQL login
+    ///
+    /// Example:
+    /// ```text
+    /// curl -X POST http://localhost:8000/graphql \
+    /// -H "Content-Type: application/json" \
+    /// -d '{
+    ///   "query": "mutation Login($input: LoginCredentials!) { login(input: $input) { accessToken tokenType userId } }",
+    ///   "variables": {
+    ///     "input": {
+    ///       "email": "***",
+    ///       "password": "***"
+    ///     }
+    ///   }
+    /// }'
+    /// ```
     async fn login<'ctx>(
         &self,
         ctx: &Context<'ctx>,
@@ -44,6 +59,23 @@ impl Mutation {
     }
 
     /// Make GraphQL request to create new position to track
+    ///
+    /// Example:
+    /// ```text
+    /// curl -X POST http://localhost:8000/graphql \
+    /// -H "Content-Type: application/json" \
+    /// -H "Authorization: Bearer ***" \
+    /// -d '{
+    ///   "query": "mutation NewPosition($input: PositionInput!) { newPosition(input: $input) { id userId createdAt latitude longitude movingActivity } }",
+    ///   "variables": {
+    ///     "input": {
+    ///       "latitude": 44.50800643571219,
+    ///       "longitude": 11.299600981136905,
+    ///       "movingActivity": "STILL"
+    ///     }
+    ///   }
+    /// }'
+    /// ```
     async fn new_position<'ctx>(
         &self,
         ctx: &Context<'ctx>,
@@ -94,6 +126,27 @@ impl Mutation {
     }
 
     /// Make GraphQL request to create new alert. Only for admins.
+    ///
+    /// Example:
+    /// ```text
+    /// curl -X POST http://localhost:8000/graphql \
+    /// -H "Content-Type: application/json" \
+    /// -H "Authorization: Bearer ****" \
+    /// -d '{
+    ///   "query": "mutation NewAlert($input: AlertInput!) { newAlert(input: $input) { id createdAt level } }",
+    ///   "variables": {
+    ///     "input": {
+    ///       "points": [
+    ///         { "latitude": 44.490025, "longitude": 11.311499},
+    ///         { "latitude": 44.490361, "longitude": 11.327903},
+    ///         { "latitude": 44.497280, "longitude": 11.327776},
+    ///         { "latitude": 44.498321, "longitude": 11.312145},
+    ///         { "latitude": 44.490025, "longitude": 11.311498}
+    ///       ],
+    ///       "level": "TWO"
+    ///     }
+    ///   }
+    /// }
     async fn new_alert<'ctx>(
         &self,
         ctx: &Context<'ctx>,
-- 
cgit v1.2.3-18-g5258