Access and signing PW statements
:: services/pw_statements module

These API methods allow you to check and sign statements according to PW procedures.

Methods

can_edit_declaration returns information if a user can edit the (declaration) on a statement. (administrative)
declare Save user decision (declaration) on statement. (administrative)
statement returns information about a statement. (administrative)
statements Get a list of user statements. (administrative)

services/pw_statements/can_edit_declaration

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

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: required
https://apps.usos.pw.edu.pl/services/pw_statements/can_edit_declaration

returns information if a user can edit the (declaration) on a statement.

declaration_id required ID of declaration
user_id required ID of a user
fields optional

Default value: id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

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 JSON object with result field.

services/pw_statements/declare

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

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: required
https://apps.usos.pw.edu.pl/services/pw_statements/declare

Save user decision (declaration) on statement.

declaration_id required ID of declaration
accepted required

Possible values:

  • true - accepted ('A')
  • false - rejected ('O')
  • clear - clear current selection ('X')

fields optional

Default value: result

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

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:

result: Success or Failure

services/pw_statements/statement

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

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: required
https://apps.usos.pw.edu.pl/services/pw_statements/statement

returns information about a statement.

statement_id required ID of the auhtore decision of a statement from PW_POTWIERDZENIA_... or from id of decision DZ_ tables when source_pw=false
source_pw optional get the statement from PW_ tables or global USOS (DZ_)
fields optional

Default value: id|code|title_pl|title_en|content_pl|content_en|org_unit_code|can_be_rejected|context|effect_start_date|effect_end_date

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

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 JSON object with result field.

services/pw_statements/statements

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

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: required
https://apps.usos.pw.edu.pl/services/pw_statements/statements

Get a list of user statements.

user_id required ID of user
fields optional

Default value: decision_deadline|decision_date|effect_end_date|the_decision|decision_code|title_pl|title_en|org_unit_code|content_pl|content_en|study_code|study_prog_description_pl|study_prog_description_en|is_pw|statement_id|declaration_id|user_id

Selector of result fields you are interested in. The selector may contain any subset of fields, which are described in the returns section.

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 list of objects. Each element with contain data about a statement.

USOS API ver. 6.8.0.0-5, 56083cef, dirty (2022-12-14)