11# libsbapi
22
3- ### Custom API for Integration of Shoutbomb with Symphony ###
3+ ## Custom API for Integration of Shoutbomb with Symphony
44
55NOTES: custom Information fails on test, LOSFORMAT policy does not exist
66
7- ## These are the SBAPI endpoints ##
7+ ## These are the SBAPI endpoints
88
9- # Example: userkey – returns user key/user barcode/home library/barcode expiration date when querying a user barcode #
9+ ### Example: userkey – returns user key/user barcode/home library/barcode expiration date when querying a user barcode
1010
1111URL: https://server:port/cgi-bin/sb.cgi?report=userkey&uid=21168045392313
1212
@@ -24,11 +24,14 @@ Output:
2424 </USER>
2525```
2626
27- # Example: userbarcode – returns user key/user barcode/home library/barcode expiration date when querying a user key #
27+ ### Example: userbarcode – returns user key/user barcode/home library/barcode expiration date when querying a user key
2828
2929URL: https://server:port/cgi-bin/sb.cgi?report=userbarcode&ukey=445800
3030
31- Input: ukey = user internal key
31+ Input:
32+
33+ ukey
34+ : user internal key
3235
3336Output:
3437```
@@ -42,11 +45,14 @@ Output:
4245 </USER>
4346```
4447
45- # Example: holds – returns barcode and item hold available for pickup and not yet filled, when querying a user barcode #
48+ ### Example: holds – returns barcode and item hold available for pickup and not yet filled, when querying a user barcode
4649
4750URL: https://server:port/cgi-bin/sb.cgi?report=hold&uid=21967002133994
4851
49- Input: uid = patron barcode number
52+ Input:
53+
54+ uid
55+ : patron barcode number
5056
5157Output:
5258```
@@ -85,11 +91,14 @@ Output:
8591
8692` </HOLD_DB_KEY> ` is needed to enable the cancellation of this item hold.
8793
88- # Example: courtesy– returns barcode and item barcode/title/due date/renew eligibility when querying a user barcode #
94+ ### Example: courtesy– returns barcode and item barcode/title/due date/renew eligibility when querying a user barcode
8995
9096https://server:port/cgi-bin/sb.cgi?report=courtesy&uid=21967002133994
9197
92- Input: uid = patron barcode number
98+ Input:
99+
100+ uid
101+ : patron barcode number
93102
94103Output:
95104```
@@ -131,11 +140,14 @@ Output:
13114013 - Item is not eligible for renewal as item is on-hold
13214114 - Item is not eligible for renewal as maximum number renewals for the item has been reached
133142
134- # Example: overdue– returns barcode and item barcode/title/due date/renew eligibility when querying a user barcode #
143+ ### Example: overdue– returns barcode and item barcode/title/due date/renew eligibility when querying a user barcode
135144
136145https://server:port/cgi-bin/sb.cgi?report=overdue&uid=21967002133994
137146
138- Input: uid = patron barcode number
147+ Input:
148+
149+ uid
150+ : patron barcode number
139151
140152Output:
141153```
@@ -166,7 +178,7 @@ Output:
16617814 - Item is not eligible for renewal as maximum number renewals for the item has been reached
16717915 - Item is not eligible for renewal due to limit set on how many overdue items a patron can have at one time
168180
169- # Example: overdue– returns user barcode/item barcode and charge status when querying a user barcode #
181+ ### Example: overdue– returns user barcode/item barcode and charge status when querying a user barcode
170182
171183https://server:port/cgi-bin/sb.cgi?report=chkcharge&uid=21967002133994&id=31967011342030
172184
@@ -182,15 +194,21 @@ Output:
182194 </ITEM>
183195```
184196
185- <CHARGED > has the following possible values
186- 0 - Item is not charged to patron
187- 1 - Item is charged to patron
197+ ` <CHARGED> ` has the following possible values:
198+
199+ 0
200+ : Item is not charged to patron
201+ 1
202+ : Item is charged to patron
188203
189- # Example: chkhold– returns item barcode and if item has a hold #
204+ ### Example: chkhold– returns item barcode and if item has a hold
190205
191206https://server:port/cgi-bin/sb.cgi?report=chkhold&id=31967011342030
192207
193- Input: id = item barcode number
208+ Input:
209+
210+ id
211+ : item barcode number
194212
195213Output:
196214```
@@ -200,15 +218,21 @@ Output:
200218 </ITEM>
201219```
202220
203- ` < ONHOLD> ` has the following possible values
204- 0 - Item has no hold
205- 1 - Item has a hold
221+ ` < ONHOLD> ` has the following possible values:
222+
223+ 0
224+ : Item has no hold
225+ 1
226+ : Item has a hold
206227
207- # Example: fee– returns total fees linked to patron #
228+ ### Example: fee– returns total fees linked to patron
208229
209230https://server:port/cgi-bin/sb.cgi?report=fee&uid=21967002133994
210231
211- Input: uid = patron barcode number
232+ Input:
233+
234+ uid
235+ : patron barcode number
212236
213237Output:
214238```
@@ -220,11 +244,14 @@ Output:
220244 </USER>
221245```
222246
223- # Example: noticetype– returns patrons that requested notices via sms or voice #
247+ ### Example: noticetype– returns patrons that requested notices via sms or voice
224248
225249https://server:port/cgi-bin/sb.cgi?report=noticetype&type=sms
226250
227- Input: type = sms or voice
251+ Input:
252+
253+ type
254+ : sms|voice
228255
229256Output:
230257```
@@ -240,12 +267,16 @@ Output:
240267 </USER>
241268```
242269
243- # Example: cancel– returns success or failure, when attempting to abandon a hold ready for pickup #
270+ ### Example: cancel– returns success or failure, when attempting to abandon a hold ready for pickup
244271
245272https://server:port/cgi-bin/sb.cgi?report=cancel&uid=21967002133994&dbkey=1234566
246273
247- Input: uid = patron barcode number
248- dbkey = hold DB key
274+ Input:
275+
276+ uid
277+ : patron barcode number
278+ dbkey
279+ : hold DB key
249280
250281Output:
251282```
@@ -257,11 +288,14 @@ Output:
2572880 – Cancel item hold failed
2582891 – Cancel item hold succeeded
259290
260- # Example: holdexpiration– returns list of patron hold items that expired and not fulfilled #
291+ ### Example: holdexpiration– returns list of patron hold items that expired and not fulfilled
261292
262293https://server:port/cgi-bin/sb.cgi?report=holdexpiration&date=20200817
263294
264- Input: date = date item hold request expired, YYYYMMDD
295+ Input:
296+
297+ date
298+ : date item hold request expired, YYYYMMDD
265299
266300Output:
267301```
0 commit comments