Class: SurgeAPI::Resources::PhoneNumbers

Inherits:
Object
  • Object
show all
Defined in:
lib/surge_api/resources/phone_numbers.rb,
sig/surge_api/resources/phone_numbers.rbs

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ PhoneNumbers

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of PhoneNumbers.

Parameters:



122
123
124
 
# File 'lib/surge_api/resources/phone_numbers.rb', line 122

def initialize(client:)
  @client = client
end

Instance Method Details

#list(account_id, after: nil, before: nil, request_options: {}) ⇒ SurgeAPI::Internal::Cursor<SurgeAPI::Models::PhoneNumber>

Some parameter documentations has been truncated, see Models::PhoneNumberListParams for more details.

List all phone numbers for an account with cursor-based pagination.

Parameters:

  • account_id (String) —

    The account ID to list phone numbers for.

  • after (String) —

    Cursor for forward pagination. Use the next_cursor from a previous response.

  • before (String) —

    Cursor for backward pagination. Use the previous_cursor from a previous response

  • request_options (SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/surge_api/resources/phone_numbers.rb', line 50

def list(, params = {})
  parsed, options = SurgeAPI::PhoneNumberListParams.dump_request(params)
  query = SurgeAPI::Internal::Util.encode_query_params(parsed)
  @client.request(
    method: :get,
    path: ["accounts/%1$s/phone_numbers", ],
    query: query,
    page: SurgeAPI::Internal::Cursor,
    model: SurgeAPI::PhoneNumber,
    options: options
  )
end

#purchase(account_id, area_code: nil, latitude: nil, longitude: nil, name: nil, type: nil, request_options: {}) ⇒ SurgeAPI::Models::PhoneNumber

Some parameter documentations has been truncated, see Models::PhoneNumberPurchaseParams for more details.

Purchase a new phone number for the account. You can specify search criteria or let the system select a random number.

Parameters:

  • account_id (String) —

    The account for which the phone number should be created.

  • area_code (String) —

    The desired area code for this phone number. If provided without type, the type

  • latitude (Float) —

    Latitude to search for nearby phone numbers. Must be used with longitude. If pro

  • longitude (Float) —

    Longitude to search for nearby phone numbers. Must be used with latitude. If pro

  • name (String) —

    A human-readable name for the phone number. If not provided, defaults to the for

  • type (Symbol, SurgeAPI::Models::PhoneNumberPurchaseParams::Type) —

    Whether the phone number is local or toll-free. Can be omitted if area_code or l

  • request_options (SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



88
89
90
91
92
93
94
95
96
97
 
# File 'lib/surge_api/resources/phone_numbers.rb', line 88

def purchase(, params = {})
  parsed, options = SurgeAPI::PhoneNumberPurchaseParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["accounts/%1$s/phone_numbers", ],
    body: parsed,
    model: SurgeAPI::PhoneNumber,
    options: options
  )
end

#release(id, request_options: {}) ⇒ SurgeAPI::Models::PhoneNumber

Releases a phone number from the account.

Parameters:

  • id (String) —

    The ID of the phone number to release.

  • request_options (SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



110
111
112
113
114
115
116
117
 
# File 'lib/surge_api/resources/phone_numbers.rb', line 110

def release(id, params = {})
  @client.request(
    method: :delete,
    path: ["phone_numbers/%1$s", id],
    model: SurgeAPI::PhoneNumber,
    options: params[:request_options]
  )
end

#update(id, campaign_id: nil, name: nil, request_options: {}) ⇒ SurgeAPI::Models::PhoneNumber

Updates a phone number's details.

Parameters:

  • id (String) —

    The ID of the phone number to update.

  • campaign_id (String) —

    Campaign ID to attach this number to (cpn_...).

  • name (String) —

    A human-readable name for the phone number.

  • request_options (SurgeAPI::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



21
22
23
24
25
26
27
28
29
30
 
# File 'lib/surge_api/resources/phone_numbers.rb', line 21

def update(id, params = {})
  parsed, options = SurgeAPI::PhoneNumberUpdateParams.dump_request(params)
  @client.request(
    method: :patch,
    path: ["phone_numbers/%1$s", id],
    body: parsed,
    model: SurgeAPI::PhoneNumber,
    options: options
  )
end