Skip to Content

Changes for page API V2.0

Last modified by Treyfane Dingo on 2024/03/10 02:07
From version 10.1
edited by Treyfane Dingo
on 2024/02/11 19:43
Change comment: There is no comment for this version
To version 4.2
edited by Treyfane Dingo
on 2023/08/15 13:00
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,6 +1,6 @@
1 1  The L.A.S.S.I.E. API V 2.0 can be reached via
2 2  
3 -{{{https://api.lassie.online/v2.0}}}
3 +{{{https://www.furcom.org/api/lassie/v2.0}}}
4 4  
5 5  === Required POST Parameters ===
6 6  
... ... @@ -10,7 +10,7 @@
10 10  * request
11 11  * command (optional)
12 12  
13 -The API-Key has to be set in "System Settings" → "API Keys". Preferrably a longer and unique key (like a MD5SUM). An specific API key can only be used for a corresponding request type.
13 +The API-Key has to be set in "System Settings". Preferrably a longer and unique key (like a MD5SUM). An specific API key can only be used for a corresponding request type.
14 14  
15 15  (% style="width:50%" %)
16 16  |=(% colspan="3" %)Requests and Commands
... ... @@ -25,23 +25,14 @@
25 25  
26 26  === Example (CURL) ===
27 27  
28 -{{{curl -X POST -d "apikey=ae629a834729fd3aac6d1f827b1793b0" -d "request=lostandfounddb" https://api.lassie.online/v2.0}}}
28 +{{{curl -X POST -d "apikey=ae629a834729fd3aac6d1f827b1793b0" -d "request=lostandfounddb" https://www.furcom.org/api/lassie/v2.0}}}
29 29  
30 30  This example will display the entire Lost & Found Database of FTC.
31 31  
32 -{{{curl -X POST -d "apikey=ae629a834729fd3aac6d1f827b1793b0" -d "request=lostandfounddb" -d "command=lost" https://api.lassie.online/v2.0}}}
32 +{{{curl -X POST -d "apikey=ae629a834729fd3aac6d1f827b1793b0" -d "request=lostandfounddb" -d "command=lost" https://www.furcom.org/api/lassie/v2.0}}}
33 33  
34 34  This example will display only the lost items of the Lost & Found Database of FTC.
35 35  
36 -=== Test API Keys ===
37 -
38 -The API Keys for FurtherTestCon (FTC) are:
39 -
40 -{{{ae629a834729fd3aac6d1f827b1793b2 Attendee Database
41 -ae629a834729fd3aac6d1f827b1793b1 Operatives Database
42 -ae629a834729fd3aac6d1f827b1793b0 Lost & Found Database
43 -ae629a834729fd3aac6d1f827b1793b3 Briefings Database}}}
44 -
45 45  === Output ===
46 46  
47 47  The output of an valid request to the API will be a JSON-Object like the following examples:
... ... @@ -49,43 +49,7 @@
49 49  ==== Lost & Found Database ====
50 50  
51 51  {{box}}
52 -{
53 - "data": [
54 - {
55 - "id": 1925,
56 - "image": null,
57 - "thumb": null,
58 - "title": "Image",
59 - "description": "invisible, watercolour, found in Schroedinger's box",
60 - "status": "F",
61 - "lost_timestamp": null,
62 - "found_timestamp": "2023-11-24 00:27:24",
63 - "return_timestamp": null
64 - },
65 - {
66 - "id": 1921,
67 - "image": "https:~/~/api.lassie.furcom.org/images/lostandfound_db/fe3c6670a33d8f4199ffa95a5c23b622.png",
68 - "thumb": "https:~/~/api.lassie.furcom.org/images/lostandfound_db/thumbnail/fe3c6670a33d8f4199ffa95a5c23b622.png",
69 - "title": "Sense of Taste",
70 - "description": "lost in Hotel Restaurant",
71 - "status": "L",
72 - "lost_timestamp": "2023-11-01 16:13:02",
73 - "found_timestamp": null,
74 - "return_timestamp": null
75 - },
76 - {
77 - "id": 1920,
78 - "image": "https:~/~/api.lassie.furcom.org/images/lostandfound_db/bc7c343fb3807d4d41b7e04fa909aad5.png",
79 - "thumb": "https:~/~/api.lassie.furcom.org/images/lostandfound_db/thumbnail/bc7c343fb3807d4d41b7e04fa909aad5.png",
80 - "title": "Vape",
81 - "description": "black / rainbow, \"GEEKVAPE\", found at Open Stage",
82 - "status": "F",
83 - "lost_timestamp": null,
84 - "found_timestamp": "2023-09-30 23:52:38",
85 - "return_timestamp": null
86 - }
87 - ]
88 -}
43 +{"data":[{"id":"1","image":"https:\/\/www.furcom.org\/lassie\/images\/lostandfound_db\/9a7a1039bcbe887ed2f57a5b64c56c51.png","title":"A Piece of Cake","description":"Just another piece of cake","status":"F","lost_timestamp":"","found_timestamp":"2021-06-22 19:08:16","return_timestamp":""}]}
89 89  {{/box}}
90 90  
91 91  (% style="width:50%" %)
... ... @@ -93,7 +93,6 @@
93 93  |=(% scope="col" %)Key|=Field|=NULL
94 94  |id|Numeric value, PRIMARY KEY|-
95 95  |image|URL|null
96 -|thumb|URL|null
97 97  |title|Text|empty string
98 98  |description|Text|empty string
99 99  |status|L ~| F ~| R (Lost, Found or Returned)|-
... ... @@ -104,20 +104,7 @@
104 104  ==== Briefings Database ====
105 105  
106 106  {{box}}
107 -{
108 - "data": [
109 - {
110 - "id": "17",
111 - "class": "P",
112 - "topic": "UPDATE - Security News 21.12.2021",
113 - "content": "<div id=\"briefing_content_content\"><div><b>Germany cancelled New Years Eve</b></div><div>Although it might calendar wise be unwise, Germany just cancelled New Years Eve. Further information can be obtained elsewhere.</div><div><br></div><div><b>Some things found</b></div><div>Security\r\n wants to remind all attendees that information about lost or found \r\nitems can be obtained via the APP or the Website of the convention. Lost\r\n &amp; Found is maintained by security and located in the security \r\noffice.</div><div><br></div><div><b>Quote of the day</b></div><div>\"Where is your neighbour?\"</div><div>\"He's in the garden ...\"</div><div>\"I can't see him ...\"</div><div>\"Oh, you'd have to dig quite a bit ...\"<br></div><div><br></div></div>",
114 - "ops_id": "112",
115 - "datetime_creation": "2021-12-21 22:19:45",
116 - "datetime_lastchange": "",
117 - "datetime": "2021-12-21 22:19:45"
118 - }
119 - ]
120 -}
61 +{"data":[{"id":"17","class":"P","topic":"UPDATE - Security News 21.12.2021","content":"<div id=\"briefing_content_content\"><div><b>Germany cancelled New Years Eve<\/b><\/div><div>Although it might calendar wise be unwise, Germany just cancelled New Years Eve. Further information can be obtained elsewhere.<\/div><div><br><\/div><div><b>Some things found<\/b><\/div><div>Security\r\n wants to remind all attendees that information about lost or found \r\nitems can be obtained via the APP or the Website of the convention. Lost\r\n &amp; Found is maintained by security and located in the security \r\noffice.<\/div><div><br><\/div><div><b>Quote of the day<\/b><\/div><div>\"Where is your neighbor?\"<\/div><div>\"He's in the garden ...\"<\/div><div>\"I can't see him ...\"<\/div><div>\"Oh, you'd have to dig quite a bit ...\"<br><\/div><div><br><\/div><\/div>","ops_id":"112","datetime_creation":"2021-12-21 22:19:45","datetime_lastchange":"","datetime":"2021-12-21 22:19:45"}]}
121 121  {{/box}}
122 122  
123 123  (% style="width:50%" %)
... ... @@ -135,9 +135,7 @@
135 135  ==== Empty Object ====
136 136  
137 137  {{box}}
138 -{
139 - "data": []
140 -}
79 +{"data":[]}
141 141  {{/box}}
142 142  
143 143  === Error Codes ===
... ... @@ -145,12 +145,7 @@
145 145  The API will send a JSON-Object upon errors
146 146  
147 147  {{box}}
148 -{
149 - "error": {
150 - "code": "503",
151 - "message": "Maintenance Mode enabled - please try again later"
152 - }
153 -}
87 +{"error":{"code":"503","message":"Maintenance Mode enabled - please try again later"}}
154 154  {{/box}}
155 155  
156 156  The following error codes are implemented: