context.dev 2.14.0 → 2.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +21 -0
  3. data/README.md +2 -2
  4. data/lib/context_dev/client.rb +10 -0
  5. data/lib/context_dev/internal/type/base_model.rb +2 -2
  6. data/lib/context_dev/models/ai_extract_product_response.rb +17 -10
  7. data/lib/context_dev/models/ai_extract_products_response.rb +17 -10
  8. data/lib/context_dev/models/batch_cancel_response.rb +14 -5
  9. data/lib/context_dev/models/batch_delete_response.rb +17 -10
  10. data/lib/context_dev/models/batch_get_results_response.rb +17 -10
  11. data/lib/context_dev/models/batch_list_response.rb +17 -10
  12. data/lib/context_dev/models/batch_retrieve_response.rb +22 -5
  13. data/lib/context_dev/models/batch_submit_params.rb +34 -3
  14. data/lib/context_dev/models/batch_submit_response.rb +14 -5
  15. data/lib/context_dev/models/brand_retrieve_response.rb +17 -10
  16. data/lib/context_dev/models/brand_retrieve_simplified_params.rb +3 -4
  17. data/lib/context_dev/models/brand_retrieve_simplified_response.rb +17 -10
  18. data/lib/context_dev/models/brand_search_params.rb +3 -4
  19. data/lib/context_dev/models/brand_search_response.rb +17 -10
  20. data/lib/context_dev/models/industry_retrieve_naics_params.rb +3 -4
  21. data/lib/context_dev/models/industry_retrieve_naics_response.rb +17 -10
  22. data/lib/context_dev/models/industry_retrieve_sic_params.rb +3 -4
  23. data/lib/context_dev/models/industry_retrieve_sic_response.rb +17 -10
  24. data/lib/context_dev/models/log_list_params.rb +108 -0
  25. data/lib/context_dev/models/log_list_response.rb +174 -0
  26. data/lib/context_dev/models/log_retrieve_params.rb +22 -0
  27. data/lib/context_dev/models/log_retrieve_response.rb +226 -0
  28. data/lib/context_dev/models/monitor_create_params.rb +9 -1
  29. data/lib/context_dev/models/monitor_create_response.rb +9 -1
  30. data/lib/context_dev/models/monitor_list_account_runs_response.rb +9 -1
  31. data/lib/context_dev/models/monitor_list_response.rb +9 -1
  32. data/lib/context_dev/models/monitor_list_runs_response.rb +9 -1
  33. data/lib/context_dev/models/monitor_retrieve_response.rb +9 -1
  34. data/lib/context_dev/models/monitor_update_params.rb +9 -1
  35. data/lib/context_dev/models/monitor_update_response.rb +9 -1
  36. data/lib/context_dev/models/news_search_response.rb +17 -10
  37. data/lib/context_dev/models/parse_handle_params.rb +3 -4
  38. data/lib/context_dev/models/parse_handle_response.rb +17 -10
  39. data/lib/context_dev/models/person_enrich_response.rb +17 -10
  40. data/lib/context_dev/models/retry_config.rb +22 -0
  41. data/lib/context_dev/models/utility_prefetch_response.rb +17 -10
  42. data/lib/context_dev/models/web_extract_competitors_params.rb +3 -4
  43. data/lib/context_dev/models/web_extract_competitors_response.rb +17 -10
  44. data/lib/context_dev/models/web_extract_fonts_params.rb +3 -4
  45. data/lib/context_dev/models/web_extract_fonts_response.rb +17 -10
  46. data/lib/context_dev/models/web_extract_response.rb +17 -10
  47. data/lib/context_dev/models/web_extract_styleguide_params.rb +3 -4
  48. data/lib/context_dev/models/web_extract_styleguide_response.rb +17 -10
  49. data/lib/context_dev/models/web_screenshot_params.rb +5 -5
  50. data/lib/context_dev/models/web_screenshot_response.rb +17 -10
  51. data/lib/context_dev/models/web_search_response.rb +17 -10
  52. data/lib/context_dev/models/web_web_crawl_md_response.rb +17 -10
  53. data/lib/context_dev/models/web_web_scrape_html_params.rb +6 -5
  54. data/lib/context_dev/models/web_web_scrape_html_response.rb +17 -10
  55. data/lib/context_dev/models/web_web_scrape_images_params.rb +6 -5
  56. data/lib/context_dev/models/web_web_scrape_images_response.rb +17 -10
  57. data/lib/context_dev/models/web_web_scrape_md_params.rb +6 -5
  58. data/lib/context_dev/models/web_web_scrape_md_response.rb +17 -10
  59. data/lib/context_dev/models/web_web_scrape_sitemap_params.rb +3 -4
  60. data/lib/context_dev/models/web_web_scrape_sitemap_response.rb +17 -10
  61. data/lib/context_dev/models/webhook_delivery.rb +9 -1
  62. data/lib/context_dev/models/webhooks/attempt.rb +102 -0
  63. data/lib/context_dev/models/webhooks/delivery.rb +253 -0
  64. data/lib/context_dev/models/webhooks/delivery_list_attempts_params.rb +52 -0
  65. data/lib/context_dev/models/webhooks/delivery_list_attempts_response.rb +77 -0
  66. data/lib/context_dev/models/webhooks/delivery_list_params.rb +195 -0
  67. data/lib/context_dev/models/webhooks/delivery_list_response.rb +77 -0
  68. data/lib/context_dev/models/webhooks/delivery_retrieve_params.rb +36 -0
  69. data/lib/context_dev/models/webhooks/delivery_retrieve_response.rb +52 -0
  70. data/lib/context_dev/models/webhooks/delivery_retry_params.rb +48 -0
  71. data/lib/context_dev/models/webhooks/delivery_retry_response.rb +61 -0
  72. data/lib/context_dev/models/webhooks/delivery_summary.rb +229 -0
  73. data/lib/context_dev/models.rb +8 -0
  74. data/lib/context_dev/resources/batch.rb +4 -2
  75. data/lib/context_dev/resources/brand.rb +2 -2
  76. data/lib/context_dev/resources/industry.rb +2 -2
  77. data/lib/context_dev/resources/logs.rb +83 -0
  78. data/lib/context_dev/resources/parse.rb +1 -1
  79. data/lib/context_dev/resources/web.rb +8 -8
  80. data/lib/context_dev/resources/webhooks/deliveries.rb +131 -0
  81. data/lib/context_dev/resources/webhooks.rb +19 -0
  82. data/lib/context_dev/version.rb +1 -1
  83. data/lib/context_dev.rb +19 -0
  84. data/rbi/context_dev/client.rbi +8 -0
  85. data/rbi/context_dev/models/ai_extract_product_response.rbi +17 -10
  86. data/rbi/context_dev/models/ai_extract_products_response.rbi +17 -10
  87. data/rbi/context_dev/models/batch_cancel_response.rbi +14 -4
  88. data/rbi/context_dev/models/batch_delete_response.rbi +17 -10
  89. data/rbi/context_dev/models/batch_get_results_response.rbi +17 -10
  90. data/rbi/context_dev/models/batch_list_response.rbi +17 -10
  91. data/rbi/context_dev/models/batch_retrieve_response.rbi +29 -7
  92. data/rbi/context_dev/models/batch_submit_params.rbi +59 -2
  93. data/rbi/context_dev/models/batch_submit_response.rbi +14 -4
  94. data/rbi/context_dev/models/brand_retrieve_response.rbi +17 -10
  95. data/rbi/context_dev/models/brand_retrieve_simplified_params.rbi +4 -6
  96. data/rbi/context_dev/models/brand_retrieve_simplified_response.rbi +17 -10
  97. data/rbi/context_dev/models/brand_search_params.rbi +4 -6
  98. data/rbi/context_dev/models/brand_search_response.rbi +17 -10
  99. data/rbi/context_dev/models/industry_retrieve_naics_params.rbi +4 -6
  100. data/rbi/context_dev/models/industry_retrieve_naics_response.rbi +17 -10
  101. data/rbi/context_dev/models/industry_retrieve_sic_params.rbi +4 -6
  102. data/rbi/context_dev/models/industry_retrieve_sic_response.rbi +17 -10
  103. data/rbi/context_dev/models/log_list_params.rbi +162 -0
  104. data/rbi/context_dev/models/log_list_response.rbi +246 -0
  105. data/rbi/context_dev/models/log_retrieve_params.rbi +40 -0
  106. data/rbi/context_dev/models/log_retrieve_response.rbi +370 -0
  107. data/rbi/context_dev/models/monitor_create_params.rbi +13 -2
  108. data/rbi/context_dev/models/monitor_create_response.rbi +11 -0
  109. data/rbi/context_dev/models/monitor_list_account_runs_response.rbi +14 -3
  110. data/rbi/context_dev/models/monitor_list_response.rbi +11 -0
  111. data/rbi/context_dev/models/monitor_list_runs_response.rbi +14 -3
  112. data/rbi/context_dev/models/monitor_retrieve_response.rbi +11 -0
  113. data/rbi/context_dev/models/monitor_update_params.rbi +13 -2
  114. data/rbi/context_dev/models/monitor_update_response.rbi +11 -0
  115. data/rbi/context_dev/models/news_search_response.rbi +17 -10
  116. data/rbi/context_dev/models/parse_handle_params.rbi +4 -6
  117. data/rbi/context_dev/models/parse_handle_response.rbi +17 -10
  118. data/rbi/context_dev/models/person_enrich_response.rbi +17 -10
  119. data/rbi/context_dev/models/retry_config.rbi +35 -0
  120. data/rbi/context_dev/models/utility_prefetch_response.rbi +17 -10
  121. data/rbi/context_dev/models/web_extract_competitors_params.rbi +4 -6
  122. data/rbi/context_dev/models/web_extract_competitors_response.rbi +17 -10
  123. data/rbi/context_dev/models/web_extract_fonts_params.rbi +4 -6
  124. data/rbi/context_dev/models/web_extract_fonts_response.rbi +17 -10
  125. data/rbi/context_dev/models/web_extract_response.rbi +17 -10
  126. data/rbi/context_dev/models/web_extract_styleguide_params.rbi +4 -6
  127. data/rbi/context_dev/models/web_extract_styleguide_response.rbi +17 -10
  128. data/rbi/context_dev/models/web_screenshot_params.rbi +8 -8
  129. data/rbi/context_dev/models/web_screenshot_response.rbi +17 -10
  130. data/rbi/context_dev/models/web_search_response.rbi +17 -10
  131. data/rbi/context_dev/models/web_web_crawl_md_response.rbi +17 -10
  132. data/rbi/context_dev/models/web_web_scrape_html_params.rbi +10 -8
  133. data/rbi/context_dev/models/web_web_scrape_html_response.rbi +17 -10
  134. data/rbi/context_dev/models/web_web_scrape_images_params.rbi +10 -8
  135. data/rbi/context_dev/models/web_web_scrape_images_response.rbi +17 -10
  136. data/rbi/context_dev/models/web_web_scrape_md_params.rbi +10 -8
  137. data/rbi/context_dev/models/web_web_scrape_md_response.rbi +17 -10
  138. data/rbi/context_dev/models/web_web_scrape_sitemap_params.rbi +4 -6
  139. data/rbi/context_dev/models/web_web_scrape_sitemap_response.rbi +17 -10
  140. data/rbi/context_dev/models/webhook_delivery.rbi +14 -3
  141. data/rbi/context_dev/models/webhooks/attempt.rbi +160 -0
  142. data/rbi/context_dev/models/webhooks/delivery.rbi +471 -0
  143. data/rbi/context_dev/models/webhooks/delivery_list_attempts_params.rbi +83 -0
  144. data/rbi/context_dev/models/webhooks/delivery_list_attempts_response.rbi +133 -0
  145. data/rbi/context_dev/models/webhooks/delivery_list_params.rbi +427 -0
  146. data/rbi/context_dev/models/webhooks/delivery_list_response.rbi +133 -0
  147. data/rbi/context_dev/models/webhooks/delivery_retrieve_params.rbi +61 -0
  148. data/rbi/context_dev/models/webhooks/delivery_retrieve_response.rbi +109 -0
  149. data/rbi/context_dev/models/webhooks/delivery_retry_params.rbi +81 -0
  150. data/rbi/context_dev/models/webhooks/delivery_retry_response.rbi +117 -0
  151. data/rbi/context_dev/models/webhooks/delivery_summary.rbi +459 -0
  152. data/rbi/context_dev/models.rbi +8 -0
  153. data/rbi/context_dev/resources/batch.rbi +6 -1
  154. data/rbi/context_dev/resources/brand.rbi +4 -6
  155. data/rbi/context_dev/resources/industry.rbi +4 -6
  156. data/rbi/context_dev/resources/logs.rbi +76 -0
  157. data/rbi/context_dev/resources/parse.rbi +2 -3
  158. data/rbi/context_dev/resources/web.rbi +27 -28
  159. data/rbi/context_dev/resources/webhooks/deliveries.rbi +95 -0
  160. data/rbi/context_dev/resources/webhooks.rbi +16 -0
  161. data/sig/context_dev/client.rbs +4 -0
  162. data/sig/context_dev/models/ai_extract_product_response.rbs +5 -0
  163. data/sig/context_dev/models/ai_extract_products_response.rbs +5 -0
  164. data/sig/context_dev/models/batch_cancel_response.rbs +5 -0
  165. data/sig/context_dev/models/batch_delete_response.rbs +5 -0
  166. data/sig/context_dev/models/batch_get_results_response.rbs +5 -0
  167. data/sig/context_dev/models/batch_list_response.rbs +5 -0
  168. data/sig/context_dev/models/batch_retrieve_response.rbs +15 -3
  169. data/sig/context_dev/models/batch_submit_params.rbs +23 -0
  170. data/sig/context_dev/models/batch_submit_response.rbs +5 -0
  171. data/sig/context_dev/models/brand_retrieve_response.rbs +5 -0
  172. data/sig/context_dev/models/brand_retrieve_simplified_response.rbs +5 -0
  173. data/sig/context_dev/models/brand_search_response.rbs +5 -0
  174. data/sig/context_dev/models/industry_retrieve_naics_response.rbs +5 -0
  175. data/sig/context_dev/models/industry_retrieve_sic_response.rbs +5 -0
  176. data/sig/context_dev/models/log_list_params.rbs +98 -0
  177. data/sig/context_dev/models/log_list_response.rbs +135 -0
  178. data/sig/context_dev/models/log_retrieve_params.rbs +23 -0
  179. data/sig/context_dev/models/log_retrieve_response.rbs +179 -0
  180. data/sig/context_dev/models/monitor_create_params.rbs +8 -1
  181. data/sig/context_dev/models/monitor_create_response.rbs +7 -0
  182. data/sig/context_dev/models/monitor_list_account_runs_response.rbs +10 -3
  183. data/sig/context_dev/models/monitor_list_response.rbs +7 -0
  184. data/sig/context_dev/models/monitor_list_runs_response.rbs +10 -3
  185. data/sig/context_dev/models/monitor_retrieve_response.rbs +7 -0
  186. data/sig/context_dev/models/monitor_update_params.rbs +8 -1
  187. data/sig/context_dev/models/monitor_update_response.rbs +7 -0
  188. data/sig/context_dev/models/news_search_response.rbs +5 -0
  189. data/sig/context_dev/models/parse_handle_response.rbs +5 -0
  190. data/sig/context_dev/models/person_enrich_response.rbs +5 -0
  191. data/sig/context_dev/models/retry_config.rbs +15 -0
  192. data/sig/context_dev/models/utility_prefetch_response.rbs +5 -0
  193. data/sig/context_dev/models/web_extract_competitors_response.rbs +5 -0
  194. data/sig/context_dev/models/web_extract_fonts_response.rbs +5 -0
  195. data/sig/context_dev/models/web_extract_response.rbs +5 -0
  196. data/sig/context_dev/models/web_extract_styleguide_response.rbs +5 -0
  197. data/sig/context_dev/models/web_screenshot_response.rbs +5 -0
  198. data/sig/context_dev/models/web_search_response.rbs +5 -0
  199. data/sig/context_dev/models/web_web_crawl_md_response.rbs +5 -0
  200. data/sig/context_dev/models/web_web_scrape_html_response.rbs +5 -0
  201. data/sig/context_dev/models/web_web_scrape_images_response.rbs +5 -0
  202. data/sig/context_dev/models/web_web_scrape_md_response.rbs +5 -0
  203. data/sig/context_dev/models/web_web_scrape_sitemap_response.rbs +5 -0
  204. data/sig/context_dev/models/webhook_delivery.rbs +10 -3
  205. data/sig/context_dev/models/webhooks/attempt.rbs +76 -0
  206. data/sig/context_dev/models/webhooks/delivery.rbs +208 -0
  207. data/sig/context_dev/models/webhooks/delivery_list_attempts_params.rbs +49 -0
  208. data/sig/context_dev/models/webhooks/delivery_list_attempts_response.rbs +65 -0
  209. data/sig/context_dev/models/webhooks/delivery_list_params.rbs +207 -0
  210. data/sig/context_dev/models/webhooks/delivery_list_response.rbs +65 -0
  211. data/sig/context_dev/models/webhooks/delivery_retrieve_params.rbs +32 -0
  212. data/sig/context_dev/models/webhooks/delivery_retrieve_response.rbs +52 -0
  213. data/sig/context_dev/models/webhooks/delivery_retry_params.rbs +49 -0
  214. data/sig/context_dev/models/webhooks/delivery_retry_response.rbs +55 -0
  215. data/sig/context_dev/models/webhooks/delivery_summary.rbs +193 -0
  216. data/sig/context_dev/models.rbs +8 -0
  217. data/sig/context_dev/resources/batch.rbs +1 -0
  218. data/sig/context_dev/resources/logs.rbs +27 -0
  219. data/sig/context_dev/resources/webhooks/deliveries.rbs +36 -0
  220. data/sig/context_dev/resources/webhooks.rbs +9 -0
  221. metadata +59 -2
@@ -19,8 +19,16 @@ module ContextDev
19
19
  # @return [Array<String>, nil]
20
20
  optional :tags, ContextDev::Internal::Type::ArrayOf[String]
21
21
 
22
+ # @!attribute webhook
23
+ # Completion webhook settings. Cannot be combined with webhookUrl. Omitting retry
24
+ # preserves legacy delivery; retry: {} opts into durable retries.
25
+ #
26
+ # @return [ContextDev::Models::BatchSubmitParams::Webhook, nil]
27
+ optional :webhook, -> { ContextDev::BatchSubmitParams::Webhook }
28
+
22
29
  # @!attribute webhook_url
23
- # URL notified when the batch finishes.
30
+ # Legacy URL notified when the batch finishes. Preserves one best-effort attempt.
31
+ # Cannot be combined with webhook.
24
32
  #
25
33
  # @return [String, nil]
26
34
  optional :webhook_url, String, api_name: :webhookUrl
@@ -32,7 +40,7 @@ module ContextDev
32
40
  # @return [String, nil]
33
41
  optional :idempotency_key, String
34
42
 
35
- # @!method initialize(input:, tags: nil, webhook_url: nil, idempotency_key: nil, request_options: {})
43
+ # @!method initialize(input:, tags: nil, webhook: nil, webhook_url: nil, idempotency_key: nil, request_options: {})
36
44
  # Some parameter documentations has been truncated, see
37
45
  # {ContextDev::Models::BatchSubmitParams} for more details.
38
46
  #
@@ -40,7 +48,9 @@ module ContextDev
40
48
  #
41
49
  # @param tags [Array<String>] Tags stored on the batch. Filter the batch list by them later.
42
50
  #
43
- # @param webhook_url [String] URL notified when the batch finishes.
51
+ # @param webhook [ContextDev::Models::BatchSubmitParams::Webhook] Completion webhook settings. Cannot be combined with webhookUrl. Omitting retry
52
+ #
53
+ # @param webhook_url [String] Legacy URL notified when the batch finishes. Preserves one best-effort attempt.
44
54
  #
45
55
  # @param idempotency_key [String] Any string unique to this submission. Retries with the same key return the origi
46
56
  #
@@ -2105,6 +2115,27 @@ module ContextDev
2105
2115
  # @!method self.variants
2106
2116
  # @return [Array(ContextDev::Models::BatchSubmitParams::Input::Scrape, ContextDev::Models::BatchSubmitParams::Input::Crawl)]
2107
2117
  end
2118
+
2119
+ class Webhook < ContextDev::Internal::Type::BaseModel
2120
+ # @!attribute url
2121
+ #
2122
+ # @return [String]
2123
+ required :url, String
2124
+
2125
+ # @!attribute retry_
2126
+ # Webhook retry settings. Use {} for the default schedule.
2127
+ #
2128
+ # @return [ContextDev::Models::RetryConfig, nil]
2129
+ optional :retry_, -> { ContextDev::RetryConfig }, api_name: :retry
2130
+
2131
+ # @!method initialize(url:, retry_: nil)
2132
+ # Completion webhook settings. Cannot be combined with webhookUrl. Omitting retry
2133
+ # preserves legacy delivery; retry: {} opts into durable retries.
2134
+ #
2135
+ # @param url [String]
2136
+ #
2137
+ # @param retry_ [ContextDev::Models::RetryConfig] Webhook retry settings. Use {} for the default schedule.
2138
+ end
2108
2139
  end
2109
2140
  end
2110
2141
  end
@@ -62,6 +62,13 @@ module ContextDev
62
62
  # @return [Symbol, ContextDev::Models::BatchSubmitResponse::Mode]
63
63
  required :mode, enum: -> { ContextDev::Models::BatchSubmitResponse::Mode }
64
64
 
65
+ # @!attribute request_id
66
+ # Unique id of this API call, also sent in the X-Request-Id response header. Quote
67
+ # it when contacting support about a failed request.
68
+ #
69
+ # @return [String]
70
+ required :request_id, String
71
+
65
72
  # @!attribute status
66
73
  # Always `queued`. An accepted batch has not started yet.
67
74
  #
@@ -87,7 +94,7 @@ module ContextDev
87
94
  # @return [String, nil]
88
95
  optional :webhook_secret, String
89
96
 
90
- # @!method initialize(id:, cache_metadata:, crawl:, created_at:, credits:, format_:, input:, invalid_urls:, mode:, status:, tags:, key_metadata: nil, webhook_secret: nil)
97
+ # @!method initialize(id:, cache_metadata:, crawl:, created_at:, credits:, format_:, input:, invalid_urls:, mode:, request_id:, status:, tags:, key_metadata: nil, webhook_secret: nil)
91
98
  # Some parameter documentations has been truncated, see
92
99
  # {ContextDev::Models::BatchSubmitResponse} for more details.
93
100
  #
@@ -109,6 +116,8 @@ module ContextDev
109
116
  #
110
117
  # @param mode [Symbol, ContextDev::Models::BatchSubmitResponse::Mode] How pages will be selected.
111
118
  #
119
+ # @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
120
+ #
112
121
  # @param status [Symbol, ContextDev::Models::BatchSubmitResponse::Status] Always `queued`. An accepted batch has not started yet.
113
122
  #
114
123
  # @param tags [Array<String>] Tags stored on the batch.
@@ -238,13 +247,13 @@ module ContextDev
238
247
  # @see ContextDev::Models::BatchSubmitResponse#key_metadata
239
248
  class KeyMetadata < ContextDev::Internal::Type::BaseModel
240
249
  # @!attribute credits_consumed
241
- # The number of credits consumed by this request.
250
+ # Credits used by this request.
242
251
  #
243
252
  # @return [Integer]
244
253
  required :credits_consumed, Integer
245
254
 
246
255
  # @!attribute credits_remaining
247
- # The number of credits remaining for your organization after this request.
256
+ # Credits remaining for your organization.
248
257
  #
249
258
  # @return [Integer]
250
259
  required :credits_remaining, Integer
@@ -252,9 +261,9 @@ module ContextDev
252
261
  # @!method initialize(credits_consumed:, credits_remaining:)
253
262
  # API key usage for this request.
254
263
  #
255
- # @param credits_consumed [Integer] The number of credits consumed by this request.
264
+ # @param credits_consumed [Integer] Credits used by this request.
256
265
  #
257
- # @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
266
+ # @param credits_remaining [Integer] Credits remaining for your organization.
258
267
  end
259
268
  end
260
269
  end
@@ -12,6 +12,13 @@ module ContextDev
12
12
  # @return [ContextDev::Models::BrandRetrieveResponse::CacheMetadata]
13
13
  required :cache_metadata, -> { ContextDev::Models::BrandRetrieveResponse::CacheMetadata }
14
14
 
15
+ # @!attribute request_id
16
+ # Unique id of this API call, also sent in the X-Request-Id response header. Quote
17
+ # it when contacting support about a failed request.
18
+ #
19
+ # @return [String]
20
+ required :request_id, String
21
+
15
22
  # @!attribute brand
16
23
  # Detailed brand information
17
24
  #
@@ -25,8 +32,7 @@ module ContextDev
25
32
  optional :code, Integer
26
33
 
27
34
  # @!attribute key_metadata
28
- # Metadata about the API key used for the request. Included in every response
29
- # whenever a valid API key is provided, even when the response status is not 200.
35
+ # Credit usage, included whenever a valid API key is provided.
30
36
  #
31
37
  # @return [ContextDev::Models::BrandRetrieveResponse::KeyMetadata, nil]
32
38
  optional :key_metadata, -> { ContextDev::Models::BrandRetrieveResponse::KeyMetadata }
@@ -37,17 +43,19 @@ module ContextDev
37
43
  # @return [String, nil]
38
44
  optional :status, String
39
45
 
40
- # @!method initialize(cache_metadata:, brand: nil, code: nil, key_metadata: nil, status: nil)
46
+ # @!method initialize(cache_metadata:, request_id:, brand: nil, code: nil, key_metadata: nil, status: nil)
41
47
  # Some parameter documentations has been truncated, see
42
48
  # {ContextDev::Models::BrandRetrieveResponse} for more details.
43
49
  #
44
50
  # @param cache_metadata [ContextDev::Models::BrandRetrieveResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
45
51
  #
52
+ # @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
53
+ #
46
54
  # @param brand [ContextDev::Models::BrandRetrieveResponse::Brand] Detailed brand information
47
55
  #
48
56
  # @param code [Integer] HTTP status code
49
57
  #
50
- # @param key_metadata [ContextDev::Models::BrandRetrieveResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
58
+ # @param key_metadata [ContextDev::Models::BrandRetrieveResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
51
59
  #
52
60
  # @param status [String] Status of the response, e.g., 'ok'
53
61
 
@@ -1176,24 +1184,23 @@ module ContextDev
1176
1184
  # @see ContextDev::Models::BrandRetrieveResponse#key_metadata
1177
1185
  class KeyMetadata < ContextDev::Internal::Type::BaseModel
1178
1186
  # @!attribute credits_consumed
1179
- # The number of credits consumed by this request.
1187
+ # Credits used by this request.
1180
1188
  #
1181
1189
  # @return [Integer]
1182
1190
  required :credits_consumed, Integer
1183
1191
 
1184
1192
  # @!attribute credits_remaining
1185
- # The number of credits remaining for your organization after this request.
1193
+ # Credits remaining for your organization.
1186
1194
  #
1187
1195
  # @return [Integer]
1188
1196
  required :credits_remaining, Integer
1189
1197
 
1190
1198
  # @!method initialize(credits_consumed:, credits_remaining:)
1191
- # Metadata about the API key used for the request. Included in every response
1192
- # whenever a valid API key is provided, even when the response status is not 200.
1199
+ # Credit usage, included whenever a valid API key is provided.
1193
1200
  #
1194
- # @param credits_consumed [Integer] The number of credits consumed by this request.
1201
+ # @param credits_consumed [Integer] Credits used by this request.
1195
1202
  #
1196
- # @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
1203
+ # @param credits_remaining [Integer] Credits remaining for your organization.
1197
1204
  end
1198
1205
  end
1199
1206
  end
@@ -23,9 +23,8 @@ module ContextDev
23
23
  optional :max_age_ms, Integer, nil?: true
24
24
 
25
25
  # @!attribute tags
26
- # Optional comma-separated caller-defined tags for tracking this request. Tags are
27
- # recorded on the request's usage log and can be used to filter usage on the
28
- # dashboard usage page. Up to 20 tags, each 1-50 characters.
26
+ # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
27
+ # characters.
29
28
  #
30
29
  # @return [Array<String>, nil]
31
30
  optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -52,7 +51,7 @@ module ContextDev
52
51
  #
53
52
  # @param max_age_ms [Integer, nil] Maximum age in milliseconds for cached brand data before the API performs a hard
54
53
  #
55
- # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
54
+ # @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
56
55
  #
57
56
  # @param theme [Symbol, ContextDev::Models::BrandRetrieveSimplifiedParams::Theme] Optional theme preference used when selecting brand assets.
58
57
  #
@@ -12,6 +12,13 @@ module ContextDev
12
12
  # @return [ContextDev::Models::BrandRetrieveSimplifiedResponse::CacheMetadata]
13
13
  required :cache_metadata, -> { ContextDev::Models::BrandRetrieveSimplifiedResponse::CacheMetadata }
14
14
 
15
+ # @!attribute request_id
16
+ # Unique id of this API call, also sent in the X-Request-Id response header. Quote
17
+ # it when contacting support about a failed request.
18
+ #
19
+ # @return [String]
20
+ required :request_id, String
21
+
15
22
  # @!attribute brand
16
23
  # Simplified brand information
17
24
  #
@@ -25,8 +32,7 @@ module ContextDev
25
32
  optional :code, Integer
26
33
 
27
34
  # @!attribute key_metadata
28
- # Metadata about the API key used for the request. Included in every response
29
- # whenever a valid API key is provided, even when the response status is not 200.
35
+ # Credit usage, included whenever a valid API key is provided.
30
36
  #
31
37
  # @return [ContextDev::Models::BrandRetrieveSimplifiedResponse::KeyMetadata, nil]
32
38
  optional :key_metadata, -> { ContextDev::Models::BrandRetrieveSimplifiedResponse::KeyMetadata }
@@ -37,17 +43,19 @@ module ContextDev
37
43
  # @return [String, nil]
38
44
  optional :status, String
39
45
 
40
- # @!method initialize(cache_metadata:, brand: nil, code: nil, key_metadata: nil, status: nil)
46
+ # @!method initialize(cache_metadata:, request_id:, brand: nil, code: nil, key_metadata: nil, status: nil)
41
47
  # Some parameter documentations has been truncated, see
42
48
  # {ContextDev::Models::BrandRetrieveSimplifiedResponse} for more details.
43
49
  #
44
50
  # @param cache_metadata [ContextDev::Models::BrandRetrieveSimplifiedResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
45
51
  #
52
+ # @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
53
+ #
46
54
  # @param brand [ContextDev::Models::BrandRetrieveSimplifiedResponse::Brand] Simplified brand information
47
55
  #
48
56
  # @param code [Integer] HTTP status code of the response
49
57
  #
50
- # @param key_metadata [ContextDev::Models::BrandRetrieveSimplifiedResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
58
+ # @param key_metadata [ContextDev::Models::BrandRetrieveSimplifiedResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
51
59
  #
52
60
  # @param status [String] Status of the response, e.g., 'ok'
53
61
 
@@ -401,24 +409,23 @@ module ContextDev
401
409
  # @see ContextDev::Models::BrandRetrieveSimplifiedResponse#key_metadata
402
410
  class KeyMetadata < ContextDev::Internal::Type::BaseModel
403
411
  # @!attribute credits_consumed
404
- # The number of credits consumed by this request.
412
+ # Credits used by this request.
405
413
  #
406
414
  # @return [Integer]
407
415
  required :credits_consumed, Integer
408
416
 
409
417
  # @!attribute credits_remaining
410
- # The number of credits remaining for your organization after this request.
418
+ # Credits remaining for your organization.
411
419
  #
412
420
  # @return [Integer]
413
421
  required :credits_remaining, Integer
414
422
 
415
423
  # @!method initialize(credits_consumed:, credits_remaining:)
416
- # Metadata about the API key used for the request. Included in every response
417
- # whenever a valid API key is provided, even when the response status is not 200.
424
+ # Credit usage, included whenever a valid API key is provided.
418
425
  #
419
- # @param credits_consumed [Integer] The number of credits consumed by this request.
426
+ # @param credits_consumed [Integer] Credits used by this request.
420
427
  #
421
- # @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
428
+ # @param credits_remaining [Integer] Credits remaining for your organization.
422
429
  end
423
430
  end
424
431
  end
@@ -30,9 +30,8 @@ module ContextDev
30
30
  -> { ContextDev::Internal::Type::ArrayOf[enum: ContextDev::BrandSearchParams::QueryBy] }
31
31
 
32
32
  # @!attribute tags
33
- # Optional comma-separated caller-defined tags for tracking this request. Tags are
34
- # recorded on the request's usage log and can be used to filter usage on the
35
- # dashboard usage page. Up to 20 tags, each 1-50 characters.
33
+ # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
34
+ # characters.
36
35
  #
37
36
  # @return [Array<String>, nil]
38
37
  optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -54,7 +53,7 @@ module ContextDev
54
53
  #
55
54
  # @param query_by [Array<Symbol, ContextDev::Models::BrandSearchParams::QueryBy>] Fields to match the search term against, as a comma-separated list or repeated p
56
55
  #
57
- # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
56
+ # @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
58
57
  #
59
58
  # @param typo_tolerance [Integer] Maximum number of typos tolerated when matching, from 0 to 2. Defaults to 0 (no
60
59
  #
@@ -4,6 +4,13 @@ module ContextDev
4
4
  module Models
5
5
  # @see ContextDev::Resources::Brand#search
6
6
  class BrandSearchResponse < ContextDev::Internal::Type::BaseModel
7
+ # @!attribute request_id
8
+ # Unique id of this API call, also sent in the X-Request-Id response header. Quote
9
+ # it when contacting support about a failed request.
10
+ #
11
+ # @return [String]
12
+ required :request_id, String
13
+
7
14
  # @!attribute results
8
15
  # Up to 10 matching brands, name matches first, then domain matches, most popular
9
16
  # first within each group. Empty when nothing matches.
@@ -13,19 +20,20 @@ module ContextDev
13
20
  -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::BrandSearchResponse::Result] }
14
21
 
15
22
  # @!attribute key_metadata
16
- # Metadata about the API key used for the request. Included in every response
17
- # whenever a valid API key is provided, even when the response status is not 200.
23
+ # Credit usage, included whenever a valid API key is provided.
18
24
  #
19
25
  # @return [ContextDev::Models::BrandSearchResponse::KeyMetadata, nil]
20
26
  optional :key_metadata, -> { ContextDev::Models::BrandSearchResponse::KeyMetadata }
21
27
 
22
- # @!method initialize(results:, key_metadata: nil)
28
+ # @!method initialize(request_id:, results:, key_metadata: nil)
23
29
  # Some parameter documentations has been truncated, see
24
30
  # {ContextDev::Models::BrandSearchResponse} for more details.
25
31
  #
32
+ # @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
33
+ #
26
34
  # @param results [Array<ContextDev::Models::BrandSearchResponse::Result>] Up to 10 matching brands, name matches first, then domain matches, most popular
27
35
  #
28
- # @param key_metadata [ContextDev::Models::BrandSearchResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
36
+ # @param key_metadata [ContextDev::Models::BrandSearchResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
29
37
 
30
38
  class Result < ContextDev::Internal::Type::BaseModel
31
39
  # @!attribute domain
@@ -61,24 +69,23 @@ module ContextDev
61
69
  # @see ContextDev::Models::BrandSearchResponse#key_metadata
62
70
  class KeyMetadata < ContextDev::Internal::Type::BaseModel
63
71
  # @!attribute credits_consumed
64
- # The number of credits consumed by this request.
72
+ # Credits used by this request.
65
73
  #
66
74
  # @return [Integer]
67
75
  required :credits_consumed, Integer
68
76
 
69
77
  # @!attribute credits_remaining
70
- # The number of credits remaining for your organization after this request.
78
+ # Credits remaining for your organization.
71
79
  #
72
80
  # @return [Integer]
73
81
  required :credits_remaining, Integer
74
82
 
75
83
  # @!method initialize(credits_consumed:, credits_remaining:)
76
- # Metadata about the API key used for the request. Included in every response
77
- # whenever a valid API key is provided, even when the response status is not 200.
84
+ # Credit usage, included whenever a valid API key is provided.
78
85
  #
79
- # @param credits_consumed [Integer] The number of credits consumed by this request.
86
+ # @param credits_consumed [Integer] Credits used by this request.
80
87
  #
81
- # @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
88
+ # @param credits_remaining [Integer] Credits remaining for your organization.
82
89
  end
83
90
  end
84
91
  end
@@ -29,9 +29,8 @@ module ContextDev
29
29
  optional :min_results, Integer
30
30
 
31
31
  # @!attribute tags
32
- # Optional comma-separated caller-defined tags for tracking this request. Tags are
33
- # recorded on the request's usage log and can be used to filter usage on the
34
- # dashboard usage page. Up to 20 tags, each 1-50 characters.
32
+ # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
33
+ # characters.
35
34
  #
36
35
  # @return [Array<String>, nil]
37
36
  optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -54,7 +53,7 @@ module ContextDev
54
53
  #
55
54
  # @param min_results [Integer] Minimum number of NAICS codes to return. Must be at least 1. Defaults to 1.
56
55
  #
57
- # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
56
+ # @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
58
57
  #
59
58
  # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
60
59
  #
@@ -4,6 +4,13 @@ module ContextDev
4
4
  module Models
5
5
  # @see ContextDev::Resources::Industry#retrieve_naics
6
6
  class IndustryRetrieveNaicsResponse < ContextDev::Internal::Type::BaseModel
7
+ # @!attribute request_id
8
+ # Unique id of this API call, also sent in the X-Request-Id response header. Quote
9
+ # it when contacting support about a failed request.
10
+ #
11
+ # @return [String]
12
+ required :request_id, String
13
+
7
14
  # @!attribute codes
8
15
  # Array of NAICS codes and titles.
9
16
  #
@@ -18,8 +25,7 @@ module ContextDev
18
25
  optional :domain, String
19
26
 
20
27
  # @!attribute key_metadata
21
- # Metadata about the API key used for the request. Included in every response
22
- # whenever a valid API key is provided, even when the response status is not 200.
28
+ # Credit usage, included whenever a valid API key is provided.
23
29
  #
24
30
  # @return [ContextDev::Models::IndustryRetrieveNaicsResponse::KeyMetadata, nil]
25
31
  optional :key_metadata, -> { ContextDev::Models::IndustryRetrieveNaicsResponse::KeyMetadata }
@@ -36,15 +42,17 @@ module ContextDev
36
42
  # @return [String, nil]
37
43
  optional :type, String
38
44
 
39
- # @!method initialize(codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
45
+ # @!method initialize(request_id:, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
40
46
  # Some parameter documentations has been truncated, see
41
47
  # {ContextDev::Models::IndustryRetrieveNaicsResponse} for more details.
42
48
  #
49
+ # @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
50
+ #
43
51
  # @param codes [Array<ContextDev::Models::IndustryRetrieveNaicsResponse::Code>] Array of NAICS codes and titles.
44
52
  #
45
53
  # @param domain [String] Domain found for the brand
46
54
  #
47
- # @param key_metadata [ContextDev::Models::IndustryRetrieveNaicsResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
55
+ # @param key_metadata [ContextDev::Models::IndustryRetrieveNaicsResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
48
56
  #
49
57
  # @param status [String] Status of the response, e.g., 'ok'
50
58
  #
@@ -94,24 +102,23 @@ module ContextDev
94
102
  # @see ContextDev::Models::IndustryRetrieveNaicsResponse#key_metadata
95
103
  class KeyMetadata < ContextDev::Internal::Type::BaseModel
96
104
  # @!attribute credits_consumed
97
- # The number of credits consumed by this request.
105
+ # Credits used by this request.
98
106
  #
99
107
  # @return [Integer]
100
108
  required :credits_consumed, Integer
101
109
 
102
110
  # @!attribute credits_remaining
103
- # The number of credits remaining for your organization after this request.
111
+ # Credits remaining for your organization.
104
112
  #
105
113
  # @return [Integer]
106
114
  required :credits_remaining, Integer
107
115
 
108
116
  # @!method initialize(credits_consumed:, credits_remaining:)
109
- # Metadata about the API key used for the request. Included in every response
110
- # whenever a valid API key is provided, even when the response status is not 200.
117
+ # Credit usage, included whenever a valid API key is provided.
111
118
  #
112
- # @param credits_consumed [Integer] The number of credits consumed by this request.
119
+ # @param credits_consumed [Integer] Credits used by this request.
113
120
  #
114
- # @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
121
+ # @param credits_remaining [Integer] Credits remaining for your organization.
115
122
  end
116
123
  end
117
124
  end
@@ -28,9 +28,8 @@ module ContextDev
28
28
  optional :min_results, Integer
29
29
 
30
30
  # @!attribute tags
31
- # Optional comma-separated caller-defined tags for tracking this request. Tags are
32
- # recorded on the request's usage log and can be used to filter usage on the
33
- # dashboard usage page. Up to 20 tags, each 1-50 characters.
31
+ # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
32
+ # characters.
34
33
  #
35
34
  # @return [Array<String>, nil]
36
35
  optional :tags, ContextDev::Internal::Type::ArrayOf[String]
@@ -61,7 +60,7 @@ module ContextDev
61
60
  #
62
61
  # @param min_results [Integer] Minimum number of SIC codes to return. Must be at least 1. Defaults to 1.
63
62
  #
64
- # @param tags [Array<String>] Optional comma-separated caller-defined tags for tracking this request. Tags are
63
+ # @param tags [Array<String>] Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50 charac
65
64
  #
66
65
  # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
67
66
  #
@@ -4,6 +4,13 @@ module ContextDev
4
4
  module Models
5
5
  # @see ContextDev::Resources::Industry#retrieve_sic
6
6
  class IndustryRetrieveSicResponse < ContextDev::Internal::Type::BaseModel
7
+ # @!attribute request_id
8
+ # Unique id of this API call, also sent in the X-Request-Id response header. Quote
9
+ # it when contacting support about a failed request.
10
+ #
11
+ # @return [String]
12
+ required :request_id, String
13
+
7
14
  # @!attribute classification
8
15
  # Echoes back which SIC dataset was used to classify the brand.
9
16
  #
@@ -26,8 +33,7 @@ module ContextDev
26
33
  optional :domain, String
27
34
 
28
35
  # @!attribute key_metadata
29
- # Metadata about the API key used for the request. Included in every response
30
- # whenever a valid API key is provided, even when the response status is not 200.
36
+ # Credit usage, included whenever a valid API key is provided.
31
37
  #
32
38
  # @return [ContextDev::Models::IndustryRetrieveSicResponse::KeyMetadata, nil]
33
39
  optional :key_metadata, -> { ContextDev::Models::IndustryRetrieveSicResponse::KeyMetadata }
@@ -44,17 +50,19 @@ module ContextDev
44
50
  # @return [String, nil]
45
51
  optional :type, String
46
52
 
47
- # @!method initialize(classification: nil, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
53
+ # @!method initialize(request_id:, classification: nil, codes: nil, domain: nil, key_metadata: nil, status: nil, type: nil)
48
54
  # Some parameter documentations has been truncated, see
49
55
  # {ContextDev::Models::IndustryRetrieveSicResponse} for more details.
50
56
  #
57
+ # @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
58
+ #
51
59
  # @param classification [Symbol, ContextDev::Models::IndustryRetrieveSicResponse::Classification] Echoes back which SIC dataset was used to classify the brand.
52
60
  #
53
61
  # @param codes [Array<ContextDev::Models::IndustryRetrieveSicResponse::Code>] Array of SIC codes with confidence scores. Extra fields depend on the requested
54
62
  #
55
63
  # @param domain [String] Domain found for the brand
56
64
  #
57
- # @param key_metadata [ContextDev::Models::IndustryRetrieveSicResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
65
+ # @param key_metadata [ContextDev::Models::IndustryRetrieveSicResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
58
66
  #
59
67
  # @param status [String] Status of the response, e.g., 'ok'
60
68
  #
@@ -147,24 +155,23 @@ module ContextDev
147
155
  # @see ContextDev::Models::IndustryRetrieveSicResponse#key_metadata
148
156
  class KeyMetadata < ContextDev::Internal::Type::BaseModel
149
157
  # @!attribute credits_consumed
150
- # The number of credits consumed by this request.
158
+ # Credits used by this request.
151
159
  #
152
160
  # @return [Integer]
153
161
  required :credits_consumed, Integer
154
162
 
155
163
  # @!attribute credits_remaining
156
- # The number of credits remaining for your organization after this request.
164
+ # Credits remaining for your organization.
157
165
  #
158
166
  # @return [Integer]
159
167
  required :credits_remaining, Integer
160
168
 
161
169
  # @!method initialize(credits_consumed:, credits_remaining:)
162
- # Metadata about the API key used for the request. Included in every response
163
- # whenever a valid API key is provided, even when the response status is not 200.
170
+ # Credit usage, included whenever a valid API key is provided.
164
171
  #
165
- # @param credits_consumed [Integer] The number of credits consumed by this request.
172
+ # @param credits_consumed [Integer] Credits used by this request.
166
173
  #
167
- # @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
174
+ # @param credits_remaining [Integer] Credits remaining for your organization.
168
175
  end
169
176
  end
170
177
  end