Student internships
:: services/internships module

These API methods provide helpers for manipulating some data about student internships.

Methods

create_company BETA Create a new company. (administrative)
update_company BETA Update an existing company. (administrative)

services/internships/create_company

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

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: required
URLs of the methods are hidden, because this installation is the mother server.
Click here for the list of all public USOS API installations.

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Create database records for company.
name_pl required Company name in Polish
country required Country part of the address
name_en optional Company name in English
nip optional Polish tax number
parent_company_id optional ID of parent company
www optional WWW address
email optional E-mail address
street optional Street part of the address
building_number optional Building number part of the address
apartment_number optional Apartment number part of the address
postal_code optional Postal code part of the address
foreign_postal_code optional Foreign postal code part of the address
city optional City part of the address
phone_number optional Telephone number
fac_id optional ID of the faculty of the internship
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 the following structure:

  • company_id - ID of the created company.

Thrown errors:

  • object_invalid - object is in invalid state.

    Possible reasons:

    • company_already_exists - the company already exists.

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • parent_company_not_found - the parent company was not found.

services/internships/update_company

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

Consumer: required (administrative) Token: ignored Scopes: n/a SSL: required
URLs of the methods are hidden, because this installation is the mother server.
Click here for the list of all public USOS API installations.

This is a BETA method. We're looking for beta-testers. Until we find them, there's a substantial probability it won't stay backwards-compatible! If you are planning on using this method, please let us know. Then, we will work with you and move it out of beta as soon as we can.

Update database records for company.
company_id required ID of the company
name_pl optional Company name in Polish
name_en optional Company name in English
nip optional Polish tax number
parent_company_id optional ID of parent company
www optional WWW address
email optional E-mail address
street optional Street part of the address
building_number optional Building number part of the address
apartment_number optional Apartment number part of the address
postal_code optional Postal code part of the address
foreign_postal_code optional Foreign postal code part of the address
city optional City part of the address
country optional Country part of the address
phone_number optional Telephone number
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:

Empty dict on success.

Thrown errors:

  • object_not_found - some of the referenced objects do not exist.

    Possible reasons:

    • company_not_found - the company was not found.
USOS API ver. mother-1, 83b82554, dirty (2020-12-21)