dolibarr 21.0.0-alpha
Subscriptions Class Reference
Inheritance diagram for Subscriptions:
Collaboration diagram for Subscriptions:

Public Member Functions

 __construct ()
 Constructor.
 
 get ($id)
 Get properties of a subscription object.
 
 index ($sortfield="dateadh", $sortorder='ASC', $limit=100, $page=0, $sqlfilters='', $properties='', $pagination_data=false)
 List subscriptions.
 
 post ($request_data=null)
 Create subscription object.
 
 put ($id, $request_data=null)
 Update subscription.
 
 delete ($id)
 Delete subscription.
 
- Public Member Functions inherited from DolibarrApi
 __construct ($db, $cachedir='', $refreshCache=false)
 Constructor.
 

Private Member Functions

 _validate ($data)
 Validate fields before creating an object.
 

Additional Inherited Members

- Protected Member Functions inherited from DolibarrApi
 _checkValForAPI ($field, $value, $object)
 Check and convert a string depending on its type/name.
 
 _filterObjectProperties ($object, $properties)
 Filter properties that will be returned on object.
 
 _cleanObjectDatas ($object)
 Clean sensitive object data @phpstan-template T of Object.
 
 _checkFilters ($sqlfilters, &$error='')
 Return if a $sqlfilters parameter is valid Function no more used.
 
- Static Protected Member Functions inherited from DolibarrApi
static _checkAccessToResource ($resource, $resource_id=0, $dbtablename='', $feature2='', $dbt_keyfield='fk_soc', $dbt_select='rowid')
 Check access by user to a given resource.
 
static _forge_criteria_callback ($matches)
 Function to forge a SQL criteria from a Generic filter string.
 

Detailed Description

Definition at line 29 of file api_subscriptions.class.php.

Member Function Documentation

◆ _validate()

Subscriptions::_validate ( $data)
private

Validate fields before creating an object.

Parameters
?array<null|int|float|string>$data Data to validate
Returns
array<string,null|int|float|string>
Exceptions
RestException

Definition at line 295 of file api_subscriptions.class.php.

Referenced by post().

◆ delete()

Subscriptions::delete ( $id)

Delete subscription.

Parameters
int$idID of subscription to delete
Returns
array @phan-return array<string,array{code:int,message:string}> @phpstan-return array<string,array{code:int,message:string}>
Exceptions
RestException403 Access denied
RestException404 No Subscription found
RestException409 No Subscription deleted
RestException500 Error when deleting Subscription

Definition at line 260 of file api_subscriptions.class.php.

References $id.

◆ get()

Subscriptions::get ( $id)

Get properties of a subscription object.

Return an array with subscription information

Parameters
int$idID of subscription
Returns
Object Object with cleaned properties
Exceptions
RestException403 Access denied
RestException404 No Subscription found

Definition at line 61 of file api_subscriptions.class.php.

References $id, and DolibarrApi\_cleanObjectDatas().

◆ index()

Subscriptions::index ( $sortfield = "dateadh",
$sortorder = 'ASC',
$limit = 100,
$page = 0,
$sqlfilters = '',
$properties = '',
$pagination_data = false )

List subscriptions.

Get a list of subscriptions

Parameters
string$sortfieldSort field
string$sortorderSort order
int$limitLimit for list
int$pagePage number
string$sqlfiltersOther criteria to filter answers separated by a comma. Syntax example "(t.ref:like:'SO-%') and (t.import_key:<:'20160101')"
string$propertiesRestrict the data returned to these properties. Ignored if empty. Comma separated list of properties names
bool$pagination_dataIf this parameter is set to true the response will include pagination data. Default value is false. Page starts from 0*
Returns
array Array of subscription objects @phan-return array{data:Subscription[],pagination:array{total:int,page:int,page_count:int,limit:int}}|array<int,Subscription> @phpstan-return array{data:Subscription[],pagination:array{total:int,page:int,page_count:int,limit:int}}|array<int,Subscription>
Exceptions
RestException403 Access denied
RestException404 No Subscription found
RestException503 Error when retrieving Subscription list

Definition at line 96 of file api_subscriptions.class.php.

References DolibarrApi\_cleanObjectDatas(), DolibarrApi\_filterObjectProperties(), and forgeSQLFromUniversalSearchCriteria().

◆ post()

Subscriptions::post ( $request_data = null)

Create subscription object.

Parameters
array$request_dataRequest data @phan-param array<string,string> $request_data @phpstan-param array<string,string> $request_data
Returns
int ID of subscription
Exceptions
RestException403 Access denied
RestException500 Error when creating Subscription

Definition at line 178 of file api_subscriptions.class.php.

References DolibarrApi\_checkValForAPI(), _validate(), and sanitizeVal().

◆ put()

Subscriptions::put ( $id,
$request_data = null )

Update subscription.

Parameters
int$idID of subscription to update
array$request_dataData @phan-param array<string,string> $request_data @phpstan-param array<string,string> $request_data
Returns
Object Updated object
Exceptions
RestException403 Access denied
RestException404 No Subscription found
RestException500 Error when updating Subscription

Definition at line 215 of file api_subscriptions.class.php.

References $id, DolibarrApi\_checkValForAPI(), and sanitizeVal().


The documentation for this class was generated from the following file: