contentful-management 2.0.2 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af6595494f26b3a85d5394e675069faa4518cfbb51b0fd7856da47a94a5e1d1d
-  data.tar.gz: b7da54f816b90d302c91995ac77beb1c383b3b385872cccadb07dfde301fc0c0
+  metadata.gz: e9ee1535df6db39a73f0eba091acdeb3e90250e74a911e73faefc7fb23f90ef6
+  data.tar.gz: 92f738e34c2247f8b831fee2449a4702a1598b3be3b200ce37e1517e5ba700dc
 SHA512:
-  metadata.gz: 6f04b5c262ee9182ad6562008968711b7df6627b03be6fc9b8a980594205560a0868c3de151c55a2c53c33e3da18805b8cdcb0b5ac4e1d8cd065bf721d0a09f2
-  data.tar.gz: e7e855348fba05bcd88da84a4645d221203a4de67a3dd346866fc8423f41a877297306ca2b30585147c1915754a5a7ac3c2c872d175a9cb10102e6d161b55597
+  metadata.gz: 85026e49bf8c1a2915462600063a39098ea547732324d82a68885319732007683bca4191db95d5cc303fc90ed0954edc92be2b67022ff7df9c96387cd3972917
+  data.tar.gz: d3a7dbd58d80e868a0b70f544422dd1c1803f777ce0483295cf9f146d406bf22e41f5fa900e47aa739a6998b66a15236d921fa1878a88ffa94d1471cc9259441

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Master
 
+## 2.1.0
+### Added
+* Added environment selection option for Api Keys.
+* Added a way to obtain Preview Api Keys.
+
+### Fixed
+* Fixed `Link#resolve` not working for all resource types.
+
 ## 2.0.2
 ### Fixed
 * Fixed environment ID fetching for environment aware resources.
@@ -12,7 +20,7 @@
 
 ## 2.0.0
 ### Added
-* Added support for Environments
+* Added support for Environments.
 
 ### Changed
 

data/README.md

@@ -851,10 +851,56 @@ blog_post_api_key = blog_space.api_keys.find(api_key_id)
 ```
 
 Creating an API key:
+
 ```ruby
 blog_space.api_keys.create(name: 'foobar key', description: 'key for foobar mobile app')
 ```
 
+Creating an API key with multiple environments:
+
+```ruby
+blog_space.api_keys.create(
+  name: 'foobar key - multiple environments',
+  description: 'key for foobar app',
+  environments: [
+    {
+      sys: {
+        type: 'Link',
+        linkType: 'Environment',
+        id: 'master'
+      }
+    },
+    {
+      sys: {
+        type: 'Link',
+        linkType: 'Environment',
+        id: 'staging'
+      }
+    }
+  ]
+)
+```
+
+### Preview API Keys
+
+Retrieving all Preview API keys from the space:
+
+```ruby
+blog_post_preview_api_keys = blog_space.preview_api_keys.all
+```
+
+Retrieving one Preview API key by ID from the space:
+
+```ruby
+blog_post_preview_api_key = blog_space.preview_api_keys.find(api_key_id)
+```
+
+If you already have an API key fetched, you can retrieve the Preview API key from it:
+
+```ruby
+blog_post_preview_api_key = blog_post_api_key.preview_api_key
+```
+
 ### Personal Access Tokens
 
 Retrieving all personal access tokens:

data/contentful-management.gemspec

@@ -30,7 +30,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'guard-rspec'
   spec.add_development_dependency 'guard-rubocop'
   spec.add_development_dependency 'guard-yard'
-  spec.add_development_dependency 'rubocop', '~> 0.41.0'
+  spec.add_development_dependency 'rubocop', '~> 0.49.1'
   spec.add_development_dependency 'listen', '~> 3.0'
   spec.add_development_dependency 'vcr'
   spec.add_development_dependency 'webmock', '~> 1', '>= 1.17.3'

data/lib/contentful/management/api_key.rb

@@ -13,12 +13,15 @@ module Contentful
       property :policies
       property :description
       property :accessToken
+      property :environments
+      property :preview_api_key, Link
 
       # @private
       def self.create_attributes(_client, attributes)
         {
           'name' => attributes.fetch(:name),
-          'description' => attributes.fetch(:description, nil)
+          'description' => attributes.fetch(:description, nil),
+          'environments' => attributes.fetch(:environments, []) # Will default to master if empty
         }
       end
 
@@ -44,6 +47,18 @@ module Contentful
       def self.find(client, space_id, api_key_id)
         super(client, space_id, nil, api_key_id)
       end
+
+      # Returns the environment links associated to this Api Key
+      def environments
+        properties[:environments].map { |environment| Link.new(environment, nil, client) }
+      end
+
+      # Finds the Preview API Key associated to this API Key
+      #
+      # @return [Contentful::Management::PreviewApiKey]
+      def preview_api_key
+        client.preview_api_keys(space.id).find(properties[:preview_api_key].id)
+      end
     end
   end
 end

data/lib/contentful/management/client.rb

@@ -26,6 +26,7 @@ require 'contentful/management/client_content_type_methods_factory'
 require 'contentful/management/client_ui_extension_methods_factory'
 require 'contentful/management/client_webhook_call_methods_factory'
 require 'contentful/management/client_webhook_health_methods_factory'
+require 'contentful/management/client_preview_api_key_methods_factory'
 require 'contentful/management/client_space_membership_methods_factory'
 require 'contentful/management/client_editor_interface_methods_factory'
 require 'contentful/management/client_personal_access_tokens_methods_factory'
@@ -148,6 +149,15 @@ module Contentful
         ClientApiKeyMethodsFactory.new(self, space_id)
       end
 
+      # Allows manipulation of api keys in context of the current client
+      # Allows listing all preview api keys for client and finding one by ID.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::ClientPreviewApiKeyMethodsFactory]
+      def preview_api_keys(space_id)
+        ClientPreviewApiKeyMethodsFactory.new(self, space_id)
+      end
+
       # Allows manipulation of personal access tokens in context of the current client
       # Allows listing all personal access tokens for client, creating new and finding one by ID.
       # @see _ README for details.
@@ -375,7 +385,7 @@ module Contentful
 
       # @private
       def host_url(request)
-        (%r{^spaces/[\w|-|_]+/uploads(?:/[\w|-|_]*)?$} =~ request.url) ? uploads_url : base_url
+        %r{^spaces/[\w|-|_]+/uploads(?:/[\w|-|_]*)?$} =~ request.url ? uploads_url : base_url
       end
 
       # @private

data/lib/contentful/management/client_preview_api_key_methods_factory.rb

@@ -0,0 +1,23 @@
+require_relative 'client_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for PreviewApiKey API for usage from within Client
+    # @private
+    class ClientPreviewApiKeyMethodsFactory
+      include Contentful::Management::ClientAssociationMethodsFactory
+
+      def new(*)
+        fail 'Not supported'
+      end
+
+      def find(resource_id)
+        associated_class.find(client, @space_id, resource_id)
+      end
+
+      def create(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/content_type.rb

@@ -126,7 +126,7 @@ module Contentful
           end
 
           fields.define_singleton_method(:destroy) do |id|
-            fields = content_type.fields.select { |field| field.id != id }
+            fields = content_type.fields.reject { |field| field.id == id }
             content_type.update(fields: fields)
           end
         end

data/lib/contentful/management/entry.rb

@@ -231,6 +231,7 @@ module Contentful
         end
       end
 
+      # rubocop:disable Style/MethodMissing
       def method_missing(name, *args, &block)
         if content_type.nil?
           fetch_content_type
@@ -242,6 +243,7 @@ module Contentful
 
         fail NameError.new("undefined local variable or method `#{name}' for #{self.class}:#{sys[:id]}", name)
       end
+      # rubocop:enable Style/MethodMissing
 
       def fetch_content_type
         content_type_id = if sys[:contentType].is_a?(::Contentful::Management::Resource)

data/lib/contentful/management/link.rb

@@ -14,7 +14,7 @@ module Contentful
       def resolve(space_id = nil, environment_id = nil)
         return client.spaces.find(id) if link_type == 'Space'
 
-        method = Contentful::Management::Support.snakify(link_type).to_sym
+        method = Contentful::Management::Support.base_path_for(link_type).to_sym
 
         if space_id && environment_id.nil?
           return client.public_send(

data/lib/contentful/management/preview_api_key.rb

@@ -0,0 +1,29 @@
+require_relative 'resource'
+
+module Contentful
+  module Management
+    # Resource class for PreviewApiKey.
+    # @see _ https://www.contentful.com/developers/docs/references/content-management-api/#/reference/api-keys/preview-api-key/get-a-single-preview-api-key
+    class PreviewApiKey
+      include Contentful::Management::Resource
+      include Contentful::Management::Resource::Refresher
+      include Contentful::Management::Resource::SystemProperties
+
+      property :name
+      property :description
+      property :accessToken
+      property :environments
+
+      # Finds a Preview API Key by ID.
+      #
+      # @param [Contentful::Management::Client] client
+      # @param [String] space_id
+      # @param [String] preview_api_key_id
+      #
+      # @return [Contentful::Management::PreviewApiKey]
+      def self.find(client, space_id, preview_api_key_id)
+        super(client, space_id, nil, preview_api_key_id)
+      end
+    end
+  end
+end

data/lib/contentful/management/resource/field_aware.rb

@@ -49,10 +49,11 @@ module Contentful
         # @private
         def self.create_setter_field(entry, field, value, locale, default_locale)
           fields = entry.instance_variable_get(:@fields)
-          if localized_or_default_locale(field, default_locale, locale)
-            fields[locale] ||= {}
-            fields[locale][field.id.to_sym] = value
-          end
+
+          return unless localized_or_default_locale(field, default_locale, locale)
+
+          fields[locale] ||= {}
+          fields[locale][field.id.to_sym] = value
         end
 
         # Verifies if field is localized or default locale matches current locale

data/lib/contentful/management/resource.rb

@@ -52,8 +52,7 @@ module Contentful
       end
 
       # @private
-      def after_create(_attributes)
-      end
+      def after_create(_attributes); end
 
       # Updates a resource.
       #

data/lib/contentful/management/resource_builder.rb

@@ -19,6 +19,7 @@ require_relative 'webhook_call'
 require_relative 'ui_extension'
 require_relative 'dynamic_entry'
 require_relative 'webhook_health'
+require_relative 'preview_api_key'
 require_relative 'space_membership'
 require_relative 'editor_interface'
 require_relative 'personal_access_token'
@@ -46,6 +47,7 @@ module Contentful
         'WebhookCallDetails' => Contentful::Management::WebhookCall,
         'Webhook' => Contentful::Management::WebhookHealth,
         'ApiKey' => Contentful::Management::ApiKey,
+        'PreviewApiKey' => Contentful::Management::PreviewApiKey,
         'PersonalAccessToken' => Contentful::Management::PersonalAccessToken,
         'Locale' => Contentful::Management::Locale,
         'Role' => Contentful::Management::Role,
@@ -236,7 +238,7 @@ module Contentful
       def replace_links_with_known_resources(res, seen_resource_ids = [])
         seen_resource_ids << res.id
 
-        property_containers = [:properties, :sys, :fields].map do |property_container_name|
+        property_containers = %i[properties sys fields].map do |property_container_name|
           res.public_send(property_container_name)
         end.compact
 

data/lib/contentful/management/space.rb

@@ -9,6 +9,7 @@ require_relative 'space_role_methods_factory'
 require_relative 'space_webhook_methods_factory'
 require_relative 'space_api_key_methods_factory'
 require_relative 'space_environment_methods_factory'
+require_relative 'space_preview_api_key_methods_factory'
 require_relative 'space_space_membership_methods_factory'
 
 module Contentful
@@ -127,6 +128,15 @@ module Contentful
         SpaceApiKeyMethodsFactory.new(self)
       end
 
+      # Allows manipulation of preview api keys in context of the current space
+      # Allows listing all api keys of space and finding one by ID.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::SpacePreviewApiKeyMethodsFactory]
+      def preview_api_keys
+        SpacePreviewApiKeyMethodsFactory.new(self)
+      end
+
       # Allows manipulation of space memberships in context of the current space
       # Allows listing all space memberships of space, creating new and finding one by ID.
       # @see _ README for details.

data/lib/contentful/management/space_preview_api_key_methods_factory.rb

@@ -0,0 +1,19 @@
+require_relative 'space_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for PreviewApiKey API for usage from within Space
+    # @private
+    class SpacePreviewApiKeyMethodsFactory
+      include Contentful::Management::SpaceAssociationMethodsFactory
+
+      def new
+        fail 'Not supported'
+      end
+
+      def create
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/support.rb

@@ -32,6 +32,24 @@ module Contentful
 
           parameters
         end
+
+        # Returns the path for a specified resource name.
+        def base_path_for(resource_name)
+          {
+            'Role' => 'roles',
+            'Space' => 'spaces',
+            'Asset' => 'assets',
+            'Entry' => 'entries',
+            'Locale' => 'locales',
+            'Upload' => 'uploads',
+            'ApiKey' => 'api_keys',
+            'UIExtension' => 'extensions',
+            'Environment' => 'environments',
+            'ContentType' => 'content_types',
+            'PreviewApiKey' => 'preview_api_keys',
+            'SpaceMembership' => 'space_memberships'
+          }[resource_name]
+        end
       end
     end
   end

data/lib/contentful/management/version.rb

@@ -3,6 +3,6 @@ module Contentful
   # Management Namespace
   module Management
     # Gem Version
-    VERSION = '2.0.2'.freeze
+    VERSION = '2.1.0'.freeze
   end
 end

data/lib/contentful/management/webhook.rb

@@ -24,7 +24,7 @@ module Contentful
 
       # @private
       def self.create_attributes(_client, attributes)
-        attributes.select { |key, _value| [:httpBasicUsername, :httpBasicPassword, :url, :name, :headers, :topics].include? key }
+        attributes.select { |key, _value| %i[httpBasicUsername httpBasicPassword url name headers topics].include? key }
       end
 
       # Creates a webhook.

data/spec/fixtures/vcr_cassettes/api_key/create_with_environments.yml

@@ -0,0 +1,158 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/api_keys
+    body:
+      encoding: UTF-8
+      string: '{"name":"test with env","description":null,"environments":[{"sys":{"type":"Link","linkType":"Environment","id":"master"}},{"sys":{"type":"Link","linkType":"Environment","id":"testing"}}]}'
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/2.0.2; platform ruby/2.5.1; os macOS/16;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/2.2.2
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Accept-Ranges:
+      - bytes
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent,X-Contentful-Enable-Alpha-Feature
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cache-Control:
+      - max-age=0
+      Cf-Organization-Id:
+      - 4SsuxQCaMaemfIms52Jr8s
+      Cf-Space-Id:
+      - facgnwwgj5fe
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Tue, 15 May 2018 11:08:53 GMT
+      Etag:
+      - W/"63c2d753533d795321f09e08ecca0c17"
+      Location:
+      - https://api.contentful.com/spaces/facgnwwgj5fe/api_keys/29BbI2yvRgqGrKqA0Jfs2C
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35999'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Request-Id:
+      - ae22d7e31e07ae03cfa004a4aab0218c
+      X-Frame-Options:
+      - ALLOWALL
+      X-Xss-Protection:
+      - 1; mode=block
+      Content-Length:
+      - '1161'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_467_673446=JGyMEWxMIx1qE/oViR97BsS/+loAAAAAOLofxJ7nizcrbzabZLY1tA==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=CUHfeN0h7Rb9Sfr56lKYhQAAAADFhdA19R6fEVqqErPX2ZrC; path=/; Domain=.contentful.com
+      - visid_incap_673446=YaUkVgKbSwminuB6lMpCQ8S/+loAAAAAQUIPAAAAAAAZXdhM77WCeecx0WlfwwE9;
+        expires=Wed, 15 May 2019 07:47:46 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 3-701776-701780 NNNN CT(112 112 0) RT(1526382531872 61) q(0 0 2 -1) r(6 6)
+        U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |+
+        {
+          "name":"test with env",
+          "description":null,
+          "accessToken":"348518f9a8a4bde30eb9672d45de5e612010ee5271b05255ea986ab961661762",
+          "policies":[
+            {
+              "effect":"allow",
+              "actions":"all"
+            }
+          ],
+          "sys":{
+            "type":"ApiKey",
+            "id":"29BbI2yvRgqGrKqA0Jfs2C",
+            "version":0,
+            "space":{
+              "sys":{
+                "type":"Link",
+                "linkType":"Space",
+                "id":"facgnwwgj5fe"
+              }
+            },
+            "createdBy":{
+              "sys":{
+                "type":"Link",
+                "linkType":"User",
+                "id":"4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "createdAt":"2018-05-15T11:08:53Z",
+            "updatedBy":{
+              "sys":{
+                "type":"Link",
+                "linkType":"User",
+                "id":"4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "updatedAt":"2018-05-15T11:08:53Z"
+          },
+          "environments":[
+            {
+              "sys":{
+                "id":"master",
+                "type":"Link",
+                "linkType":"Environment"
+              }
+            },
+            {
+              "sys":{
+                "id":"testing",
+                "type":"Link",
+                "linkType":"Environment"
+              }
+            }
+          ],
+          "preview_api_key":{
+            "sys":{
+              "type":"Link",
+              "linkType":"PreviewApiKey",
+              "id":"29BPiYGUSf61b93lTZWbKW"
+            }
+          }
+        }
+
+    http_version: 
+  recorded_at: Tue, 15 May 2018 11:08:52 GMT
+recorded_with: VCR 4.0.0

data/spec/fixtures/vcr_cassettes/api_key/preview.yml

@@ -0,0 +1,288 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/api_keys/5mxNhKOZYOp1wzafOR9qPw
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/2.0.2; platform ruby/2.5.1; os macOS/16;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/2.2.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent,X-Contentful-Enable-Alpha-Feature
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cache-Control:
+      - max-age=0
+      Cf-Organization-Id:
+      - 4SsuxQCaMaemfIms52Jr8s
+      Cf-Space-Id:
+      - facgnwwgj5fe
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Tue, 15 May 2018 11:12:44 GMT
+      Etag:
+      - W/"87e77bf3868775cda5b9da89a4b1e149"
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35998'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Request-Id:
+      - 74b648b6f15e0e6bf835ff37bb820f9e
+      X-Frame-Options:
+      - ALLOWALL
+      X-Xss-Protection:
+      - 1; mode=block
+      Content-Length:
+      - '1060'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_467_673446=MtX5Bt6UCyf0t/oViR97BqvA+loAAAAAkjW5p6TsMPDtAZEbBxaI2g==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=ZwczeLNCryAOn4a26lKYhQAAAAD+xpwdhVPFZtQ1zX1nvNad; path=/; Domain=.contentful.com
+      - visid_incap_673446=QBHgG/q9Tq+ZKgk8cx0PV6vA+loAAAAAQUIPAAAAAABBnXt2Bz4P1TuDIMoO+hDg;
+        expires=Wed, 15 May 2019 07:47:40 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 10-1716806-1716814 NNNN CT(102 102 0) RT(1526382763486 58) q(0 0 2 -1) r(4
+        4) U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |+
+        {
+          "name":"management.py - playground 1",
+          "description":"",
+          "accessToken":"ba52beb5d428ca879aff9073cff7791f2c2ab9ff04a60911fec1ec3c80bcac6c",
+          "policies":[
+            {
+              "effect":"allow",
+              "actions":"all"
+            }
+          ],
+          "sys":{
+            "type":"ApiKey",
+            "id":"5mxNhKOZYOp1wzafOR9qPw",
+            "version":1,
+            "space":{
+              "sys":{
+                "type":"Link",
+                "linkType":"Space",
+                "id":"facgnwwgj5fe"
+              }
+            },
+            "createdBy":{
+              "sys":{
+                "type":"Link",
+                "linkType":"User",
+                "id":"4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "createdAt":"2018-02-27T10:19:59Z",
+            "updatedBy":{
+              "sys":{
+                "type":"Link",
+                "linkType":"User",
+                "id":"4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "updatedAt":"2018-02-27T10:20:13Z"
+          },
+          "environments":[
+            {
+              "sys":{
+                "id":"testing",
+                "type":"Link",
+                "linkType":"Environment"
+              }
+            }
+          ],
+          "preview_api_key":{
+            "sys":{
+              "type":"Link",
+              "linkType":"PreviewApiKey",
+              "id":"5mytqWZjcqEWMIHVfe5cUi"
+            }
+          }
+        }
+
+    http_version: 
+  recorded_at: Tue, 15 May 2018 11:12:44 GMT
+- request:
+    method: get
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/preview_api_keys/5mytqWZjcqEWMIHVfe5cUi
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/2.0.2; platform ruby/2.5.1; os macOS/16;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/2.2.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent,X-Contentful-Enable-Alpha-Feature
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cache-Control:
+      - max-age=0
+      Cf-Organization-Id:
+      - 4SsuxQCaMaemfIms52Jr8s
+      Cf-Space-Id:
+      - facgnwwgj5fe
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Tue, 15 May 2018 11:12:45 GMT
+      Etag:
+      - W/"f8047a35183c5d1c13a2ed8ddbc390e0"
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35997'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Request-Id:
+      - bd4b4ff9e62b3e208be9c798abae6795
+      X-Frame-Options:
+      - ALLOWALL
+      X-Xss-Protection:
+      - 1; mode=block
+      Content-Length:
+      - '932'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_467_673446=BPmedbScch9YuPoViR97BqzA+loAAAAAGCZbde/HHV9sM7ITMFmtqg==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=2DvcEriRfBTT9tsU6lKYhQAAAACE/17pda5G1ADz6Ja6KckH; path=/; Domain=.contentful.com
+      - visid_incap_673446=+4KFWFQ2QtmTh3Pfvu/nbazA+loAAAAAQUIPAAAAAADbpxpRhQbqdwZ3n4vPzqh9;
+        expires=Wed, 15 May 2019 07:47:46 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 8-376124-376127 NNNN CT(99 100 0) RT(1526382764088 90) q(0 0 2 -1) r(4 4)
+        U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |+
+        {
+          "name":"management.py - playground 1",
+          "description":null,
+          "accessToken":"PREVIEW_TOKEN",
+          "policies":[
+            {
+              "effect":"allow",
+              "actions":"all"
+            }
+          ],
+          "sys":{
+            "type":"PreviewApiKey",
+            "id":"5mytqWZjcqEWMIHVfe5cUi",
+            "version":0,
+            "space":{
+              "sys":{
+                "type":"Link",
+                "linkType":"Space",
+                "id":"facgnwwgj5fe"
+              }
+            },
+            "createdBy":{
+              "sys":{
+                "type":"Link",
+                "linkType":"User",
+                "id":"4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "createdAt":"2018-02-27T10:19:59Z",
+            "updatedBy":{
+              "sys":{
+                "type":"Link",
+                "linkType":"User",
+                "id":"4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "updatedAt":"2018-02-27T10:19:59Z"
+          },
+          "environments":[
+            {
+              "sys":{
+                "id":"master",
+                "type":"Link",
+                "linkType":"Environment"
+              }
+            }
+          ]
+        }
+
+    http_version: 
+  recorded_at: Tue, 15 May 2018 11:12:44 GMT
+recorded_with: VCR 4.0.0

data/spec/lib/contentful/management/api_key_spec.rb

@@ -5,7 +5,7 @@ require 'contentful/management/client'
 module Contentful
   module Management
     describe ApiKey do
-      let(:token) { '<ACCESS_TOKEN>' }
+      let(:token) { ENV.fetch('CF_TEST_CMA_TOKEN', '<ACCESS_TOKEN>') }
       let(:space_id) { 'bjwq7b86vgmm' }
       let(:api_key_id) { '6vbW35TjBTc8FyRTAuXZZe' }
 
@@ -55,6 +55,53 @@ module Contentful
           end
         end
       end
+
+      describe 'environments' do
+        let(:space_id) { 'facgnwwgj5fe' }
+        subject { client.api_keys(space_id) }
+
+        it 'can create an api key with environments' do
+          vcr('api_key/create_with_environments') {
+            api_key = subject.create(name: 'test with env', environments: [
+              {
+                sys: {
+                  type: 'Link',
+                  linkType: 'Environment',
+                  id: 'master'
+                }
+              },
+              {
+                sys: {
+                  type: 'Link',
+                  linkType: 'Environment',
+                  id: 'testing'
+                }
+              }
+            ])
+            expect(api_key.environments.size).to eq 2
+            expect(api_key.environments.first.id).to eq 'master'
+            expect(api_key.environments.last.id).to eq 'testing'
+          }
+        end
+      end
+
+      describe 'preview api tokens' do
+        let(:space_id) { 'facgnwwgj5fe' }
+        let(:api_key_id) { '5mxNhKOZYOp1wzafOR9qPw' }
+        subject { client.api_keys(space_id) }
+
+        it 'can fetch preview api keys' do
+          vcr('api_key/preview') {
+            api_key = subject.find(api_key_id)
+
+            expect(api_key.properties[:preview_api_key]).to be_a Contentful::Management::Link
+
+            preview_api_key = api_key.preview_api_key
+            expect(preview_api_key).to be_a Contentful::Management::PreviewApiKey
+            expect(preview_api_key.access_token).to eq 'PREVIEW_TOKEN'
+          }
+        end
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: contentful-management
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.1.0
 platform: ruby
 authors:
 - Piotr Protas
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-04-18 00:00:00.000000000 Z
+date: 2018-05-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -192,14 +192,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.41.0
+        version: 0.49.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.41.0
+        version: 0.49.1
 - !ruby/object:Gem::Dependency
   name: listen
   requirement: !ruby/object:Gem::Requirement
@@ -307,6 +307,7 @@ files:
 - lib/contentful/management/client_locale_methods_factory.rb
 - lib/contentful/management/client_organization_methods_factory.rb
 - lib/contentful/management/client_personal_access_tokens_methods_factory.rb
+- lib/contentful/management/client_preview_api_key_methods_factory.rb
 - lib/contentful/management/client_role_methods_factory.rb
 - lib/contentful/management/client_snapshot_methods_factory.rb
 - lib/contentful/management/client_space_membership_methods_factory.rb
@@ -342,6 +343,7 @@ files:
 - lib/contentful/management/location.rb
 - lib/contentful/management/organization.rb
 - lib/contentful/management/personal_access_token.rb
+- lib/contentful/management/preview_api_key.rb
 - lib/contentful/management/request.rb
 - lib/contentful/management/resource.rb
 - lib/contentful/management/resource/all_published.rb
@@ -365,6 +367,7 @@ files:
 - lib/contentful/management/space_association_methods_factory.rb
 - lib/contentful/management/space_environment_methods_factory.rb
 - lib/contentful/management/space_membership.rb
+- lib/contentful/management/space_preview_api_key_methods_factory.rb
 - lib/contentful/management/space_role_methods_factory.rb
 - lib/contentful/management/space_space_membership_methods_factory.rb
 - lib/contentful/management/space_webhook_methods_factory.rb
@@ -407,8 +410,10 @@ files:
 - spec/fixtures/pixel.jpg
 - spec/fixtures/vcr_cassettes/api_key/all_for_space.yml
 - spec/fixtures/vcr_cassettes/api_key/create_for_space.yml
+- spec/fixtures/vcr_cassettes/api_key/create_with_environments.yml
 - spec/fixtures/vcr_cassettes/api_key/find.yml
 - spec/fixtures/vcr_cassettes/api_key/find_for_space_not_found.yml
+- spec/fixtures/vcr_cassettes/api_key/preview.yml
 - spec/fixtures/vcr_cassettes/array_page_1.yml
 - spec/fixtures/vcr_cassettes/asset/143_assets_next_page.yml
 - spec/fixtures/vcr_cassettes/asset/all.yml
@@ -784,8 +789,10 @@ test_files:
 - spec/fixtures/pixel.jpg
 - spec/fixtures/vcr_cassettes/api_key/all_for_space.yml
 - spec/fixtures/vcr_cassettes/api_key/create_for_space.yml
+- spec/fixtures/vcr_cassettes/api_key/create_with_environments.yml
 - spec/fixtures/vcr_cassettes/api_key/find.yml
 - spec/fixtures/vcr_cassettes/api_key/find_for_space_not_found.yml
+- spec/fixtures/vcr_cassettes/api_key/preview.yml
 - spec/fixtures/vcr_cassettes/array_page_1.yml
 - spec/fixtures/vcr_cassettes/asset/143_assets_next_page.yml
 - spec/fixtures/vcr_cassettes/asset/all.yml