Differences

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

--- api-trucks-for-you [2018/08/02 10:51]
hari [Response if underlying objects don't exist]
+++ api-trucks-for-you [2018/08/13 11:53] (current)
103.226.237.56 [Response for a successful request]
@@ Line 1: / Line 1: @@
 ======== Trucks for You API ========
-<hidden>
 ====== Creation and registration ======
@@ Line 29: / Line 29: @@
 <code>
 HTTP/1.1 202 ACCEPTED
+</code>
+Body: none
+==== Response if phone parameter is missing ====
+Headers
+<code>
+HTTP/1.1 400 INVALID-PHONE
 </code>
@@ Line 651: / Line 660: @@
 </code>
-</hidden>
 ====== Administration ======
 ===== Admin: List of trip requests =====
@@ Line 1060: / Line 1068: @@
 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>
@@ Line 1077: / Line 1116: @@
+==== 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>
+Headers
+<code>
+Authorization: Bearer user-token
+Content-Type: application/json
+</code>
+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>
+==== 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-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 ====
+Headers
+<code>
+HTTP/1.1 401 INVALID-TOKEN
+</code>
+==== Response if forbidden ====
+Headers
+<code>
+HTTP/1.1 403 FORBIDDEN
+</code>
+==== Response if fields are missing or invalid ====
+Headers
+<code>
+HTTP/1.1 400 INVALID-<field-name>
+Content-Type: text/plain
+</code>
+Body
+<code>
+Validation error specific to the error in the field
+</code>
+==== Response if underlying objects don't exist ====
+Headers
+<code>
+HTTP/1.1 404 <object-type>-NOT-FOUND
+</code>
 ==== Response for any other error ====

DokuWiki

Site Tools

Differences

Page Tools