Skip to content

Commit d651430

Browse files
Merge pull request #14 from multnomah-county-it/dev
More README.md updates
2 parents 897e11e + 2700156 commit d651430

1 file changed

Lines changed: 63 additions & 29 deletions

File tree

README.md

Lines changed: 63 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# libsbapi
22

3-
### Custom API for Integration of Shoutbomb with Symphony ###
3+
## Custom API for Integration of Shoutbomb with Symphony
44

55
NOTES: 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

1111
URL: 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

2929
URL: 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

3336
Output:
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

4750
URL: 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

5157
Output:
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

9096
https://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

94103
Output:
95104
```
@@ -131,11 +140,14 @@ Output:
131140
13 - Item is not eligible for renewal as item is on-hold
132141
14 - 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

136145
https://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

140152
Output:
141153
```
@@ -166,7 +178,7 @@ Output:
166178
14 - Item is not eligible for renewal as maximum number renewals for the item has been reached
167179
15 - 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

171183
https://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

191206
https://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

195213
Output:
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

209230
https://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

213237
Output:
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

225249
https://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

229256
Output:
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

245272
https://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

250281
Output:
251282
```
@@ -257,11 +288,14 @@ Output:
257288
0 – Cancel item hold failed
258289
1 – 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

262293
https://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

266300
Output:
267301
```

0 commit comments

Comments
 (0)