Differences

This shows you the differences between two versions of the page.

--- api-trucks-for-you [2018/08/02 10:38]
hari [Response for any other error]
+++ api-trucks-for-you [2018/08/06 10:13]
111.125.228.102
@@ Line 1: / Line 1: @@
 ======== Trucks for You API ========
-<hidden>
 ====== Creation and registration ======
@@ Line 651: / Line 651: @@
 </code>
-</hidden>
 ====== Administration ======
 ===== Admin: List of trip requests =====
@@ Line 1043: / Line 1042: @@
 API call
 <code>
+GET https://tfy.tech101.in/api/v1/trips
+</code>
+Headers
+<code>
+Authorization: Bearer user-token
+</code>
+==== Response if request is successful ====
+Headers
+<code>
+HTTP/1.1 200 OK
+</code>
+Body
+<code>
+[
+  {
+    "id": "uuid-of-trip",
+    "truck": {
+      "id": "uuid-of-truck",
+      "registration": "registration-number"
+    },
+    "source":{
+      "date": "YYYY-MM-DD, date when truck leaves source",
+      "city": {
+        "id": "uuid-of-city",
+        "name": "name-of-city"
+      },
+    },
+    "destination": {
+      "date": "YYYY-MM-DD, date when truck reaches destination",
+      "city": {
+        "id": "uuid-of-city",
+        "name": "name-of-city"
+      }
+    }
+  },
+  { ... more trips ... }
+]
+</code>
+==== Response when request is successful, but there are no trips ====
+Headers
+<code>
+HTTP/1.1 204 DONE
+</code>
+==== Response if token is invalid ====
+Headers
+<code>
+HTTP/1.1 401 INVALID-TOKEN
+</code>
+==== Response if forbidden ====
+Headers
+<code>
+HTTP/1.1 403 FORBIDDEN
+</code>
+==== Response for any other error ====
+Headers
+<code>
+HTTP/1.1 500 ERROR
+Content-Type: text/plain
+</code>
+Body
+<code>
+Sample error message
+</code>
+===== Admin: Create a new trip =====
+==== Request ====
+API call
+<code>
+POST https://tfy.tech101.in/api/v1/trips
 </code>
@@ Line 1053: / Line 1139: @@
 Body
 <code>
+{
+  "truckId": "uuid-of-truck",
+  "source": {
+    "date": "YYYY-MM-DD, date when truck leaves source",
+    "cityId": "uuid-of-city-from-where-truck-leaves"
+  },
+  "destination": {
+    "date": "YYYY-MM-DD, date when truck reaches destination",
+    "cityId": "uuid-of-city-where-truck-reaches"
+  }
+}
 </code>
@@ Line 1064: / Line 1161: @@
 Body
 <code>
+{
+  "id": "uuid-of-trip",
+  "truck": {
+    "id": "uuid-of-truck",
+    "registration": "registration-number-of-truck"
+  },
+  "source": {
+    "date": "YYYY-MM-DD, date when truck leaves source",
+    "city": {
+      "id": "uuid-of-city",
+      "name": "name-of-city-from-where-truck-leaves"
+    }
+  },
+  "destination": {
+    "date": "YYYY-MM-DD, date when truck reaches destination",
+    "city": {
+      "id": "uuid-of-city",
+      "name": "name-of-city-where-truck-reaches"
+    }
+  }
+}
 </code>
 ==== Response if token is invalid ====

DokuWiki

Site Tools

Differences

Page Tools