gandi_v5 0.6.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 023623b5d81a2f3acc4a5fee812f0e8ca24dd8735f59a0f12b53ad35ddb7a397
-  data.tar.gz: 3cf89099c45295da9b06a53ad64b601b3a77525a13ddade403d600c382be02d3
+  metadata.gz: cc90c3434cb1207a7eed04d4b2331039f8ac8e32e2861e4d3693b034658eabb1
+  data.tar.gz: 51b125b39d4b4fe71a2fc4f55815bf8c4e5c94a5d7e01bfd9e104be1886a91fa
 SHA512:
-  metadata.gz: 5e816b9de44330c832f6591ca6724b44f5b05c6fab53d8fda6d13a9820211292f29ee608953d8a562da97f4bcfee38f24f799b4a68184bba2b0ec751d21b3f61
-  data.tar.gz: 622bded49d8bae3129ad74fae6fcaf1e8d7c3639b40348b7537e0ba46a3d5c668d2a134754dcf1ff31bcffe3cf0797f5c4368cbc849c386b4648f850d9e24117
+  metadata.gz: 6478500701daaeec1623ce28db9d0568a9971f6087d7d7064d13cded11afa76e24b987e7804b7a88a2b5f3b4aa0496b860352399be8fcd82cdb88b640ba1c5e8
+  data.tar.gz: bd3089b11811fc944acaf7d39798d45a36c5e17a9a5be90d2a90d07270a2ca835e73428f58d641893d79f074b96a7c42671efb1ed2c4c40ca838840a0ee87759

data/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Gandi V5 API Gem Changelog
 
+## Version 0.10.0
+
+* GandiV5::Domain
+  * Add \#transfer_lock(lock = true) and \#transfer_unlock
+  * Add template_id argument to .create
+  * Add \#web_forwardings -> GandiV5::Domain::WebForwarding.list
+  * Add \#new_web_forwarding -> GandiV5::Domain::WebForwarding.create
+* GandiV5::Domain::TransferIn
+  * Add template_id argument to .create
+* GandiV5::Domain::WebForwarding
+* GandiV5::SimpleHosting::Instance::VirtualHost: (I don't use simple hosting myself so it's possible I've misread the docs and a bug is waiting to be found, please add an issue if I have)
+  * Add .create (aliased as GandiV5::SimpleHosting::Instance#create_virtual_host)
+  * Add \#delete
+  * Add \#update
+* GandiV5::Template
+* GandiV5::Template::Dispatch
+* Add testing against truffleruby-20.3.0
+
+## Version 0.9.1
+
+* Add testing against ruby 2.7.2 and 3.0.0
+
+## Version 0.9.0
+
+* Add transferring a domain to Gandi (I don't have any domains outside Gandi to test this myself so it's possible I've misread the docs and a bug is waiting to be found, please add an issue if I have):
+  * GandiV5::Domain::TransferIn:
+    * .create(fqdn, \*\*options)
+    * .fetch(fqdn)
+    * .relaunch(fqdn)
+    * .resend_foa_emails(fqdn, email_address)
+    * \#relaunch
+    * \#resend_foa_emails(email_address)
+  * GandiV5::Domain::TransferIn::Availabillity:
+    * .fetch(fqdn, auth_code = nil)
+* Documentation improvements
+
+## Version 0.8.0
+
+* Domain:
+  * .list - add resellee_id filter
+* Added simple hosting: (I don't use simple hosting myself so it's possible I've misread the docs and a bug is waiting to be found, please add an issue if I have)
+  * SimpleHosting::Instance
+  * SimpleHosting::Instance::VirtualHost
+  * SimpleHosting::Instance::Application
+  * SimpleHosting::Instance::Database
+  * SimpleHosting::Instance::Language
+  * SimpleHosting::Instance::Upgrade
+* GandiV5::Domain::SharingSpace moved to GandiV5::SharingSpace
+
+## Version 0.7.0
+
+* LiveDNS:
+  * Rename LiveDNS::RecordSet to LiveDNS::Domain::Record
+  * Domains:
+    * .list now returns an array of strings
+    * Can no longer change the zone used by a domain
+    * Added automatic_snapshots attribute for whether snapshots are automatically created when a modification is made to this domain's records
+    * \#replace_records and \#replace_records_for merged into \#replace_records
+      * If replacing with a zone file use the new #replace_zone_lines
+    * Added:
+      * .create
+      * .record_types
+      * .generic_name_servers(fqdn)
+      * \#name_servers and #fetch_name_servers
+      * \#tsig_keys, #fetch_tsig_keys, \#add_tsig_key, \#remove_tsig_key
+      * \#axfr_clients, #fetch_axfr_clients, #add_axfr_client, \#remove_axfr_client
+      * ::DnssecKeys, #dnssec_keys, #fetch_dnssec_keys
+  * Snapshots:
+    * Moved to live under LiveDNS::Domain not LiveDNS::Zone
+    * Are now accessed via the fully qualified domain name NOT the zone's UUID
+    * Ability to access the zone from a snapshot is removed
+    * Taking a snapshot now allows for named snapshots
+    * Added automatic attribute for when a snapshot was taken due to a zone change
+    * .list now returns an array of snapshots (records are fetched in a seperate request when first needed)
+  * Zone removed.
+
 ## Version 0.6.0
 
 * GandiV5::Email::Slot.create now supports sharing_id
@@ -39,11 +115,11 @@
 ## Version 0.2.0
 
 * Enhancements to GandiV5::Domain
-  * .availability(fqdn, **options) moved to GandiV5::Domain::Availability.fetch(fqdn, **options)
+  * .availability(fqdn, \*\*options) moved to GandiV5::Domain::Availability.fetch(fqdn, \*\*options)
   * .create now returns created domain (except in dry-run mode)
   * .tlds moved to GandiV5::Domain::TLD.list
   * .tld(name) moved to GandiV5::Domain::TLD.fetch(name)
-  * #renewal_price(currency: 'GBP', period: 1) added
+  * \#renewal_price(currency: 'GBP', period: 1) added
 * Enhancements to GandiV5::Email::Mailbox
   * .create now returns created mailbox
   * .create now checks for available slots and a valid type has been passed
@@ -52,14 +128,14 @@
   * Add #disable to disable the auto responder in Gandi
 * Enhancements to GandiV5::Email::Slot
   * .create now returns created slot
-  * #delete now checks for inactiveness and refundableness
+  * \#delete now checks for inactiveness and refundableness
 * Enhancements to GandiV5::LiveDNS::Domain
   * Add #zone and #fetch_zone
-  * Remove #replace_*_records_for methods
+  * Remove #replace_\*_records_for methods
   * Changes to #replace_records_for to allow calling with name, type, ttl and values. When calling with name and fecords records MUST be passed as an array.
 * Enhancements to GandiV5::LiveDNS::Zone
   * .create now returns created zone
-  * Remove #replace_*_records_for methods
+  * Remove #replace_\*_records_for methods
   * Changes to #replace_records_for to allow calling with name, type, ttl and values. When calling with name and fecords records MUST be passed as an array.
 * Enhancements to GandiV5::LiveDNS::Zone::Snapshot
   * Add .list

data/README.md

@@ -1,18 +1,21 @@
 [![Gem Version](https://badge.fury.io/rb/gandi_v5.png)](http://badge.fury.io/rb/gandi_v5)
-[![Build Status](https://secure.travis-ci.org/robertgauld/gandi_v5.png?branch=master)](http://travis-ci.org/robertgauld/gandi_v5)
-[![Coveralls Status](https://coveralls.io/repos/robertgauld/gandi_v5/badge.png?branch=master)](https://coveralls.io/r/robertgauld/gandi_v5)
-[![Code Climate](https://codeclimate.com/github/robertgauld/gandi_v5.png?branch=master)](https://codeclimate.com/github/robertgauld/gandi_v5)
-[![security](https://hakiri.io/github/robertgauld/gandi_v5/master.svg)](https://hakiri.io/github/robertgauld/gandi_v5/master)
+[![Commit Checks](https://github.com/robertgauld/gandi_v5/workflows/Commit%20Checks/badge.svg)](https://github.com/robertgauld/gandi_v5/actions?query=workflow%3A%22Commit+Checks%22)
+[![Coveralls Status](https://coveralls.io/repos/robertgauld/gandi_v5/badge.png?branch=main)](https://coveralls.io/r/robertgauld/gandi_v5)
+[![Code Climate](https://codeclimate.com/github/robertgauld/gandi_v5.png?branch=main)](https://codeclimate.com/github/robertgauld/gandi_v5)
 
 ## Ruby Versions
 This gem supports the following versions of ruby, it may work on other versions but is not tested against them so don't rely on it.
 
 * ruby:
   * 2.6.0 - 2.6.6
-  * 2.7.0 - 2.7.1
-  * truffleruby 20.1.0
-* jruby, once it's reached parity with ruby 2.6.x
-* rubinius, once it's reached parity with ruby 2.6.x
+  * 2.7.0 - 2.7.2
+  * 3.0.0
+  * truffleruby 20.1.0 - 20.3.0
+
+This gem doesn't yet support the following versions of ruby, although hopefully it soon will.
+
+* jruby - not yet at parity with ruby 2.6.x
+* rubinius - not yet at parity with ruby 2.6.x
 
 
 ## Gandi V5
@@ -25,23 +28,24 @@ Gandi say: **_"Please note that this API is currently in BETA testing, so care s
 
 But then you were going to be careful anyway as this gem is currently in the version 0.something range weren't you!
 
-Details of the API can be found at:
+Details of Gandi's API can be found at:
 
 * <https://api.gandi.net/docs/>
 * <https://doc.livedns.gandi.net/>
 
+Details of the gem's API can be found at <https://rubydoc.info/github/robertgauld/gandi_v5/main>
 
 ## Installation
 
 If you're using bundler then add it to your Gemfile and run the bundle command.
 
 ```ruby
-gem 'gandi_v5', '~> 0.1'
+gem 'gandi_v5', '~> 0.10'
 ```
 
 If you're not using bundler then install it from the command line.
 ```bash
-gem install gandi_v5 -v '~> 0.1'
+gem install gandi_v5 -v '~> 0.10'
 ```
 
 ## Usage
@@ -58,6 +62,52 @@ GandiV5.api_key = '…' # Unless you've set it in the environment variable GANDI
 
 ### Examples
 
+#### List renewal dates and costs for all domains
+```ruby
+# For each domain (sorted by assending renewal date) print <date>\t<cost>\t<fqdn>
+GandiV5::Domain.list.each do |domain|
+  puts [
+    domain.dates.registry_ends_at.to_date,
+    "£#{domain.renewal_price.price_after_taxes}",
+    domain.fqdn
+  ].join("\t")
+end
+```
+
+#### List email addresses for all domains
+
+```ruby
+# For each domain:
+#   1. Create an empty hash to store address => description
+#   2. Get the mailboxes and add them to the hash
+#   3. Get the forwards and add them to the hash
+#   4. Sort the hash by email address
+#   5. Print the list
+GandiV5::Domain.list.each do |domain|
+  emails = {}
+
+  mailboxes = GandiV5::Email::Mailbox.list(domain.fqdn)
+  mailboxes.each do |mailbox|
+    mailbox.refresh
+    emails["#{mailbox.login}@#{domain.fqdn}"] = "#{mailbox.type} mailbox " \
+                                         "(#{mailbox.quota_usage.to_i}% " \
+                                         "of #{(mailbox.quota / 1024**3).round}GB used)"
+    mailbox.aliases.each do |alias_name|
+      emails["#{alias_name}@#{domain.fqdn}"] = "alias for #{mailbox.login}@#{domain.fqdn}"
+    end
+  end
+
+  forwards = GandiV5::Email::Forward.list(domain.fqdn)
+  forwards.each do |forward|
+    emails["#{forward.source}@#{domain.fqdn}"] = "forwards to #{forward.destinations.join(', ')}"
+  end
+
+  emails.sort.each do |address, text|
+    puts "#{address}\t#{text}"
+  end
+end
+```
+
 #### Domains
 
 ```ruby
@@ -68,15 +118,16 @@ domains = GandiV5.domains
 domains.map!(&:refresh)
 ```
 
-TODO: More examples!
-
-
 ## Versioning
 
 We follow the [Semantic Versioning](http://semver.org/) concept.
 
 | Gem Version     | Gandi API Release Date   |
 | --------------- | ------------------------ |
+| 0.10.0          | 2020-12-10               |
+| 0.9.0           | 2020-07-29               |
+| 0.8.0           | 2020-07-10               |
+| 0.7.0           | 2020-05-07               |
 | 0.6.0           | 2020-05-07 (not LiveDNS) |
 | 0.5.0           | 2019-10-01               |
 | 0.4.0           | 2019-10-01               |

data/lib/gandi_v5.rb

@@ -5,14 +5,17 @@ require 'securerandom'
 require 'zeitwerk'
 
 # Custom inflector for Zeitwerk.
+# @api private
 class MyInflector < Zeitwerk::Inflector
   # Convert file's base name to class name when
   # Zeitwerk's included inflector gets it wrong.
   # @param basename [String] the file's base name (no path or extension)
-  # @param abspath [String] the file's absolute path
+  # @param _abspath [String] the file's absolute path
   # @return [String] the class name
   def camelize(basename, _abspath)
     case basename
+    when 'dns_record'
+      'DNSRecord'
     when 'live_dns'
       'LiveDNS'
     when 'tld'
@@ -31,32 +34,37 @@ loader.setup
 
 # Namespace for classes which access the Gandi V5 API.
 # Also provides useful methods and constants for them.
-# This is where you configure the gem:
-#  * Setting your Gandi API key:
-#    1. Get your API key - Login to Gandi and visit User Settings ->
-#       Change password & configure access restrictions.
+# To get your API key login to Gandi and visit
+# "User Settings" -> "Change password & configure access restrictions".
+# Set your API key either in the GANDI_API_KEY environment variable or
+# by setting the api_key class attribute.
 # @see https://api.gandi.net/docs/
 # @see https://doc.livedns.gandi.net/
 # @!attribute [w] api_key
 #   @return [String]
 class GandiV5
+  # Base URL for all API requests.
   BASE = 'https://api.gandi.net/v5/'
 
+  # Get information on a domain.
   # @see GandiV5::Domain.fetch
   def self.domain(fqdn)
     GandiV5::Domain.fetch(fqdn)
   end
 
+  # Get information on all domains.
   # @see GandiV5::Domain.list
   def self.domains(**params)
     GandiV5::Domain.list(**params)
   end
 
+  # List mailboxes for a domain.
   # @see GandiV5::Email::Mailbox.list
   def self.mailboxes(fqdn, **params)
     GandiV5::Email::Mailbox.list(fqdn, **params)
   end
 
+  # List email slots for a domain.
   # @see GandiV5::Email::Slot.list
   def self.mailbox_slots(fqdn)
     GandiV5::Email::Slot.list(fqdn)
@@ -65,15 +73,21 @@ class GandiV5
   class << self
     attr_writer :api_key
 
-    # Might raise:
-    #  * RestClient::NotFound
-    #  * RestClient::Unauthorized
-    #      Bad authentication attempt because of a wrong API Key.
-    #  * RestClient::Forbidden
-    #      Access to the resource is denied.
-    #      Mainly due to a lack of permissions to access it.
-    #  * GandiV5::Error
-    #  * JSON::ParserError
+    # Make a GET request to a Gandi end point.
+    # @param url [String, #to_s]
+    #   the full URL (including GandiV5::BASE) to fetch.
+    # @param headers [Hash{String, Symbol, #to_s => String, Symbol, #to_s}]
+    #   the headers to send in the request, the authorisation will be added.
+    # @return [Array<(RestClient::Response, Object)>]
+    #   The response from the server and the result of parsing the responce's body.
+    # @raise [RestClient::NotFound]
+    # @raise [RestClient::Unauthorized]
+    #   Bad authentication attempt because of a wrong API Key.
+    # @raise [RestClient::Forbidden]
+    #   Access to the resource is denied.
+    #   Mainly due to a lack of permissions to access it.
+    # @raise [GandiV5::Error]
+    # @raise [JSON::ParserError]
     def get(url, **headers)
       prepare_headers headers, url
       response = RestClient.get url, **headers
@@ -82,16 +96,59 @@ class GandiV5
       handle_bad_request(e)
     end
 
-    # Might raise:
-    #  * RestClient::NotFound
-    #  * RestClient::Unauthorized
-    #      Bad authentication attempt because of a wrong API Key.
-    #  * RestClient::Forbidden
-    #      Access to the resource is denied.
-    #      Mainly due to a lack of permissions to access it.
-    #  * RestClient::Conflict
-    #  * GandiV5::Error
-    #  * JSON::ParserError
+    # Make a GET request to a paginated end point at Gandi.
+    # @param url [String, #to_s]
+    #   the full URL (including GandiV5::BASE) to fetch.
+    # @param page [#each, Integer] the page/pages of results to get.
+    # @param per_page [Integer, #to_s] the number of items to get per page of results.
+    # @param headers [Hash{String, Symbol, #to_s => String, Symbol, #to_s}]
+    #   the headers to send in the request, the authorisation will be added.
+    # @return [Array<(RestClient::Response, Object)>]
+    #   The response from the server and the result of parsing the responce's body.
+    # @raise [RestClient::NotFound]
+    # @raise [RestClient::Unauthorized]
+    #   Bad authentication attempt because of a wrong API Key.
+    # @raise [RestClient::Forbidden]
+    #   Access to the resource is denied.
+    #   Mainly due to a lack of permissions to access it.
+    # @raise [GandiV5::Error]
+    # @raise [JSON::ParserError]
+    def paginated_get(url, page = (1..), per_page = 100, **headers)
+      unless page.respond_to?(:each)
+        fail ArgumentError, 'page must be positive' unless page.positive?
+
+        page = [page]
+      end
+
+      headers[:params] ||= {}
+      headers[:params].transform_keys!(&:to_s)
+      headers[:params]['per_page'] = per_page
+
+      page.each do |page_number|
+        headers[:params]['page'] = page_number
+        _resp, this_data = get(url, **headers)
+        break if this_data.empty?
+
+        yield this_data
+        break if this_data.count < per_page
+      end
+    end
+
+    # Make a DELETE request to a Gandi end point.
+    # @param url [String, #to_s]
+    #   the full URL (including GandiV5::BASE) to fetch.
+    # @param headers [Hash{String, Symbol, #to_s => String, Symbol, #to_s}]
+    #   the headers to send in the request, the authorisation will be added.
+    # @return [Array<(RestClient::Response, Object)>]
+    #   The response from the server and the result of parsing the responce's body.
+    # @raise [RestClient::NotFound]
+    # @raise [RestClient::Unauthorized]
+    #   Bad authentication attempt because of a wrong API Key.
+    # @raise [RestClient::Forbidden]
+    #   Access to the resource is denied.
+    #   Mainly due to a lack of permissions to access it.
+    # @raise [GandiV5::Error]
+    # @raise [JSON::ParserError]
     def delete(url, **headers)
       prepare_headers headers, url
       response = RestClient.delete url, **headers
@@ -103,17 +160,24 @@ class GandiV5
       handle_bad_request(e)
     end
 
-    # Might raise:
-    #  * RestClient::NotFound
-    #  * RestClient::Unauthorized
-    #      Bad authentication attempt because of a wrong API Key.
-    #  * RestClient::Forbidden
-    #      Access to the resource is denied.
-    #      Mainly due to a lack of permissions to access it.
-    #  * RestClient::BadRequest
-    #  * RestClient::Conflict
-    #  * GandiV5::Error
-    #  * JSON::ParserError
+    # Make a PATCH request to a Gandi end point.
+    # @param url [String, #to_s]
+    #   the full URL (including GandiV5::BASE) to fetch.
+    # @param payload [String, #to_s] the body for the request.
+    # @param headers [Hash{String, Symbol, #to_s => String, Symbol, #to_s}]
+    #   the headers to send in the request, the authorisation will be added.
+    # @return [Array<(RestClient::Response, Object)>]
+    #   The response from the server and the result of parsing the responce's body.
+    # @raise [RestClient::NotFound]
+    # @raise [RestClient::Unauthorized]
+    #   Bad authentication attempt because of a wrong API Key.
+    # @raise [RestClient::Forbidden]
+    #   Access to the resource is denied.
+    #   Mainly due to a lack of permissions to access it.
+    # @raise [RestClient::BadRequest]
+    # @raise [RestClient::Conflict]
+    # @raise [GandiV5::Error]
+    # @raise [JSON::ParserError]
     def patch(url, payload = '', **headers)
       prepare_headers headers, url
       headers[:'content-type'] ||= 'application/json'
@@ -123,17 +187,24 @@ class GandiV5
       handle_bad_request(e)
     end
 
-    # Might raise:
-    #  * RestClient::NotFound
-    #  * RestClient::Unauthorized
-    #      Bad authentication attempt because of a wrong API Key.
-    #  * RestClient::Forbidden
-    #      Access to the resource is denied.
-    #      Mainly due to a lack of permissions to access it.
-    #  * RestClient::BadRequest
-    #  * RestClient::Conflict
-    #  * GandiV5::Error
-    #  * JSON::ParserError
+    # Make a POST request to a Gandi end point.
+    # @param url [String, #to_s]
+    #   the full URL (including GandiV5::BASE) to fetch.
+    # @param payload [String, #to_s] the body for the request.
+    # @param headers [Hash{String, Symbol, #to_s => String, Symbol, #to_s}]
+    #   the headers to send in the request, the authorisation will be added.
+    # @return [Array<(RestClient::Response, Object)>]
+    #   The response from the server and the result of parsing the responce's body.
+    # @raise [RestClient::NotFound]
+    # @raise [RestClient::Unauthorized]
+    #   Bad authentication attempt because of a wrong API Key.
+    # @raise [RestClient::Forbidden]
+    #   Access to the resource is denied.
+    #   Mainly due to a lack of permissions to access it.
+    # @raise [RestClient::BadRequest]
+    # @raise [RestClient::Conflict]
+    # @raise [GandiV5::Error]
+    # @raise [JSON::ParserError]
     def post(url, payload = '', **headers)
       prepare_headers headers, url
       headers[:'content-type'] ||= 'application/json'
@@ -143,17 +214,24 @@ class GandiV5
       handle_bad_request(e)
     end
 
-    # Might raise:
-    #  * RestClient::NotFound
-    #  * RestClient::Unauthorized
-    #      Bad authentication attempt because of a wrong API Key.
-    #  * RestClient::Forbidden
-    #      Access to the resource is denied.
-    #      Mainly due to a lack of permissions to access it.
-    #  * RestClient::BadRequest
-    #  * RestClient::Conflict
-    #  * GandiV5::Error
-    #  * JSON::ParserError
+    # Make a PUT request to a Gandi end point.
+    # @param url [String, #to_s]
+    #   the full URL (including GandiV5::BASE) to fetch.
+    # @param payload [String, #to_s] the body for the request.
+    # @param headers [Hash{String, Symbol, #to_s => String, Symbol, #to_s}]
+    #   the headers to send in the request, the authorisation will be added
+    # @return [Array<(RestClient::Response, Object)>]
+    #   The response from the server and the result of parsing the responce's body.
+    # @raise [RestClient::NotFound]
+    # @raise [RestClient::Unauthorized]
+    #   Bad authentication attempt because of a wrong API Key.
+    # @raise [RestClient::Forbidden]
+    #   Access to the resource is denied.
+    #   Mainly due to a lack of permissions to access it.
+    # @raise [RestClient::BadRequest]
+    # @raise [RestClient::Conflict]
+    # @raise [GandiV5::Error]
+    # @raise [JSON::ParserError]
     def put(url, payload = '', **headers)
       prepare_headers headers, url
       headers[:'content-type'] ||= 'application/json'
@@ -169,16 +247,6 @@ class GandiV5
       @api_key ||= ENV.fetch('GANDI_API_KEY')
     end
 
-    def authorisation_header(url)
-      if url.start_with?(BASE)
-        { Authorization: "Apikey #{api_key}" }
-      elsif url.start_with?(GandiV5::LiveDNS::BASE)
-        { 'X-Api-Key': api_key }
-      else
-        fail ArgumentError, "Don't know how to authorise for url: #{url}"
-      end
-    end
-
     def parse_response(response)
       type = response.headers.fetch(:content_type).split(';').first.chomp
       case type
@@ -196,10 +264,11 @@ class GandiV5
       end
     end
 
-    def prepare_headers(headers, url)
-      headers.transform_keys!(&:to_sym)
+    def prepare_headers(headers, _url)
+      headers.transform_keys! { |key| key.to_s.downcase.to_sym }
       headers[:accept] ||= 'application/json'
-      headers.merge!(authorisation_header(url))
+      headers[:authorization] = "Apikey #{api_key}"
+      headers
     end
 
     def handle_bad_request(exception)