Generate client code for your API collections

You can generate client code for your API collections in Postman. Postman’s Node.js code generator module converts a request into client code for your target language in conjunction with the Collection SDK.

The code generator takes a Collection SDK request object and turns it into code to make the same request in a client app using the specified language and framework.

You can install the code generator library from npm or by cloning it from its GitHub repo. To get started, check out the code generator module README.

Generate code programmatically

The following simplified code excerpt demonstrates using convert to build a client code snippet from a Request object with the Collection SDK, targeting Node.js:

1
var codegen = require('postman-code-generators'),
2
  sdk = require('postman-collection'),
3
  request = new sdk.Request('https://www.google.com'),
4
  language = 'nodejs',
5
  variant = 'request',
6
  options = {
7
    indentCount: 3,
8
    indentType: 'Space',
9
    trimRequestBody: true,
10
    followRedirect: true
11
  };
12
codegen.convert(language, variant, request, options,
13
  function(error, snippet) {
14
    if (error) {
15
      //  handle error
16
    }
17
    //  handle snippet..
18
});

You can use the getOptions method to find config options for your target language:

1
var codegen = require('postman-code-generators'),
2
  language = 'nodejs',
3
  variant = 'Request';
4
5
codegen.getOptions(language, variant, function (error, options) {
6
  if (error) {
7
    // handle error
8
  }
9
  console.log(options);
10
});

The getLanguageList method returns available languages your request client code can target:

1
var codegen = require('postman-code-generators'),
2
  supportedCodegens = codegen.getLanguageList();
3
  console.log(supportedCodegens);

Supported languages

The code generator module is an open-source project. If there is a language or framework you’d like to generate client code for, but it isn’t provided, you can add it by contributing to the project. This lets other users access your contribution both in the repo and in Postman itself.

Next steps

If you’re using Postman to work with client applications, you can also capture request data. Learn more about capturing request data.