dvl-api-fleet-driver-create.md

Fleet Driver Create

• URL

  /v1/drivers

• Method:

  POST

• HEADERS

  Authorization=bearer ACCESS_TOKEN

• Data Params

  driver[email]=[text]
driver[full_name]=[text]
driver[password]=[]
driver[password_confirmation]=[text]
driver[phone_number]=[text]
  

• Success Response:

  • Code: 201 CREATED
    Content: {"data":
{"driver":{
"id":28,
"email":"demo@gnail.com",
"phone_number":"4524566",
"full_name":"demo name",
}}}

• Error Response:

  • Code: 401 UNAUTHORIZED
    Content: { error": "Invalid access token" }

  OR

  • Code: 401 UNAUTHORIZED
    Content { error: 'You don't have permission' }

  OR

  • Code: 422 UNPROCESSABLE ENTITY
    Content: {"errors":{
"email":["can't be blank","is invalid"],
"password":["can't be blank"],
"full_name":["can't be blank"],
"phone_number":["can't be blank"]}}
    

• Sample Call:

• Notes:

dvl-api-fleet-driver-delete.md

Fleet Driver Delete

• URL

  /v1/drivers/:id

• Method:

  DELETE

• HEADERS

  Authorization=bearer ACCESS_TOKEN

• URL Params

  Required:

  id=[integer]

• Data Params

• Success Response:

  • Code: 200 OK
    Content:

• Error Response:

  • Code: 401 UNAUTHORIZED
    Content: { error": "Invalid access token" }

  OR

  • Code: 401 UNAUTHORIZED
    Content { error: 'You don't have permission' }

  OR

  • Code 404 NOT FOUND
    Content: { error: "Not Found" }

  OR

  • Code: 404 UNPROCESSABLE ENTITY
    Content:

• Sample Call:

• Notes:

dvl-api-fleet-driver-update.md

Fleet Driver Update

• URL

  /v1/drivers/:id

• Method:

  PUT | PATCH

• HEADERS

  Authorization=bearer ACCESS_TOKEN

• URL Params

  Required:

  id=[integer]

• Data Params

  drivers[email]=[text]
drivers[full_name]=[text]
drivers[password]=[]
drivers[password_confirmation]=[text]
drivers[phone_number]=[text]
  

• Success Response:

  • Code: 200 OK
    Content: {"data":
{"drivers":{
"id":28,
"email":"demo@gnail.com",
"phone_number":"4524566",
"full_name":"demo name",
}}}

• Error Response:

  • Code: 401 UNAUTHORIZED
    Content: { error": "Invalid access token" }

  OR

  • Code: 401 UNAUTHORIZED
    Content { error: 'You don't have permission' }

  OR

  • Code 404 NOT FOUND
    Content: { error: "Not Found" }

  OR

  • Code: 404 UNPROCESSABLE ENTITY
    Content: {"errors":{"phone_number":["can't be blank"]}}

• Sample Call:

• Notes:

dvl-api-fleet-drivers.md

Fleet Drivers

• URL

  /v1/drivers

• Method:

  GET

• HEADERS

  Authorization=bearer ACCESS_TOKEN

• URL Params

  Required:

  none

  Optional:

  per_page=[integer]
page=[integer]
'q[email_eq]'=[text]
'q[email_cont]'=[text]
'q[full_name_eq]'=[text]
'q[full_name_cont]'=[text]
'q[phone_number_eq]'=[text]
'q[phone_number_cont]'=[text]
...

• Data Params

  none

• Success Response:

  • Code: 200 OK
    Content: {"data":{
"drivers":[
{"id":3,"full_name":"Demo1","email":"demi1@dvl.com","phone_number":"2345567"},

{"id":20,"full_name":"Demo2","email":"demo2@gnail.com","phone_number":"2345567"}
],
"pagination":{"page":1,"per_page":2,"total":10,"pages":5}}}

• Error Response:

  • Code: 401 UNAUTHORIZED
    Content: { error": "Invalid access token" }

  OR

  • Code: 401 UNAUTHORIZED
    Content { error: 'You don't have permission' }

• Sample Call:

• Notes:

in search query

*_eq - equal
*_cont Contains value