1. Function description
- The receiver provides an interface for receiving GPS and alarm data. TTX platform pushes json data to the third- party platform through http protocol post.
- Push location, alarm, attachment address to third party
2. operating instructions
2.1 Add Custom Forwarding
Go to [Operations]>[Forwarding]>[Custom Forwarding Configuration], click the "Add" button, and fill in the push nameNote ①, forwarding user, and push address in the configuration interface. After saving, it will take 1-3 minutes to take effect.
Example:
Example of location push address: GpsPushUrl = http://127.0.0.1:6666/GpsPush
Example of alarm push address: AlarmPushUrl = http://127.0.0.1:6666/AlarmPush
Example of attachment push address: AttachmentPushUrl = http://127.0.0.1:6666/AttachmentPush
Example of transparent data push address: TransportDataPushUrl = http://127.0.0.1:6666/TransportDataPush
Note 1: Search for the push name in the 'bin/logs' directory on the server to view the relevant push logs
2.2 to judge whether the forwarding is successful
The number of pushed in the positioning push state is greater than 0, which means the forwarding is successful.
2.3 data description
2.3.1 GPS data push instructions
Example: GpsPushUrl = http://127.0.0.1:6666/GpsPush
2.3.1.1 GPS data push
15:32:33 post msg ={"gpslist":[{"ac":10,"adas1":0,"adas2":0,"aq":0,"bsd1":0,"cet":0,"ct":0,"dct":null,"dn":"future nickname?," drid ":null," dsm1 ":0," dsm2 ":0," dst ":0," dt ":0," dvt ":0," ef ":1," es ":12," fdt ":3," fl ":0," ft ":0," fvs ":0," gd ":0," gt ":" 2024- 11- 26 15:32:32 "," gw ":0," hx ":0," id ":" 013306543907 "," ios ":0," jn ":" 370502197411286035 "," lat ":37393166," lc ":71378000," lg ":2," lid ":null," lng ":118558966," ls ":33816588," lt ":1," mlat ":" 37.393166 "," mlng ":" 118.558966 "," net ":3," ojm ":null," ojt ":null," ol ":1," or ":null," OS ":null," ost ":null," ov ":null," p1 ":0," p2 ":0," p3 ":0," p4 ":0," p5 ":0," p6 ":0," p7 ":0," pk ":0," ps ":0," pt ":0," rfd ":0," rft ":0," rt ":" 2024- 11- 26 15:32:33 "," s1 ":4483," s2 ":544768," s3 ":1113856," s4 ":0," sfg ":null," sn ":15," snm ":null," sp ":740," sst ":null," t1 ":0," t2 ":0," t3 ":0," t4 ":0," tp ":" 000000000000000000000000000000000000000000000000000000000000 "," tsp ":770," ust ":0," viceYl ":0," vid ":" linden F9610 "," wc ":0," yl ":0," yn ":0}]}
15:32:33 success resp ={"msg":"neptunium", "code":200}
2.3.1.2 json data description
Refer to API interface: Get real-time device status
2.3.2 Alarm Push Data Description
Example: AlarmPushUrl = http://127.0.0.1:6666/AlarmPush
2.3.2.1 Single alarm, packet capture data are as follows:
POST /AlarmPush HTTP/1.1
Host: 127.0.0.1:6666
Accept: /
Content- Type: application/json;charset=UTF- 8
Content- Length: 522
{"alarmlist":[{"DevIDNO":"10002","Gps":{"dct":0,"gt":"2020- 11- 10 11:18:55","hx":0,"lat":22766394,"lc":48455883,"lid":1,"lng":113845247,"mlat":"22.766394","mlng":"113.845247","net":0,"pk":44,"s1":805319043,"s2":0,"s3":0,"s4":0,"sfg":0,"snm":0,"sp":0,"sst":0,"t1":- 321,"t2":350,"t3":- 200,"t4":38,"tsp":0,"yl":6048},"desc":"","guid":"1000247B519F2F8A5443BBF8ACA7FED0F9C","hd":0,"img":"","info":0,"p1":0,"p2":0,"p3":0,"p4":0,"rve":0,"srcAt":0,"srcTm":"2000- 00- 00 00:00:00","stType":11,"time":"2020- 11- 10 11:18:55","type":11}]}
2.3.2.2 Multiple alarms, the packet capture data are as follows:
POST /AlarmPush HTTP/1.1
Host: 127.0.0.1:6666
Accept: /
Content- Type: application/json;charset=UTF- 8
Content- Length: 3105
Expect: 100- continue
{"alarmlist":[{"DevIDNO":"10002","Gps":{"dct":0,"gt":"2020- 11- 10 11:24:06","hx":201,"lat":22731144,"lc":48460817,"lid":1,"lng":113837809,"mlat":"22.731144","mlng":"113.837809","net":0,"pk":0,"s1":805327235,"s2":0,"s3":0,"s4":0,"sfg":0,"snm":0,"sp":750,"sst":0,"t1":- 321,"t2":350,"t3":- 200,"t4":41,"tsp":0,"yl":5999},"desc":"","guid":"100021846F994C146488CBBC32EFB9956A1","hd":0,"img":"","info":0,"p1":7500,"p2":750,"p3":0,"p4":0,"rve":0,"srcAt":0,"srcTm":"2000- 00- 00 00:00:00","stType":11,"time":"2020- 11- 10 11:24:06","type":11},{"DevIDNO":"10002","Gps":{"dct":0,"gt":"2020- 11- 10 11:24:06","hx":201,"lat":22731144,"lc":48460817,"lid":1,"lng":113837809,"mlat":"22.731144","mlng":"113.837809","net":0,"pk":0,"s1":805327235,"s2":0,"s3":0,"s4":0,"sfg":0,"snm":0,"sp":750,"sst":0,"t1":- 321,"t2":350,"t3":- 200,"t4":42,"tsp":0,"yl":5999},"desc":"","guid":"1000237491B1ECB144BADA4E5EF3D852AEF","hd":0,"img":"","info":0,"p1":7500,"p2":750,"p3":0,"p4":0,"rve":0,"srcAt":0,"srcTm":"2000- 00- 00 00:00:00","stType":11,"time":"2020- 11- 10 11:24:06","type":11},{"DevIDNO":"10002","Gps":{"dct":0,"gt":"2020- 11- 10 11:24:06","hx":201,"lat":22730965,"lc":48460838,"lid":1,"lng":113837744,"mlat":"22.730965","mlng":"113.837744","net":0,"pk":0,"s1":805327235,"s2":0,"s3":0,"s4":0,"sfg":0,"snm":0,"sp":760,"sst":0,"t1":- 321,"t2":350,"t3":- 200,"t4":43,"tsp":0,"yl":5999},"desc":"","guid":"10002675245187A9847A38F63E06ED4701F","hd":0,"img":"","info":0,"p1":7600,"p2":760,"p3":0,"p4":0,"rve":0,"srcAt":0,"srcTm":"2000- 00- 00 00:00:00","stType":11,"time":"2020- 11- 10 11:24:06","type":11},{"DevIDNO":"10002","Gps":{"dct":0,"gt":"2020- 11- 10 11:24:07","hx":201,"lat":22730786,"lc":48460860,"lid":1,"lng":113837662,"mlat":"22.730786","mlng":"113.837662","net":0,"pk":0,"s1":805327235,"s2":0,"s3":0,"s4 ": 0,"sfg":0,"snm":0,"sp":760,"sst":0,"t1":- 321,"t2":350,"t3":- 200,"t4":44,"tsp":0,"yl":5998},"desc":"","guid":"10002A9525A320884459E9DEF737E18333D","hd":0,"img":"","info":0,"p1":7600,"p2":760,"p3":0,"p4":0,"rve":0,"srcAt":0,"srcTm":"2000- 00- 00 00:00:00","stType":11,"time ":"2020- 11- 10 11:24:07","type":11},{"DevIDNO":"10002","Gps":{"dct":0,"gt":"2020- 11- 10 11:24:07","hx":201,"lat":22730786,"lc":48460860,"lid":1,"lng":113837662,"mlat":"22.730786","mlng":"113.837662","net":0,"pk":0,"s1":805327235,"s2":0,"s3":0,"s4":0,"sfg":0,"snm":0,"sp":760,"sst":0,"t1":- 321,"t2":350,"t3":- 200,"t4":45,"tsp":0,"yl":5998},"desc":"","guid":"100020032CE0224AD4410BBECCA11BA9741","hd":0,"img":"","info":0,"p1":7600,"p2":760,"p3":0,"p4":0,"rve":0,"srcAt":0,"srcTm":"2000- 00- 00 00:00:00","stType":11,"time":"2020- 11- 10 11:24:07","type":11},{"DevIDNO":"10002","Gps":{"dct":0,"gt":"2020- 11- 10 11:24:08","hx":201,"lat":22730786,"lc":48460860,"lid":1,"lng":113837662,"mlat":"22.730786","mlng":"113.837662","net":0,"pk":0,"s1":805327235,"s2":0,"s3":0,"s4":0,"sfg":0,"snm":0,"sp":760,"sst":0,"t1":- 321,"t2":350,"t3":- 200,"t4":46,"tsp":0,"yl":5998},"desc":"","guid":"10002F7F6F887AFF945959675F2AD513E5B","hd":0,"img":"","info":0,"p1":7600,"p2":760,"p3":0,"p4":0,"rve":0,"srcAt":0,"srcTm":"2000- 00- 00 00:00:00","stType":11,"time":"2020- 11- 10 11:24:08","type":11}]}
2.3.2.3 json data description
Refer to API interface: Acquire real-time alarm of equipment
2.3.3 Alarm Processing Push Description
Example: AlarmHandleUrl = http://127.0.0.1:6666/AlarmHandlePush
2.3.3.1 Single alarm processing push, the data is as follows:
Post msg ={"alarmhandlelist":[{"arm_time_start":"2021- 05- 19 09:12:45","arm_type":605,"devl_dno":"040492594350","driver_id":0,"guid":"00040492594350210519091245000700","handle_info":"ts | 2021- 05- 19 09:36:04 | Chen insert it?," handle_status ":8," handle_time ":" 2021- 05- 19 09:36:04 "," vehi_id ":2742}]}
success resp ={"code":"SUCCESS","message":"General"}
2.3.3.2 Multiple alarm processing push, the data is as follows:
2021- 05- 18 19:12:52 post msg ={"alarmhandlelist":[{"arm_time_start":"2021- 05- 18 00:01:45","arm_type":618,"devl_dno":"064920702095","driver_id":0,"guid":"00064920702095210518000145000000","handle_info":"admin | 2021- 05- 18 19:12:50 | stubble?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":10661 },{" arm_time_start ":" 2021- 05- 18 00:02:33 "," arm_type ":618," devl_dno ":" 064920702095 "," driver_id ":0," guid ":" 00064920702095210518000233000000 "," handle_info ":" admin | 2021- 05- 18 19:12:50 | Chen stubble 'cong?,"handle_status":3,"handle_time":"2021- 05- 18 19:12:50","vehi_id":10661 },{ "arm_time_start":"2021- 05- 18 00:03:07","arm_type":602,"devl_dno":"064920968541","driver_id":37955,"guid":"00064920968541210518000307000400","handle_info":"admin | 2021- 05- 18 19:12:50 | Chen stubble' cong?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":9855 },{" arm_time_start ":" 2021- 05- 18 00:03:09 "," arm_type ":618," devl_dno ":" 064920702095 "," driver_id ":0," guid ":" 00064920702095210518000309000000 "," handle_info ":" admin | 2021- 05- 18 19:12:50 | Chen stubble 'cong?,"handle_status":3,"handle_time":"2021- 05- 18 19:12:50","vehi_id":10661 },{ "arm_time_start":"2021- 05- 18 00:04:49","arm_type":602,"devl_dno":"064920860848","driver_id":0,"guid":"00064920860848210518000449000000","handle_info":"admin | 2021- 05- 18 19:12:50 | Chen stubble' cong?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":4410 },{" arm_time_start ":" 2021- 05- 18 00:05:26 "," arm_type ":618," devl_dno ":" 064920702095 "," driver_id ":0," guid ":" 00064920702095210518000526000000 "," handle_info ":" admin | 2021- 05- 18 19:12:50 | Chen stubble 'cong?,"handle_status":3,"handle_time":"2021- 05- 18 19:12:50","vehi_id":10661 },{ "arm_time_start":"2021- 05- 18 00:06:14","arm_type":618,"devl_dno":"064920702095","driver_id":0,"guid":"00064920702095210518000614000000","handle_info":"admin | 2021- 05- 18 19:12:50 | Chen stubble' cong?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":10661 },{" arm_time_start ":" 2021- 05- 18 00:06:18 "," arm_type ":603," devl_dno ":" 000002030080 "," driver_id ":0," guid ":" 00000002030080210518000618000700 "," handle_info ":" admin | 2021- 05- 18 19:12:50 | Chen stubble 'cong?,"handle_status":3,"handle_time":"2021- 05- 18 19:12:50","vehi_id":1551 },{ "arm_time_start":"2021- 05- 18 00:07:52","arm_type":602,"devl_dno":"010400000394","driver_id":0,"guid":"00010400000394210518000752000700","handle_info":"admin | 2021- 05- 18 19:12:50 | Chen stubble' cong?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":4797 },{" arm_time_start ":" 2021- 05- 18 00:06:56 "," arm_type ":618," devl_dno ":" 064920702095 "," driver_id ":0," guid ":" 00064920702095210518000656000000 "," handle_info ":" admin | 2021- 05- 18 19:12:50 | Chen stubble 'cong?,"handle_status":3,"handle_time":"2021- 05- 18 19:12:50","vehi_id":10661 },{ "arm_time_start":"2021- 05- 18 00:08:09","arm_type":744,"devl_dno":"040436022033","driver_id":0,"guid":"02040436022033210518000809000500","handle_info":"admin | 2021- 05- 18 19:12:50 | Chen stubble' cong?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":20130 },{" arm_time_start ":" 2021- 05- 18 00:09:48 ", "arm_type":602,"devl_dno":"064915028219","driver_id":40810,"guid":"00064915028219210518000948000000","handle_info":"admin | 2021- 05- 18 19:12:50 | Chen stubble?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":7864 },{" arm_time_start ":" 2021- 05- 18 00:10:47 "," arm_type ":618," devl_dno ":" 064920702095 "," driver_id ":0," guid ":" 00064920702095210518001047000000 "," handle_info ":" admin | 2021- 05- 18 19:12:50 | Chen stubble?,"handle_status":3,"handle_time":"2021- 05- 18 19:12:50","vehi_id":10661 },{ "arm_time_start":"2021- 05- 18 00:11:22","arm_type":603,"devl_dno":"064657793823","driver_id":1257,"guid":"00064657793823210518001122000700","handle_info":"admin | 2021- 05- 18 19:12:50 | Chen stubble 'cong?," handle_status ":3," handle_time ":" 2021- 05- 18 19:12:50 "," vehi_id ":4778}]}
2021- 05- 18 19: success resp ={"code":"SUCCESS","message":"12"}
2.3.4 Push instructions for alarm accessories
Example: AttachmentPushUrl = http://127.0.0.1:6666/AttachmentPush
2.3.4.1 Single alarm attachment is pushed, and the data is as follows:
11:17:38 post msg={"list":[{"DevIDNO":"016095390170","fileList":[{"fileUrl":"https://localhost:16611/3/5?DownType=3&jsession=&DevIDNO=016095390170&FILELOC=2&FLENGTH=255977&FOFFSET=1035850968&MTYPE=1&FPATH=E:/gStorage/JPEG_FILE/2025-10-30/20251030-104154_DS1.picfile","type":"image"}],"guid":"00016095390170251030111728000100","time":"2025-10-30 11:17:38","type":602}]}
11:17:38 success resp ={"code":"200","msg":"a","data":"a"}
2.3.4.2 Multiple alarm attachments are pushed, and the data is as follows:
11:34:45 post msg={"list":[{"DevIDNO":"040408227547","fileList":[{"fileUrl":"https:/localhost:16611/3/5?DownType=3&jsession=&DevIDNO=040408227547&FILELOC=2&FLENGTH=297042&FOFFSET=492655835&MTYPE=1&FPATH=E:/gStorage/JPEG_FILE/2025-10-30/20251030-111850_DS1.picfile","type":"image"},{"fileUrl":"https://localhost:16611/3/5?DownType=3&jsession=&DevIDNO=040408227547&FILELOC=2&FLENGTH=235111&FOFFSET=493648239&MTYPE=1&FPATH=E:/gStorage/JPEG_FILE/2025-10-30/20251030-111850_DS1.picfile","type":"image"},{"fileUrl":"https://localhost:16611/3/5?DownType=3&jsession=&DevIDNO=040408227547&FILELOC=2&FLENGTH=239517&FOFFSET=495897594&MTYPE=1&FPATH=E:/gStorage/JPEG_FILE/2025-10-30/20251030-111850_DS1.picfile","type":"image"}],"guid":"00040408227547251030113414000400","time":"2025-10-30 11:34:45","type":602},{"DevIDNO":"015984879159","fileList":[{"fileUrl":"https://localhost:16611/3/5?DownType=3&jsession=&DevIDNO=015984879159&FILELOC=2&FLENGTH=177693&FOFFSET=507074269&MTYPE=1&FPATH=E:/gStorage/JPEG_FILE/2025-10-30/20251030-111850_DS1.picfile","type":"image"}],"guid":"00015984879159251030113433000200","time":"2025-10-30 11:34:45","type":603},{"DevIDNO":"016064258288","fileList":[{"fileUrl":"https://localhost:16611/3/5?DownType=3&jsession=&DevIDNO=016064258288&FILELOC=2&FLENGTH=256845&FOFFSET=506678962&MTYPE=1&FPATH=E:/gStorage/JPEG_FILE/2025-10-30/20251030-111850_DS1.picfile","type":"image"}],"guid":"00016064258288251030113434000200","time":"2025-10-30 11:34:45","type":635}]}
11:34:45 success resp ={"code":"200","msg":"a","data":"a"}
2.4 forwarding error code
2.5 Other Considerations
- Latitude and longitude conversion type: the default is WGS84 coordinate system, and Google, Baidu coordinate system optional.
- Maximum number of push per push: If there are more push vehicles and more corresponding data, the default 128 can be changed to 256, 512 or even larger to improve the delivery efficiency.
- The address in the attachment push link type refers to the address configured by the storage server.
