这是indexloc提供的服务，不要输入任何密码

​
Why doesn’t Zapier support newer versions of Node.js?

We run your code on AWS Lambda, which only supports a few versions of Node. Sometimes that doesn’t include the latest version. Additionally, with thousands of integrations running on the Zapier platform, we have to be sure upgrading to the latest Node version will not have a negative impact.

​
How do I manually set the Node.js version to run my integration with?

Update your zapier-platform-core dependency in package.json. Each major version ties to a specific version of Node.js. You can find the mapping here. We only support the version(s) supported by AWS Lambda. IMPORTANT CAVEAT: AWS periodically deprecates Node versions as they reach EOL. They announce this on their blog. Similar info and dates are available on github. Well before this date, we’ll have a version of core that targets the newer Node version. If you don’t upgrade before the cutoff date, there’s a chance that AWS will throw an error when attempting to run your integration’s code. If that’s the case, we’ll instead run it under the oldest Node version still supported. All that is to say, we may run your code on a newer version of Node.js than you intend if you don’t update your integration’s dependencies periodically.

​
When to use placeholders or curlies?

You will see both template literal placeholders ${var} and (double) “curlies” {{var}} used in examples.
Rule of thumb: Use ${var} inside functions, and {{var}} in shorthand requests.
Template literal placeholders get evaluated as soon as the line of code is executed. This means that if you use ${process.env.VAR} in a shorthand request for a trigger configuration, zapier push will substitute it with your local environment’s value for VAR when it builds your integration, so the value set via zapier env:set will not be used. If you’re not familiar with template literals, know that const val = "a" + b + "c" is essentially the same as: 
const val = `a${b}c`;
Since v17, z.request() throws an error if there’s {{var}} in the request object.

​
Does Zapier support XML (SOAP) APIs?

Not natively, but it can! Users have reported that the following npm modules are compatible with the CLI Platform: Since core v10, it’s possible for shorthand requests to parse XML. Use an afterResponse middleware that sets response.data to the parsed XML: 
const xml = require("pixl-xml");

const App = {
  // ...
  afterResponse: [
    (response, z, bundle) => {
      // Only works on core v10+!
      response.throwForStatus();
      response.data = xml.parse(response.content);
      return response;
    },
  ],
  // ...
};

​
What’s the deal with pagination? When is it used and how does it work?

Moved to paging.

​
How does deduplication work?

Each time a polling Zap runs, Zapier extracts a unique “primary key” for each item in the response. Zapier needs to decide which of the items should trigger the Zap. To do this, we compare the primary keys to all those we’ve seen before, trigger on new objects, and update the list of seen primary keys. When a Zap is turned on, we initialize the list of seen primary keys with a single poll. When it’s turned off, we clear that list. For this reason, it’s important that calls to a polling endpoint always return the newest items. For example, the initial poll returns objects 4, 5, and 6 (where a higher primary key is newer). If a later poll increases the limit and returns objects 1-6, then 1, 2, and 3 will be (incorrectly) treated like new objects. By default, the primary key is the item’s id field. Since v15.6.0, you can customize the primary key by setting primary to true in outputFields. There’s a more in-depth explanation here.

​
Why are my triggers complaining if I don’t provide an explicit id field?

For deduplication to work, we need to be able to identify and use a unique field. In older, legacy Zapier Web Builder integrations, we guessed if id wasn’t present. In order to ensure we don’t guess wrong, we now require that the developers send us an id field. If your objects have a differently-named unique field, feel free to adapt this snippet and ensure this test passes: 
// ...
let items = response.data.items; // or response.json.items if you're using core v9 or older
return items.map((item) => {
  item.id = item.contactId;
  return item;
});
Since v15.6.0, instead of using the default id field, you can also define one or more outputFields as primary. For example: 
{
  triggers: {
    recipe: {
      operation: {
        outputField: [
          { key: "userId", primary: true },
          { key: "slug", primary: true },
          { key: "name" },
        ];
      }
    }
  }
}
will tell Zapier to use (userId, slug) as the unique primary key to deduplicate items when running a polling trigger. Limitation: The primary option currently doesn’t support mixing top-level fields with nested fields that use double underscores in their keys. For example, if you set primary: true on both id and user__id, the primary setting on the user__id field will be ignored; only id will be used for deduplication. However, if all the primary fields are all nested, such as user__id + user__name, it will work as expected.

​
Node X No Longer Supported

If you’re seeing errors like the following: 
InvalidParameterValueException An error occurred (InvalidParameterValueException) when calling the CreateFunction operation: The runtime parameter of nodejs6.10 is no longer supported for creating or updating AWS Lambda functions. We recommend you use the new runtime (nodejsX.Y) while creating or updating functions.
… then you need to update your zapier-platform-core dependency to a non-deprecated version that uses a newer version of Node.js. Complete the following instructions as soon as possible:
  1. Edit package.json to depend on a later major version of zapier-platform-core. There’s a list of all breaking changes (marked with a :exclamation:) in the changelog.
  2. Increment the version property in package.json
  3. Ensure you’re using version v18 (or greater) of node locally (node -v). Use nvm to use a different one if need be.
  4. Run rm -rf node_modules && npm i to get a fresh copy of everything
  5. Run zapier test to ensure your tests still pass
  6. Run zapier push
  7. Run zapier promote YOUR_NEW_VERSION (from step 2)
  8. Migrate your users from the previous version (zapier migrate OLD_VERSION YOUR_NEW_VERSION)

​
What Analytics are Collected?

Starting with v8.4.0, Zapier collects information about each invocation of the CLI tool. This data is collected purely to improve the CLI experience and will never be used for advertising or any non-product purpose. There are 3 collection modes that are set on a per-computer basis. Anonymous When you run a command with analytics in anonymous mode, the following data is sent to Zapier:
  • which command you ran
  • if that command is a known command
  • how many arguments you supplied (but not the contents of the arguments)
  • which flags you used (but not their contents)
  • the version of CLI that you’re using
  • the integration app the CLI commands are run in
Enabled (the default) When analytics are fully enabled, the above is sent, plus:
  • your operating system (the result of calling process.platform)
  • your Zapier user id
Disabled Lastly, analytics can be disabled entirely, either by running zapier analytics --mode disabled or setting the DISABLE_ZAPIER_ANALYTICS environment variable to 1. We take great care not to collect any information about your filesystem or anything otherwise secret. You can see exactly what’s being collecting at runtime by prefixing any command with DEBUG=zapier:analytics.

​
What’s the Difference Between an “App” and an “Integration”?

We’re in the process of doing some renaming across our Zapier marketing terms. Eventually we’ll use “integration” everywhere. Until then, know that these terms are interchangeable and describe the code that you write that connects your API to Zapier.

​
What does performGet do?

The performGet method is an optional feature in Zapier that allows you to retrieve detailed information about an object. For instance, if your create action’s perform method only returns the new object’s ID, you can use performGet to fetch the object’s full properties using that ID. performGet is only available for Create or Search actions and is most useful when the initial perform result is limited, and additional information is needed. The results from perform are automatically passed to performGet via bundle.inputData each time the create or search runs, allowing you to retrieve more comprehensive details. It’s important to note that performGet is only invoked when the result returned by perform is not empty.