API Documentation

Introduction

PROD	:	https://preprod.tirport.com/
PREPROD	:	http://preprod.tirport.com:8080/

AdminCompainesV1

API	Description
POST v1/admin/companies	ADMIN - List companies according to the approvement status
POST v1/admin/companies/setApproved	ADMIN - Updates the approvement status of a single company for an admin.
POST v1/admin/companies/update	ADMIN - Updates a single company for an admin.
POST v1/admin/companies/insert	ADMIN - Insert a single company.
POST v1/admin/companies/vehicle-user-relation/add	ADMIN - Add Company vehicle relation to user.
POST v1/admin/companies/vehicle-user-relation/disable	ADMIN - Disable Company vehicle relation to user.
POST v1/admin/companies/vehicle-user-relation/list	ADMIN - List Company vehicle relation to user.
POST v1/admin/companies/vehicle-user-relation/check-vehicle-status	ADMIN - Company vehicle relation check startdate-enddate.
POST v1/company/user-relation/list	WEB - USER COMPANY RELATIONS
POST v1/company/user-relation/save	WEB - USER COMPANY RELATIONS SAVE
POST v1/company/user-vehicle/list	WEB - List user's vehicles.
POST v1/company/user-vehicle/approve	WEB - User vehicle approve.
POST v1/admin/companies/service-station	WEB - Service Station List.
POST v1/admin/companies/service-station/detail	WEB - Service Station Detail.
POST v1/admin/companies/service-station/add	WEB - Service Station Insert.
POST v1/admin/companies/service-station/update	WEB - Service Station Update.
POST v1/admin/companies/service-station/remove	WEB - Service Station Remove.
POST v1/admin/companies/param-card/list	WEB - Param card list by filter
POST v1/admin/companies/param-card/detail	WEB - Param card detail
POST v1/admin/companies/param-card/change-status	WEB - Param card change status
POST v1/admin/companies/param-card/update-document	WEB - Param card upload document
POST v1/admin/companies/vehicle/available-list	WEB - Company Available Vehicle List
POST v1/admin/companies/report	WEB - Company Report

AdminMobileUsersV1

API	Description
POST v1/admin/mobileUsers	ADMIN - Returns a list of mobile users for an admin.
POST v1/admin/mobileUsers/detail	ADMIN - Returns the details of a mobile user for an admin.
POST v1/admin/mobileUsers/detail/byCellNumber	ADMIN - Returns the details of a mobile user for an admin by the user mobile cell number.
POST v1/admin/mobileUsers/update	ADMIN - Updates a single mobile user for an admin.
POST v1/admin/mobileUsers/updateVehicle	ADMIN - Updates a single vehicle of a mobile user for an admin.
POST v1/admin/mobileUsers/changeVehicleUser	ADMIN - Change vehicle user for an admin.
POST v1/admin/mobileUsers/short-info/byCellNumber	ADMIN - Return user basic info for an admin by the user mobile cell number.
POST v1/admin/mobileUsers/add	ADMIN - Add mobile user with company.
POST v1/admin/mobileUsers/send/message-or-notification	ADMIN - Send message or notification for user uid list
POST v1/admin/mobileUsers/send/message-by-number	ADMIN - Send message for mobile number
POST v1/admin/send/email	ADMIN - Send email
POST v1/admin/user/vehicle/add	Admin - Register new vehicle to user domain.
POST v1/admin/survey/add	WEB - Admin Survey Add
POST v1/admin/survey/send	WEB - Admin Survey Send
POST v1/admin/survey/detail-report
POST v1/admin/survey/summary-report

AdminShipmentV1

API	Description
POST v1/admin/shipment/detail	ADMIN - Returns the details of a shipment for an admin.
POST v1/admin/shipment/listByCompany	ADMIN - Returns the list of shipments of a company filterable by an optional company specific custom ID.
POST v1/admin/shipment/summary-list	ADMIN - Returns the list of shipments of a company filterable by an optional company specific custom ID.
POST v1/admin/shipment/offerable-list	WEB - Offerable Shipment List
POST v1/admin/shipment/delete
POST v1/admin/shipment/state	ADMIN - Change shipment state.
POST v1/admin/shipment/listByUser	ADMIN - Get shipments by user id.
POST v1/admin/shipment/vehicle-stop-times	ADMIN - Shipment Vehicle Stop Times Summary Result
POST v1/admin/shipment/vehicle-stop-times/add	ADMIN - Add Shipment Vehicle Stop Times Summary Request \| Status : 0- Waiting 1- Preparing 2- Completed
POST v1/admin/shipment/vehicle-stop-times/delete	ADMIN - Delete Shipment Vehicle Stop Times Summary Request
POST v1/admin/shipment/company-shipment-count	ADMIN - Company Shipment Count List
POST v1/admin/shipment/offer/add	ADMIN - Shipment add offer.
POST v1/admin/shipment/offer/list	ADMIN - Shipment offers.
POST v1/admin/shipment/offer/accepted-shipments	ADMIN - Accepted Shipments.
POST v1/admin/shipment/offer/request/list	ADMIN - Shipment get offer request.
POST v1/admin/shipment/offer/request/respond	ADMIN - Shipment get offer request.
POST v1/admin/shipment/offer/remove	ADMIN - Shipment remove offer.
POST v1/admin/shipment/download-image
POST v1/admin/shipment/directions
POST v1/admin/shipment/market/list
POST v1/admin/shipment/market/update-cost
POST v1/admin/shipment/market/publish
POST v1/admin/shipment/market/set-additional-time
POST v1/admin/shipment/market/create-invoice
POST v1/admin/shipment/market/add-offer
POST v1/admin/shipment/market/send-offer
POST v1/admin/shipment/market/offer-list
POST v1/admin/shipment/market/shipment-payment
POST v1/admin/shipment/market/shipment-payment/complete
POST v1/admin/shipment/market/create-penalty-bill
POST v1/admin/shipment/update-freight-pricing

AdminUsersV1

API	Description
POST v1/admin/users	ADMIN - Returns a list of company users for an admin.
POST v1/admin/users/detail	ADMIN - Returns the details of a company user for an admin.
POST v1/admin/users/update	ADMIN - Updates a single company user for an admin.
POST v1/admin/users/delete	ADMIN - Delete company user

ApplicationV1

API	Description
GET v1/application/health	Application Health.
POST v1/application/confirmation	MOBILE - WEB - Send 6 digits number confirmation code to user's cell phone as SMS.
POST v1/mobile/application/setting	MOBILE - APPLICATION SETTINGS.
POST v1/web/application/setting	WEB - APPLICATION SETTINGS.
POST v1/application/setting	APPLICATION SETTINGS.
POST v1/web/application/web/user/forgot	WEB - APPLICATION SEND MAIL TO USER WITH PWD RESET LINK.
POST v1/web/application/web/user/forgot/confirm	WEB - APPLICATION CHANGE USER PASSWORD.
POST v1/application/mobile/user/forgot	MOBILE - APPLICATION SEND MAIL TO USER WITH PWD RESET LINK.
POST v1/application/mobile/user/forgot/confirm	MOBILE - APPLICATION CHANGE USER PASSWORD.
POST v1/application/report/list	WEB - APPLICATION REPORT LIST.
POST v1/application/role/add	APPLICATION ADD ROLE
POST v1/application/role/delete	APPLICATION DELETE ROLE
POST v1/application/role/update	APPLICATION UPDATE ROLE
POST v1/application/role/list	APPLICATION ROLE LIST
POST v1/application/role/save-permissions	APPLICATION UPDATE ROLE PERMISSIONS
POST v1/application/role/permissions	APPLICATION UPDATE ROLE PERMISSIONS
POST v1/application/permission/list	APPLICATION PERMISSION LIST
POST v1/application/permission/update	APPLICATION UPDATE PERMISSION
POST v1/application/permission/add	APPLICATION ADD PERMISSION
POST v1/application/permission/delete	APPLICATION DELETE PERMISSION
POST v1/application/company-user/permissions	APPLICATION COMPANY USER PERMISSION LIST
POST v1/application/menu/add	APPLICATION ADD MENU
POST v1/application/menu/update	APPLICATION UPDATE MENU
POST v1/application/menu/delete	APPLICATION DELETE MENU
POST v1/application/menu/list	APPLICATION MENU LIST
POST v1/application/map/generate	APPLICATION GENERATE MAP
POST v1/application/url-shorter

CompanyV1

API	Description
POST v1/company/new	MOBILE - REGISTER NEW COMPANY
POST v1/company/newWithMail	WEB - REGISTER NEW COMPANY
POST v1/company/mailConfirmation	WEB - REGISTER NEW COMPANY
POST v1/company/login	WEB - LOGIN TO COMPANY ACCOUNT
POST v1/company/logout	WEB - LOGOUT FROM COMPANY ACCOUNT
POST v1/company/sessionState	WEB - CHECK ACTIVE SESSION STATE FOR COMPANY ACCOUNT
POST v1/company/user/register	WEB - CREATE COMPANY USER
POST v1/company/user/delete	WEB - DELETE COMPANY USER
POST v1/company/user/update	WEB - UPDATE USER PROFILE OF CURRENT COMPANY USER
POST v1/company/user/updateCurrency	WEB - UPDATE DEFAULT CURRENCY OF CURRENT COMPANY
POST v1/company/user/updatePassword	WEB - UPDATE PASSWORD OF CURRENT COMPANY USER
POST v1/company/subcompanies	WEB - RETURN THE LIST OF SUB-COMPANIES OF A PARENT COMPANY THAT CAN BE MANAGED BY THE CURRENT COMPANY
POST v1/company/subcompanies/detail	WEB - RETURN COMPANY
POST v1/company/subcompany/add	WEB - NEW SUB COMPANY AND DELEGATION
POST v1/company/subcompany/update	WEB - UPDATE SUB COMPANY
POST v1/company/subcompany/change-status	WEB - SUB COMPANY CHANHE APPROVE STATUS
POST v1/company/subcompany/delete	WEB - DELETE SUB COMPANY
POST v1/company/user	WEB - LIST COMPANY USERS
POST v1/company/user/disable	WEB - DISABLE COMPANY USER
POST v1/company/user/setEnabled	WEB - ENABLE/DISABLE COMPANY USER
POST v1/company/shipment	WEB - LIST SHIPMENT. List active shipments.
POST v1/company/shipment/by-company-list	WEB - LIST SHIPMENT BY COMPANY IDS. List active shipments.
POST v1/company/shipment/listDelegated	WEB - LIST DELEGATED SHIPMENTS
POST v1/company/shipment/offer	WEB - LIST OFFERS. To get offers for a shipment.
POST v1/company/shipment/offer/accept	WEB - ACCEPT OFFER.
POST v1/company/shipment/offer/reject	WEB - REJECT OFFER.
POST v1/company/shipment/offer/revision	WEB - REVISION REQUEST FOR OFFER.
POST v1/company/shipment/count	WEB - LIST SHIPMENT COUNTS.
POST v1/company/shipment/state	WEB - CHANGE SHIPMENT STATE.
POST v1/company/shipment/departuredate	WEB - CHANGE SHIPMENT DEPARTURE DATE.
POST v1/company/shipment/add	WEB - ADD NEW SHIPMENT
POST v1/company/shipment/remove	WEB - DELETE SHIPMENT
POST v1/company/shipment/address/delete	WEB - DELETE ADDRESS.
POST v1/company/shipment/update	WEB - UPDATE SHIPMENT
POST v1/company/shipment/share	WEB - SHARE A SHIPMENT WITH AN AUTO-GENERATED TOKEN.
POST v1/company/shipment/share/detail
POST v1/company/shipment/share/location-detail
POST v1/company/shipment/address	WEB - LIST COMPANY ADDRESSES
POST v1/company/shipment/address/detail	WEB - COMPANY ADDRESSES BY ID
POST v1/company/shipment/address/add	WEB - ADD NEW ADDRESS.
POST v1/company/shipment/address/remove	WEB - REMOVE ADDRESS.
POST v1/company/shipment/address/update	WEB - UPDATE ADDRESS.
POST v1/company/shipment/address/change-name	WEB - UPDATE ADDRESS NAME
POST v1/company/shipment/address/change-status	WEB - UPDATE ADDRESS STATUS
POST v1/company/shipment/location	WEB - User location in transit.
POST v1/company/shipment/locationDetails	WEB - User location details for a shipment.
POST v1/company/driver	WEB - List drivers of the company
POST v1/company/driver/vehicles	WEB - List drivers of the company
POST v1/company/driver/details	WEB - Return the detailed information for a driver
POST v1/company/driver/statistics	WEB - Return the performance statistics for a driver
POST v1/company/driver/add	WEB - Add company driver
POST v1/company/driver/status-update	WEB - Update company driver status
POST v1/company/driver/remove	WEB - Remove company driver
POST v1/company/driver/checkAvailable	WEB - List drivers of the company available between two specific date time points
POST v1/company/driver/findNearby	WEB - Find drivers near to a location
POST v1/company/driver/profileDetails	WEB - Find the profile details of a driver
POST v1/company/driver/assignShipment	WEB - Assign a company shipment to a company driver
POST v1/company/shipmentTemplate/list	WEB - List shipment templates of the company
POST v1/company/shipmentTemplate/save	WEB - Adds or updates a shipment template
POST v1/company/shipmentTemplate/remove	WEB - Remove a shipment template
POST v1/company/shipmentTemplate/delete	WEB - Delete a shipment template
POST v1/company/delegate/list	WEB - List delegate companies of the company
POST v1/company/shipment/delegate	WEB - Delegate a shipment to another company
POST v1/company/shipment/offerRequest	WEB - Request offers for a company shipment from a list of drivers
POST v1/company/shipment/offerRequest/list	WEB - Returns offers for a company shipment
POST v1/company/feedback/questions	WEB - Return the list of feedback questions for a shipment feedback
POST v1/company/feedback	WEB - Return the list of feedback questions for a shipment feedback
POST v1/company/approvedCompany/list	WEB - Returns the list of appreved companies
POST v1/company/shipment/listByState	WEB - Returns the list of shipment by state and date of global
POST v1/company/vehicle/add	WEB - Register new vehicle to company.
POST v1/company/vehicle/update	WEB - Update vehicle for company.
POST v1/company/vehicle/remove	WEB - Remove vehicle for company.
POST v1/company/vehicle/list	WEB - List company's vehicles.
POST v1/company/vehicle/detail	WEB - Detail company's vehicle.
POST v1/company/shipment/report	WEB - REPORT LIST SHIPMENT. List active shipments report.
POST v1/company/user/token	WEB - TOKEN TO COMPANY ACCOUNT
POST v1/company/user/token-login	WEB - TOKEN TO COMPANY ACCOUNT LOGIN
POST v1/company/driver/blacklist	WEB - Blacklist for drivers of the company
POST v1/company/driver/blacklist/add	WEB - Add blacklist company driver
POST v1/company/driver/blacklist/delete	WEB - Delete company driver ing blacklist
POST v1/company/shipment/document-list	WEB - LIST SHIPMENT DOCUMENTS
POST v1/company/shipment/document-recurrence-request	WEB - SHIPMENT DOCUMENTS RECURRENCE REQUEST
POST v1/company/shipment/document-update	WEB - SHIPMENT DOCUMENTS UPDATE
POST v1/company/service-station	WEB - LIST COMPANY SERVICE STATIONS
POST v1/company/report/driver	WEB - COMPANY DRIVER REPORT
POST v1/company/report/vehicle	WEB - COMPANY VEHICLE REPORT
POST v1/company/report/driver-score
POST v1/company/league-score/top-list-detail	MOBILE - GET LEAGUE SCORE TOP LIST DETAIL
POST v1/company/hdi-sigorta/send
POST v1/company/hdi-sigorta/get
POST v1/company/league-score/year-report	MOBILE - GET LEAGUE SCORE TOP LIST FOR YEAR
POST v1/company/shipment/waiting-report
POST v1/company/package-count
POST v1/company/drivertrip/summary
POST v1/company/drivertrip/summaryReport
POST v1/company/drivertrip/events
POST v1/company/shipment/statistics
POST v1/company/shipment/offer-report
POST v1/company/shipment/location-details

MobileShipmentOfferV1

Manages shipment offer methods for the mobile user

API	Description
POST v1/user/shipment/offer	MOBILE - Shipment get all offers.
POST v1/user/shipment/offer/add	MOBILE - Shipment add offer.
POST v1/user/shipment/offer/accept	MOBILE - Shipment accept offer.
POST v1/user/shipment/offer/count	MOBILE - Shipment offers count.
POST v1/user/shipment/offer/listStatus	MOBILE - Shipment offers by count status.
POST v1/user/shipment/offer/visit

MobileV1

API	Description
POST v1/user/register	MOBILE - Register new user to system if given cell number is not in DB, cell number must have 10 digits long.
POST v1/user/register/delete	MOBILE - Register new user to system if given cell number is not in DB, cell number must have 10 digits long.
POST v1/user/update	MOBILE - Update user's details. You can call this method only once. Only the field you can update more than once is user_image by calling v1/user/image
POST v1/user/update/image	MOBILE - Update user's image.
POST v1/user/device	MOBILE - Register or Update is exists user mobile device UUID for push notification.
POST v1/user/device/language	MOBILE - User device language update.
POST v1/user/login	MOBILE - Login user, returns user details.
POST v1/user/logout	MOBILE - Logout user, once user logged out system does not send push notification or SMS. User not listed under available drivers.
POST v1/user/sessionState	MOBILE - Check active session state for mobile user account.
POST v1/user/statistics	MOBILE - Return the performance statistics for the mobile user.
POST v1/user/location	MOBILE - Receive user's location.
POST v1/user/location/multiple	MOBILE - Receive user's multiple locations.
POST v1/user/vehicle	MOBILE - List user's vehicles.
POST v1/user/vehicle/add	MOBILE - Register new vehicle to user domain.
POST v1/user/vehicle/update	MOBILE - Update existing vehicle to user domain.
POST v1/user/vehicle/remove	MOBILE - Remove existing vehicle from user domain.
POST v1/user/bank	MOBILE - List user's bank account.
POST v1/user/bank/add	MOBILE - Register new bank account to user domain.
POST v1/user/bank/remove	MOBILE - Remove existing bank account from user domain.
POST v1/user/bank/delete	MOBILE - Delete existing bank account from user domain.
POST v1/user/shipment	MOBILE - List shipments.
POST v1/user/shipment/offerRequest/list	MOBILE - Return the list of offer requests for the user.
POST v1/user/shipment/offerRequest/respond	MOBILE - Respond to one of the offer requests.
POST v1/user/shipment/departure/paper/add	MOBILE - UPLOAD Departure Papers.
POST v1/user/shipment/departure/paper/add/multiple	MOBILE - UPLOAD Departure Multiple Papers.
POST v1/user/shipment/delivery/paper/add	MOBILE - UPLOAD DELIVERY Papers.
POST v1/user/shipment/delivery/paper/add/multiple	MOBILE - UPLOAD DELIVERY Multiple Papers.
POST v1/user/shipment/delivery/paper/invoice/add	MOBILE - UPLOAD DELIVERY Papers.
POST v1/user/shipment/delivery/paper/invoice/add/multiple	MOBILE - UPLOAD DELIVERY Multiple Papers.
POST v1/user/shipment/within-stop-location	MOBILE - WITHIN STOP LOCATION
POST v1/user/report/add	MOBILE - Submit Report.
POST v1/user/shipment/stop/log	MOBILE - INSERT Stop Entry Log.
POST v1/user/shipment/onroad	MOBILE - User set shipment on road.
POST v1/user/shipment/getOnRoad
POST v1/user/shipment/checkVehicle	MOBILE - User check vehicle type for shipment.
POST v1/user/shipment/document-list	MOBILE - LIST SHIPMENT DOCUMENTS
POST v1/user/company/settings	MOBILE - Company settings.
POST v1/user/company/confirmation-request-list	MOBILE - COMPANY APPROVED REQUEST LIST
POST v1/user/company/confirmation	MOBILE - COMPANY APPROVED REQUEST
POST v1/user/shipment/service-station	MOBILE - GET SHIPMENT COMPANY SERVICE STATION
POST v1/user/change-busy-status	MOBILE - CHANGE USER BUSY STATUS
POST v1/user/shipment-visit	MOBILE - USER SHIPMENT VISIT
POST v1/user/company-vehicle	MOBILE - GET COMPANY VEHICLE RELATION FOR USER
POST v1/user/league-scores	MOBILE - GET LEAGUE SCORES
POST v1/user/league-score/monthly	MOBILE - GET LEAGUE SCORES MONTHLY
POST v1/user/league-score/top-list	MOBILE - GET LEAGUE SCORE TOP LIST
POST v1/user/league-score/add-score	MOBILE - ADD LEAGUE SCORE
POST v1/user/league-score/rank	MOBILE - GET USER LEAGUE RANK
POST v1/user/driver-company-list	MOBILE - DRIVER COMPANY LIST BY TYPE
POST v1/user/regions	MOBILE - DRIVER REGION LIST
POST v1/user/region/save	MOBILE - DRIVER REGION ADD/REMOVE
POST v1/user/param-card/add	MOBILE - ADD PARAM CARD
POST v1/user/notifications	MOBILE - NOTIFICATIONS
POST v1/user/notifications/notifications-delete
POST v1/user/survey	WEB - Get Survey Detail
POST v1/user/survey/send	WEB - Survey Respond
POST v1/user/set-invoice-service-guid	WEB - Update Invoice Service Guid
POST v1/user/company-detail	WEB - Get Company Detail by Company UID
POST v1/user/shipment/recommended-fee	WEB - Get Shipment Recommended Fee
POST v1/user/shipment/detail-email
POST v1/user/device/location-information-status	MOBILE - User location information status update
POST api/MobileV1

Payment

API	Description
POST v1/web/payment
POST v1/payment
POST v1/payment/success
POST v1/payment/card-number/list
POST v1/payment/card-number/save
POST v1/payment/card-number/delete
POST v1/payment/transfer
POST v1/payment/installment-count

ShipmentProblemV1

Contains mobile and web user methods for shipment problem reporting

API	Description
POST v1/user/shipmentProblem	MOBILE - Returns the list of shipment problems for a shipment to the mobile user
POST v1/company/shipmentProblem	WEB - Returns the list of shipment problems for a shipment to the web user
POST v1/user/shipmentProblem/create	MOBILE - Creates a problem report for a shipment

TestApi

API	Description
POST v1/test/sms?phoneNumber={phoneNumber}	TEST - Test SMS Service
POST v1/test/tc?tc={tc}&ad={ad}&soyad={soyad}&yil={yil}