Export API Mapper Set By Filter

06 Jan 2025
5 Minutes to read

Print
Dark
Light
PDF

Export API Mapper Set By Filter

Updated on 06 Jan 2025
5 Minutes to read

Print
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback

Get

/api/1.0/api-mapper-sets/{envId}

Export API Mapper Set from the indicated Environment. This API is designed to support EXPORT (read) operations in API Mapper Sets.

Notice

Accessing the APIs is through a dedicated domain/URL, according to your PlainID Tenant Location

United States (US) - `https://API.us1.plainid.io`

Canada (CA) - `https://api.ca1.plainid.io`

Europe (EU) - `https://api.eu1.plainid.io`

Using HTML Encoded Special Characters

Use HTML encoded patterns when working with values that contain special characters like spaces, dashes, etc. Refer to this HTML URL Encoding Reference for a full list.

Important note about headers

Refer to the headers below to modify your cURL sample. Check if the following headers are in the sample, if not, ensure you add it to your cURL sample before pasting into your API tool.

Headers

*Required

Header	Value	cURL Line
Accept	`application/json`	`-H "Accept:application/json"`

cURL Sample Guidelines

In order for the relevant parameters to appear in the cURL sample, you can input the values in the interactive API console on the right. They will then appear in the cURL sample on the bottom of the page in the correct format.

Security

HTTP

Type bearer

For more details about Administration API Authentication, check out the Authentication APIs documentation. Provide your bearer token in the Authorization header when making requests to protected resources. Example: Authorization: Bearer 123

Path parameters

envId

string (uuid) Required

The Environment ID can be found under the Details Tab in the Environment Settings.

Query parameters

offset

integer

The starting point for return of records

limit

integer

Limit the number of records returned

sort

Sorting order for API mappers set list

object

priority

string

Field for sort

Valid values[ "ASC", "DESC" ]

filter

Required

Filter to apply on api mapper set list

object

applicationId

string (uuid) Required

Application id

Responses

200

Successful operation

Headers

x-request-id

string

The ID of the request

example

{
  "data": [
    {
      "apiMappersSetId": "App1",
      "applicationIds": [
        "App1"
      ],
      "apiMappers": [
        {
          "mapperId": "mapper_1",
          "displayName": "mapper-1",
          "isActive": true,
          "matchPattern": "/bank/*/accountNum/**",
          "matchType": "EXACT",
          "restMethods": [
            "GET",
            "POST"
          ],
          "priority": 1,
          "isRequireIdentitySourcesFiltering": true,
          "filteringType": "INCLUDE",
          "identitySourceIds": [
            "sourceId1234567"
          ],
          "assetTemplates": [
            {
              "templateId": "accounts",
              "attributes": [
                {
                  "attributeId": "acctType",
                  "source": "PATH",
                  "path": "[0]"
                }
              ],
              "actions": [
                {
                  "actionId": "read",
                  "source": "BODY",
                  "value": "fetchData",
                  "path": "$.function"
                }
              ]
            },
            {
              "templateId": "loans",
              "attributes": [],
              "actions": []
            }
          ]
        },
        {
          "mapperId": "mapper_2",
          "displayName": "mapper-2",
          "description": "desc",
          "isActive": true,
          "matchPattern": "/bank/*/loans/**",
          "matchType": "EXACT",
          "restMethods": [
            "POST"
          ],
          "priority": 2,
          "isRequireIdentitySourcesFiltering": false,
          "filteringType": "INCLUDE",
          "identitySourceIds": [
            "sourceId1234567"
          ],
          "assetTemplates": [
            {
              "templateId": "loans",
              "attributes": [],
              "actions": []
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

Expand All

object

Response object

data

Array of object (ApiMapperSet)

object

API Mapper Set

apiMappersSetId

string

API Mapper Set Unique Identifier.

Min length1

Max length128

Pattern^[a-zA-Z0-9_:.-]+$

applicationIds

Array of string

Associated Application IDs. These IDs can be found in the individual Application Details section under Application ID.

string

apiMappers

Array of object (ApiMapper)

object

API Mapper

mapperId

string

API Mapper Unique Identifier. This can be found the API Mappers details section within the relevant Application.

Min length1

Max length128

Pattern^[a-zA-Z0-9_:.-]+$

displayName

string

API Mapper Name

Min length1

Max length100

description

string

API Mapper Description

Max length200

isActive

boolean

Indicates if the Mapper is active.

matchPattern

string

The URL pattern to which the Mapper applies.

matchType

string

Indicates if the matching is performed using a wildcard or exact match.

Valid values[ "EXACT", "WILDCARDS", "REGEX" ]

restMethods

Array of string

HTTP Methods that are applicable for the pattern.

string

Valid values[ "GET", "POST", "PUT", "PATCH", "DELETE" ]

priority

number

Mapper priority. Set the API Mapper priority to adjust the processing priority. For more information, see Managing API Mappers.

isRequireIdentitySourcesFiltering

boolean

Indicates if the API Mapper requires Identity Source filtering.

filteringType

string

Indicates which Identity Source filtering type is required. This parameter is required if isRequireIdentitySourcesFiltering is set to true.

Valid values[ "INCLUDE", "EXCLUDE" ]

identitySourceIds

Array of string

Indicates which Identity Sources need to be filtered. This parameter is required if isRequireIdentitySourcesFiltering is set to true. This can be located in the Attribute Source tab in the Identity Workspace Settings.

string

assetTemplates

Array of object (AssetTemplateApiMapping)

A list of Asset Templates associates with the API Mappers. You can locate Asset Template IDs under the relevant Assets' Details tab.

object

asset template api mapping

templateId

string

Asset Template unique identifier. You can locate the relevant Asset Template ID under the relevant Asset details.

attributes

Array of object (AssetAttributesApiMapping)

List of Attributes associated with the Asset Template containing API Mappers. You can locate the relevant Attribute IDs under the relevant Assets' Asset Attribute tab.

object

attributeId

string

Attribute unique identifier. You can locate the relevant Attribute ID under the relevant Asset's Asset Attribute tab.

source

string

Attribute Source. You can locate it in the Attribute Mapping Settings section under the relevant Asset Type's Asset Attribute.

Valid values[ "BODY", "HEADER", "PATH", "URI_REGEX" ]

path

string

JSON Path or relevant Path for the Attribute. You can locate it in the Attribute Mapping Settings section under the relevant Asset Type's Asset Attribute tab.

actions

Array of object (ActionApiMapping)

A list of Actions associated with the Asset Template. You can locate the relevant Action IDs under the relevant Assets' Actions tab.

object

actionId

string

Action unique identifier. You can locate the relevant Action ID under the relevant Asset Type's Actions tab.

source

string

Action source. You can locate it in the API Action Mappers section under the relevant Asset Type's Action tab.

Valid values[ "BODY", "HEADER", "PATH", "METHOD", "URI_REGEX" ]

value

string

Action value. You can locate it in the API Action Mappers section under the relevant Asset Type's Action tab.

path

string

Action path. You can locate it in the API Action Mappers section under the relevant Asset Type's Action tab.

What's Next

Export API Mapper Set