API call

POST https://tfy.tech101.in/api/v1/totp

Headers:

Content-Type: application/json

Body

{ "phone": "phone-number" }

Headers

HTTP/1.1 202 ACCEPTED

Body: none

Headers

HTTP/1.1 404 USER-NOT-FOUND

Body: none

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

This is a sample error message.

API call

POST https://tfy.tech101.in/api/v1/oauth/token

Headers

Content-Type: application/json

Body

{
  "grant_type": "password"
  , "username": "the-username"
  , "password": "the-totp"
  , "scope": "hirer:all" or "driver:all"
}

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body

{
  "access_token": "the-access-token"
  , "token_type": "bearer"
  , "scope": "hirer:all" or "driver:all"
}

Headers

HTTP/1.1 404 HIRER-NOT-FOUND or DRIVER-NOT-FOUND

Body: none

Headers

HTTP/1.1 401 INVALID-TOTP

Body: none

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

This is a sample error message.

API call

POST https://tfy.tech101.in/api/v1/oauth/token

Headers

Content-Type: application/json

Body

{
  "grant_type": "password"
  , "username": "admin-username"
  , "password": "admin-password"
  , "scope": "all:all"
}

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body

{
  "access_token": "the-access-token"
  , "token_type": "bearer"
  , "scope": "hirer:all" or "driver:all"
}

Headers

HTTP/1.1 404 ADMIN-NOT-FOUND

Body: none

Headers

HTTP/1.1 401 INVALID-PASSWORD

Body: none

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

This is a sample error message.

API call

GET https://tfy.tech101.in/api/v1/<objects>

where <objects> is one of cities, truck-types, trucks or drivers

Headers

Authorization: Bearer <admin-token>

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body for cities

[
  {
    "id": "uuid-of-city",
    "name": "name-of-city"
  },
  { ... more cities ... }
]

Body for truck types

[
  {
    "id": "uuid-of-truck-type",
    "name": "name-of-truck-type",
    "img": "https://path/to/icon/of/truck/type"
  },
  { ... more truck types ... }
]

Body for trucks

[
  {
    "id": "uuid-of-truck",
    "status": <truck-status>,
    "city": "current-city"
  },
  { ... more trucks ... }
]

where <truck-status> is a status code indicating the role that the truck is playing right now. It can be one of the following numbers

• 0: Truck is free for hire
• 1: Truck is provisionally allotted to a trip
• 2: Truck is confirmed for a trip
• 3: Truck is at loading point
• 4: Truck is weighed and loaded
• 5: Truck is in transit
• 6: Truck is at unloading point
• 7: Truck is unloaded and weighed

Body for drivers

[
  {
    "id": "uuid-of-driver",
    "name": "name-of-driver",
    "license": "license-number-of-driver"
  },
  { ... more drivers ... }
]

Headers

Headers

Headers Body

API call

POST https://tfy.tech101.in/api/v1/cities
POST https://tfy.tech101.in/api/v1/truck-types
POST https://tfy.tech101.in/api/v1/trucks
POST https://tfy.tech101.in/api/v1/drivers

Headers

Authorization: Bearer <admin-token>
Content-Type: application/json

Body for city

{ "name": "city-name" }

Body for truck type

{
  "name": "name-of-truck-type"
}

Body for truck

{
  "registration": {
    "id": "truck's-registration-number"
    , "expiry": "expiry-date-of-registration"
  }
  , "type": "uuid-of-truck-type"
  , "capacity": "capacity-in-tonnes"
  , "city": "uuid-of-city-where-the-truck-is"
}

Body for driver

{
  "name": "driver-name"
  , "license: {
    "id": "driver's-license-number"
    , "expiry": "expiry-date-of-license"
  }
  , "phone": "phone-number-of-driver"
}

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body for city

{
  "id": "uuid-of-city"
  , "name": "name-of-city"
}

Body for truck type {

"id": "uuid-of-truck-type"
, "name": "name-of-truck-type"
, "img": "https://path/to/truck/type/icon"

}

Body for truck {

"id": "uuid-of-truck"
, "registration": {
  "id": "registration-number-of-truck"
  , "expiry": "expiry-date-for-registration"
}
, "type": "uuid-of-truck-type"
, "capacity": capacity-in-tonnes
, "img": {
  "self": "https://path/to/image/of/truck"
  , "rc": "https://path/to/image/of/rc/book"
}
, "driver": "uuid-of-driver-assigned"
}

}

Body for driver {

"id": "uuid-of-driver"
, "name": "driver's name"
, "license": {
  "id": "license-number-of-driver"
  , "expiry": "expiry-date-of-license"
}
, "phone": "phone-number-of-driver"
, "img": {
  "self": "https://path/to/image/of/driver"
  , "license": "https://path/to/image/of/license"
}
, "truck": "uuid-of-truck-assigned"

}

Headers

HTTP/1.1 401 INVALID-TOKEN

Body: none

Headers

HTTP/1.1 403 FORBIDDEN

Body: none

Headers

HTTP/1.1 400 INVALID-<field-name> e.g. INVALID-CITY-NAME
Content-Type: text/plain

Body

Validation message specific to invalid field

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

PATCH https://tfy.tech101.in/api/v1/cities/uuid-of-city
PATCH https://tfy.tech101.in/api/v1/truck-types/uuid-of-truck-type
PATCH https://tfy.tech101.in/api/v1/trucks/uuid-of-truck
PATCH https://tfy.tech101.in/api/v1/drivers/uuid-of-truck

Headers

Authorization: Bearer admin-token
Content-Type: application/json

Body

{ "isHidden": true for hide / false for unhide }

Headers

HTTP/1.1 204 DONE

Body: none

Headers

HTTP/1.1 401 INVALID-TOKEN

Body: none

Headers

HTTP/1.1 403 FORBIDDEN

Body: none

Headers

HTTP/1.1 404 <object type>-NOT-FOUND e.g. CITY-NOT-FOUND, TRUCK-TYPE-NOT-FOUND

Body: none

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message.

API call

POST https://tfy.tech101.in/api/v1/media

Headers

Authorization: Bearer admin-token
Content-Type: image/jpeg or image/png

Body: byte array of image

Headers

HTTP/1.1 200 OK
Content-Type: text/plain

Body

https://path/of/uploaded/image

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 403 FORBIDDEN

Headers

HTTP/1.1 400 INVALID-<field-name>, e.g. INVALID-MIME, INVALID-JPEG
Content-Type: text/plain

Body

Validation error specific to the error in the field

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

PATCH https://tfy.tech101.in/api/v1/trucks/uuid-of-truck
PATCH https://tfy.tech101.in/api/v1/drivers/uuid-of-driver
PATCH https://tfy.tech101.in/api/v1/truck-types/uuid-of-truck-type

Headers

Authorization: Bearer admin-token
Content-Type: application/json

Body for truck

{
  "img": {
    "self": "https://path/to/truck/photo"
    AND / OR
    , "rc": "https://path/to/truck/rc/book/photo"
  }
}

Body for driver

{
  "img": {
    "self": "https://path/to/driver/photo"
    AND / OR
    , "license": "https://path/to/license/photo"
  }
}

Body for truck type

{ "img": "https://path/to/icon/of/truck/type" }

Headers

HTTP/1.1 204 DONE

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 403 FORBIDDEN

Headers

HTTP/1.1 400 INVALID-<field-name>, e.g. INVALID-PATH
Content-Type: text/plain

Body

Validation error specific to the error in the field

Headers

HTTP/1.1 404 <object-type>-NOT-FOUND, e.g. TRUCK-NOT-FOUND

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

POST https://tfy.tech101.in/api/v1/hire-requests

Headers

Authorization: Bearer hirer-token
Content-Type: application/json

Body

{
  "id": "uuid-for-request-generated-by-app"
  , "source": "uuid-of-source-city"
  , "destination": "uuid-of-destination-city"
  , "dateLoad": "YYYY-MM-DD"
  , "dateDelivery": "YYYY-MM-DD"
  , "weight": weight-in-tonnes
  , "truckType": "uuid-of-truck-type"
}

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body

{
  "requestId": "uuid-of-this-request-for-truck"
  "suggestions": [
    {
      "id": "uuid-for-suggestion"
      , "capacity": "capacity-in-tonnes"
      , "dateSource": "unix timestamp with time 00:00:00, date on which truck leaves source city"
      , "dateDestination": "unix timestamp with time 23:59:59, date on which truck reaches destination city"
      , "tariff": tariff-in-rupees
    }
    , { ... more suggestions ... }
  ]
}

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 400 INVALID-<field-name>
Content-Type: text/plain

where field-name can be one of SOURCE, DESTINATION, LOAD-DATE, DELIVERY-DATE, TRUCK-TYPE, WEIGHT

Body

Validation error specific to the error in the field

Headers

HTTP/1.1 404 <object type>-NOT-FOUND

where object-type can be one of CITY, TRUCK-TYPE

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

PATCH https://tfy.tech101.in/api/v1/hire-requests/request-id

The request-id is the same as the one returned in the hiring request as requestId.

Headers

Authorization: Bearer hirer-token
Content-Type: application/json

Body

{
  "suggestionId": "uuid-of-picked-suggestion"
  , "addressSource": "complete address of source"
  , "addressDestination": "complete address of destination"
}

Headers

HTTP/1.1 204 DONE

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 400 INVALID-<field-name>
Content-Type: text/plain

where field-name can be one of SUGGESTION, SOURCE-ADDRESS, SOURCE-ADDRESS

Body

Validation error specific to the error in the field

Headers

HTTP/1.1 404 <object>-NOT-FOUND

where <object> can be one of HIRE-REQUEST or SUGGESTION

Headers

HTTP/1.1 403 NOT-OWNER

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

GET https://tfy.tech101.in/api/v1/trucks/uuid-of-truck

Headers

Authorization: Bearer hirer-token

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body

{
  "id": "uuid-of-truck"
  , "registration": {
    "id": "registration-number-of-truck"
    , "expiry": "expiry-of-registration"
  }
  , "img": {
    "self": "https://path/to/image/of/truck"
    , "rc": "https://path/to/image/of/rc/book"
  }
}

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 404 TRUCK-NOT-FOUND

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

GET https://tfy.tech101.in/api/v1/drivers/uuid-of-driver

Headers

Authorization: Bearer hirer-token

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body

{
  "id": "uuid-of-driver"
  , "license": {
    "id": "license-number-of-driver"
    , "expiry": "expiry-of-license"
  }
  , "phone": "phone-number-of-driver" *
  , "img": {
    "self": "https://path/to/photo/of/driver"
    , "license": "https://path/to/photo/of/license"
  }
}

* Will be revealed ONLY if the driver is assigned on a trip to the requesting hirer. This field will be a blank string “” otherwise.

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 404 DRIVER-NOT-FOUND

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

PATCH https://tfy.tech101.in/api/v1/trips/trip-id

Headers

Authorization: Bearer hirer-token
Content-Type: application/json

Body

{ "confirmed": true }

Headers

HTTP/1.1 204 DONE
Content-Type: application/json

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 400 INVALID-CONFIRMED-VALUE
Content-Type: text/plain

Body

Validation error specific to the error in the field

Headers

HTTP/1.1 404 HIRE-REQUEST-NOT-FOUND

Headers

HTTP/1.1 403 NOT-OWNER

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

PATCH https://tfy.tech101.in/api/v1/trips/trip-id

Headers

Authorization: Bearer hirer-token
Content-Type: application/json

Body

{ "cancelled": true }

Headers

HTTP/1.1 204 DONE
Content-Type: application/json

Body: none

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 400 INVALID-CANCELLED-VALUE
Content-Type: text/plain

Body

Validation error specific to the error in the field

Headers

HTTP/1.1 404 HIRE-REQUEST-NOT-FOUND

Headers

HTTP/1.1 403 NOT-OWNER

Body: none

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message

API call

GET https://tfy.tech101.in/api/v1/trips/trip-id

Headers

Authorization: Bearer hirer-token

Headers

HTTP/1.1 200 OK
Content-Type: application/json

Body

{
  "id": "uuid-for-trip"
  , "dateLoad": "YYYY-MM-DD, date on which goods will be loaded and the trip starts"
  , "dateDelivery": "YYYY-MM-DD, date on which goods will be delivered"
  , "citySource": "uuid-of-pickup-city"
  , "addressSource": "the-full-address-of-pickup"
  , "cityDestination": "uuid-of-destination-city"
  , "addressDestination": "the-full-address-of-delivery"
  , "truck": "uuid-of-truck"
  , "driver": "uuid-of-driver"
  , "status": <trip-status>
}

where <trip-status> is a number that conveys at which stage the trip stage is. <trip-status> can be one of the following numbers.

• 0: Trip is unconfirmed by the hirer.
• 1: Trip is confirmed, but yet to begin.
• 2: The truck has arrived at the pickup address for loading.
• 3: Loading and weighing is finished.
• 4: The truck is on the route.
• 5: The truck has arrived at the destination address for unloading.
• 6: Unloading and weighing is finished.
• 7: Trip payment is done
• 8: Trip payment is in dispute
• 9: Trip is cancelled

Headers

HTTP/1.1 401 INVALID-TOKEN

Headers

HTTP/1.1 404 TRIP-NOT-FOUND

Headers

HTTP/1.1 403 NOT-OWNER

Headers

HTTP/1.1 500 ERROR
Content-Type: text/plain

Body

Sample error message