In this

article

Overview

In the 4.25 release (May 2021), we are introducing the API Management - Design First feature that, when combined with the existing API Policy Manager, provides API management capabilities from development to monitoring. You can create APIs in SnapLogic using from your own API specifications . When you import or reference an API specification to the new /apim space, a new API asset is created. The new API comprises a Pipeline that is the scaffolding for the API and the Task used to call it. You can then create versions, add API policies, set permissions, and modify the underlying SnapLogic assets to build the business logic for your API.

Key Features

or from your SnapLogic Pipelines and Assets. To make your APIs available to users outside SnapLogic, you can publish those APIs in a Developer Portal that is customized with your own branding. You can also create proxies to allow you to integrate with third-party APIs.

Your API serves as a container for SnapLogic Assets:

• Pipelines. A representation of the API specification and its child Pipelines, if any. Provides the scaffolding of the API’s implementation in the SnapLogic platform.

• Tasks. The URI endpoints that are used to trigger Pipeline execution.

• Files. The specification file and other files that are associated with the API.

• Accounts. Accounts that are used by Pipelines in the API.

Key Features and Components

SnapLogic provides API Management features and components to help you develop APIs, manage their lifecycles, and monitor their performance.

Features include:

• Support for Design First. API Management supports the creation of APIs from the Open API Specification (OAS) 3.0 or 2.0. You can design an API based on your specification

  and

  , then upload a file

  of it

  or reference a URL

  with the specification.Versioning: The ability to create multiple versions of an API based using an OAS 2.0 specification

  containing your specification. Both JSON and YAML file formats are supported.

• API Lifecycle Management. You can manage the entire lifecycle of an API or API version from creation to publication to deprecation to retirement.

• Multiple API Versions. You can modify the initial specification

  for

  of your

  initial

  API, then create and publish a new

  versions

  version from

  those

  the modified specification

  versions

  .

• Hierarchy Permissions: A comprehensive set of permission types that provides an Org admins the ability to define permissions at every level of the hierarchy. As an API developer, you can set permissions on your versions.
Suite of API Policies: The Manage API Policy wizard that enables you to enable various

Components include:

• API Manager. The console where you manage your APIs.

• Portal Manager. The console where you set up and manage your custom Developer Portal.

• Developer Portal. The custom site where you publish your APIs for consumption. In this site, API consumers can search and browse through your API Catalog and try out your APIs. Each API provides basic documentation and its specification. Users with a SnapLogic platform login can open the Developer Portal with one click from the Resources section of the Apps menu:

  Image Added

• Subscription Manager. The console where you can approve and manage subscriptions to published APIs.

• API Policies. A suite of security policies that handle authorization, authentication, and traffic control to manage access to your APIs. You can apply these policies at

the /apim space, API, and Version levels

• various levels, such as the Org, the API, the API version, the shared folder of the Project Space, and Projects. Org Administrators can define permissions at very level of the hierarchy; API developers can set permissions on their own API versions.

• API Dashboard

: The dashboard displays

• . The API tab in Dashboard where you can view the usage and traffic metrics of your APIs.

As an Org admin or Pipeline Designer, you

• You can track the popularity of an API or analyze target and response errors to understand how to enhance the API consumer experience

. 

• .

• APIM tab in the Activity Log: The APIM tab allows you to track changes to APIs published to the Developer Portal in addition to changes to the Developer Portal membership and subscription request status.

• Support for Git integration. You can now effectively manage your API versions by associating them to source control repositories like Git and other Git hosting options supported by SnapLogic. You can create APIs from Git repositories, reusing existing SnapLogic Assets tracked in Git. Your Org must have Git integration set up. With Git integration, you can track, update, and manage versions of SnapLogic project files, pipelines, tasks, and accounts, using either the SnapLogic graphical interface or the SnapLogic Public APIs. When you create API Versions using SnapLogic Assets, the APIM console displays the Git operations available to you.