Skip to content

Latest commit

 

History

History
187 lines (115 loc) · 7.02 KB

PushNotificationsApi.md

File metadata and controls

187 lines (115 loc) · 7.02 KB

\PushNotificationsApi

All URIs are relative to https://platform.devtest.ringcentral.com

Method HTTP request Description
CreateSubscription Post /restapi/v1.0/subscription Create Subscription
DeleteSubscription Delete /restapi/v1.0/subscription/{subscriptionId} Cancel Subscription
GetSubscriptions Get /restapi/v1.0/subscription Get Subscriptions
LoadSubscription Get /restapi/v1.0/subscription/{subscriptionId} Get Subscription
RenewSubscription Post /restapi/v1.0/subscription/{subscriptionId}/renew Renew Subscription
UpdateSubscription Put /restapi/v1.0/subscription/{subscriptionId} Renew Subscription / Update Event Filters

CreateSubscription

SubscriptionInfo CreateSubscription(ctx, createSubscriptionRequest) Create Subscription

Since 1.0.6 (Release 5.15)

Creates a new subscription.

Usage Plan Group

Medium

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
createSubscriptionRequest CreateSubscriptionRequest JSON body

Return type

SubscriptionInfo

Authorization

OAuth2

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteSubscription

DeleteSubscription(ctx, subscriptionId) Cancel Subscription

Cancels the existent subscription.

Usage Plan Group

Medium

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
subscriptionId string Internal identifier of a subscription

Return type

(empty response body)

Authorization

OAuth2

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetSubscriptions

RecordsCollectionResourceSubscriptionResponse GetSubscriptions(ctx, ) Get Subscriptions

Required Parameters

This endpoint does not need any parameter.

Return type

RecordsCollectionResourceSubscriptionResponse

Authorization

OAuth2

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

LoadSubscription

SubscriptionInfo LoadSubscription(ctx, subscriptionId) Get Subscription

Since 1.0.6 (Release 5.15)

Returns the requested subscription.

Usage Plan Group

Light

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
subscriptionId int32 Internal identifier of a subscription

Return type

SubscriptionInfo

Authorization

OAuth2

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

RenewSubscription

SubscriptionInfo RenewSubscription(ctx, subscriptionId) Renew Subscription

Since 1.0.26 (Release 8.12)

Renews an existent subscription by ID by posting request with an empty body..

Usage Plan Group

Medium

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
subscriptionId string

Return type

SubscriptionInfo

Authorization

OAuth2

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateSubscription

SubscriptionInfo UpdateSubscription(ctx, subscriptionId, modifySubscriptionRequest, optional) Renew Subscription / Update Event Filters

Since 1.0.6 (Release 5.15)

Renews the existent subscription if the request body is empty. If event filters are specified, calling this method modifies the event filters for the existing subscription. The client application can extend or narrow the events for which it receives notifications in the frame of one subscription.

Usage Plan Group

Medium

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
subscriptionId string Internal identifier of a subscription
modifySubscriptionRequest ModifySubscriptionRequest JSON body
optional *UpdateSubscriptionOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a UpdateSubscriptionOpts struct

Name Type Description Notes

aggregated | optional.Bool| If 'True' then aggregated presence status is returned in a notification payload |

Return type

SubscriptionInfo

Authorization

OAuth2

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]