Tomas Cohen Arazi
a7e46047cf
This patch introduces two functions to the patrons endpoint: - _to_api - _to_model This are in charge of field mappings in order to comply with the guidelines. Koha::REST::V1:Auth is adjusted to handle 'patron_id' as well. 'borrowernumber' handling is kept until the existing endpoints get updated. To test: - Apply the patches - Run: $ kshell k$ prove t/db_dependent/api/v1/*.t => SUCCESS: Tests pass! - Sign off :-D Signed-off-by: Josef Moravec <josef.moravec@gmail.com> Signed-off-by: Nick Clemens <nick@bywatersolutions.com> Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com> Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>
279 lines
9 KiB
JSON
279 lines
9 KiB
JSON
{
|
|
"type": "object",
|
|
"properties": {
|
|
"patron_id": {
|
|
"$ref": "../x-primitives.json#/patron_id"
|
|
},
|
|
"cardnumber": {
|
|
"$ref": "../x-primitives.json#/cardnumber"
|
|
},
|
|
"surname": {
|
|
"$ref": "../x-primitives.json#/surname"
|
|
},
|
|
"firstname": {
|
|
"$ref": "../x-primitives.json#/firstname"
|
|
},
|
|
"title": {
|
|
"type": ["string", "null"],
|
|
"description": "patron's title"
|
|
},
|
|
"other_name": {
|
|
"type": ["string", "null"],
|
|
"description": "any other names associated with the patron"
|
|
},
|
|
"initials": {
|
|
"type": ["string", "null"],
|
|
"description": "initials of the patron"
|
|
},
|
|
"street_number": {
|
|
"type": ["string", "null"],
|
|
"description": "street number of patron's primary address"
|
|
},
|
|
"street_type": {
|
|
"type": ["string", "null"],
|
|
"description": "street type of patron's primary address"
|
|
},
|
|
"address": {
|
|
"type": ["string", "null"],
|
|
"description": "first address line of patron's primary address"
|
|
},
|
|
"address2": {
|
|
"type": ["string", "null"],
|
|
"description": "second address line of patron's primary address"
|
|
},
|
|
"city": {
|
|
"type": ["string", "null"],
|
|
"description": "city or town of patron's primary address"
|
|
},
|
|
"state": {
|
|
"type": ["string", "null"],
|
|
"description": "state or province of patron's primary address"
|
|
},
|
|
"postal_code": {
|
|
"type": ["string", "null"],
|
|
"description": "zip or postal code of patron's primary address"
|
|
},
|
|
"country": {
|
|
"type": ["string", "null"],
|
|
"description": "country of patron's primary address"
|
|
},
|
|
"email": {
|
|
"$ref": "../x-primitives.json#/email"
|
|
},
|
|
"phone": {
|
|
"$ref": "../x-primitives.json#/phone"
|
|
},
|
|
"mobile": {
|
|
"type": ["string", "null"],
|
|
"description": "the other phone number for patron's primary address"
|
|
},
|
|
"fax": {
|
|
"type": ["string", "null"],
|
|
"description": "fax number for patron's primary address"
|
|
},
|
|
"secondary_email": {
|
|
"type": ["string", "null"],
|
|
"description": "secondary email address for patron's primary address"
|
|
},
|
|
"secondary_phone": {
|
|
"type": ["string", "null"],
|
|
"description": "secondary phone number for patron's primary address"
|
|
},
|
|
"altaddress_street_number": {
|
|
"type": ["string", "null"],
|
|
"description": "street number of patron's alternate address"
|
|
},
|
|
"altaddress_street_type": {
|
|
"type": ["string", "null"],
|
|
"description": "street type of patron's alternate address"
|
|
},
|
|
"altaddress_address": {
|
|
"type": ["string", "null"],
|
|
"description": "first address line of patron's alternate address"
|
|
},
|
|
"altaddress_address2": {
|
|
"type": ["string", "null"],
|
|
"description": "second address line of patron's alternate address"
|
|
},
|
|
"altaddress_city": {
|
|
"type": ["string", "null"],
|
|
"description": "city or town of patron's alternate address"
|
|
},
|
|
"altaddress_state": {
|
|
"type": ["string", "null"],
|
|
"description": "state or province of patron's alternate address"
|
|
},
|
|
"altaddress_postal_code": {
|
|
"type": ["string", "null"],
|
|
"description": "zip or postal code of patron's alternate address"
|
|
},
|
|
"altaddress_country": {
|
|
"type": ["string", "null"],
|
|
"description": "country of patron's alternate address"
|
|
},
|
|
"altaddress_email": {
|
|
"type": ["string", "null"],
|
|
"description": "email address for patron's alternate address"
|
|
},
|
|
"altaddress_phone": {
|
|
"type": ["string", "null"],
|
|
"description": "phone number for patron's alternate address"
|
|
},
|
|
"date_of_birth": {
|
|
"type": ["string", "null"],
|
|
"format": "date",
|
|
"description": "patron's date of birth"
|
|
},
|
|
"library_id": {
|
|
"type": "string",
|
|
"description": "Internal identifier for the patron's home library"
|
|
},
|
|
"category_id": {
|
|
"type": "string",
|
|
"description": "Internal identifier for the patron's category"
|
|
},
|
|
"date_enrolled": {
|
|
"type": ["string", "null"],
|
|
"format": "date",
|
|
"description": "date the patron was added to Koha"
|
|
},
|
|
"expiry_date": {
|
|
"type": ["string", "null"],
|
|
"format": "date",
|
|
"description": "date the patron's card is set to expire"
|
|
},
|
|
"date_renewed": {
|
|
"type": ["string", "null"],
|
|
"description": "date the patron's card was last renewed"
|
|
},
|
|
"incorrect_address": {
|
|
"type": ["boolean", "null"],
|
|
"description": "set to 1 if library marked this patron as having an unconfirmed address"
|
|
},
|
|
"patron_card_lost": {
|
|
"type": ["boolean", "null"],
|
|
"description": "set to 1 if library marked this patron as having lost his card"
|
|
},
|
|
"restricted": {
|
|
"type": "boolean",
|
|
"readOnly": true,
|
|
"description": "If any restriction applies to the patron"
|
|
},
|
|
"guarantor_id": {
|
|
"type": ["integer", "null"],
|
|
"description": "patron_id used for children or professionals to link them to guarantor or organizations"
|
|
},
|
|
"staff_notes": {
|
|
"type": ["string", "null"],
|
|
"description": "a note on the patron's account"
|
|
},
|
|
"relationship_type": {
|
|
"type": ["string", "null"],
|
|
"description": "used for children to include the relationship to their guarantor"
|
|
},
|
|
"gender": {
|
|
"type": ["string", "null"],
|
|
"description": "patron's gender"
|
|
},
|
|
"userid": {
|
|
"type": ["string", "null"],
|
|
"description": "patron's login"
|
|
},
|
|
"opac_notes": {
|
|
"type": ["string", "null"],
|
|
"description": "a note on the patron's account visible in OPAC and staff client"
|
|
},
|
|
"altaddress_notes": {
|
|
"type": ["string", "null"],
|
|
"description": "a note related to patron's alternate address"
|
|
},
|
|
"statistics_1": {
|
|
"type": ["string", "null"],
|
|
"description": "a field that can be used for any information unique to the library"
|
|
},
|
|
"statistics_2": {
|
|
"type": ["string", "null"],
|
|
"description": "a field that can be used for any information unique to the library"
|
|
},
|
|
"altcontact_firstname": {
|
|
"type": ["string", "null"],
|
|
"description": "first name of alternate contact for the patron"
|
|
},
|
|
"altcontact_surname": {
|
|
"type": ["string", "null"],
|
|
"description": "surname or last name of the alternate contact for the patron"
|
|
},
|
|
"altcontact_address": {
|
|
"type": ["string", "null"],
|
|
"description": "the first address line for the alternate contact for the patron"
|
|
},
|
|
"altcontact_address2": {
|
|
"type": ["string", "null"],
|
|
"description": "the second address line for the alternate contact for the patron"
|
|
},
|
|
"altcontact_city": {
|
|
"type": ["string", "null"],
|
|
"description": "the city for the alternate contact for the patron"
|
|
},
|
|
"altcontact_state": {
|
|
"type": ["string", "null"],
|
|
"description": "the state for the alternate contact for the patron"
|
|
},
|
|
"altcontact_postal_code": {
|
|
"type": ["string", "null"],
|
|
"description": "the zipcode for the alternate contact for the patron"
|
|
},
|
|
"altcontact_country": {
|
|
"type": ["string", "null"],
|
|
"description": "the country for the alternate contact for the patron"
|
|
},
|
|
"altcontact_phone": {
|
|
"type": ["string", "null"],
|
|
"description": "the phone number for the alternate contact for the patron"
|
|
},
|
|
"sms_number": {
|
|
"type": ["string", "null"],
|
|
"description": "the mobile phone number where the patron would like to receive notices (if SMS turned on)"
|
|
},
|
|
"sms_provider_id": {
|
|
"type": ["integer", "null"],
|
|
"description": "the provider of the mobile phone number defined in smsalertnumber"
|
|
},
|
|
"privacy": {
|
|
"type": "integer",
|
|
"description": "patron's privacy settings related to their reading history"
|
|
},
|
|
"privacy_guarantor_checkouts": {
|
|
"type": "integer",
|
|
"description": "controls if relatives can see this patron's checkouts"
|
|
},
|
|
"check_previous_checkout": {
|
|
"type": "string",
|
|
"description": "produce a warning for this patron if this item has previously been checked out to this patron if 'yes', not if 'no', defer to category setting if 'inherit'"
|
|
},
|
|
"updated_on": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "time of last change could be useful for synchronization with external systems (among others)"
|
|
},
|
|
"last_seen": {
|
|
"type": ["string", "null"],
|
|
"format": "date-time",
|
|
"description": "last time a patron has been seen (connected at the OPAC or staff interface)"
|
|
},
|
|
"lang": {
|
|
"type": "string",
|
|
"description": "lang to use to send notices to this patron"
|
|
},
|
|
"login_attempts": {
|
|
"type": ["integer", "null"],
|
|
"description": "number of failed login attemps"
|
|
},
|
|
"overdrive_auth_token": {
|
|
"type": ["string", "null"],
|
|
"description": "persist OverDrive auth token"
|
|
}
|
|
},
|
|
"additionalProperties": false,
|
|
"required": ["surname", "address", "city", "library_id", "category_id"]
|
|
}
|