Electronic ID cards
:: services/cards module

These methods allow you to access information on ID cards of any type: student's, PhD and staff's. It is also possible to get user info using cards numbers.

Please note that only valid cards are listed.

Methods

card Get information on a given card. (administrative)
user Get information on a user's ID cards.

services/cards/card

Administrative: This method requires a proper Administrative Consumer Key. Contact us to get one.

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: not required
https://usosapi.apeiron.edu.pl/services/cards/card
Get information on a given card - specified by exactly one parameter of the following: contact_chip_uid, contactless_chip_uid, barcode_number.
contact_chip_uid optional Unique ID of integrated circuit card
contactless_chip_uid optional Unique ID of contacless smart card
barcode_number optional Barcode printed on a card
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Token is not required.

Returned value:

A dictionary of selected result fields and their values.

Available fields:

  • user - dictionaries describing the owner of selected card; each dictionary contains fields from primary section in {method_link 'services/users/user'} method,
  • contact_chip_uid - unique ID of integrated circuit card,
  • contactless_chip_uid - unique ID of contacless smart card,
  • barcode_number - barcode printed on a card,
  • type - 'student', 'phd', 'staff',
  • expiration_date - ID card expiration date,
  • date_of_issue - card's date of issue.

services/cards/user

Consumer: required Token: required Scopes: cards SSL: not required
https://usosapi.apeiron.edu.pl/services/cards/user
Get information on a user's ID cards.
format optional

Default value: json

Format in which to return values. See supported output formats.
callback optional Required only if you've chosen jsonp as a return format.
Plus required standard OAuth Consumer signing arguments: oauth_consumer_key, oauth_nonce, oauth_timestamp, oauth_signature, oauth_signature_method, oauth_version. Plus required oauth_token for Token authorization.

Returned value:

Array of dictionaries describing cards of access token issuer; each dictionary contains fields from card method
USOS API ver. 6.5.0.0-7, 40800f97, dirty (2019-10-04)