node package manager
Stop wasting time. Easily manage code sharing in your team. Create a free org »

cloudflare

Cloudflare Node.js bindings

Cloudflare v4 API bindings for Node.js, providing a sourdough "BREAD" (Browse, Read, Edit, Add, and Delete) interface.

With these bindings, you'll get the following features:

  • A Promise-based API. With modern versions of Node.js, this can be leveraged for async/await and generator support.
  • Automatic handling of Gzip/Deflate compression.

Node.js v4 and greater are supported.

Configuration

Set your account email address and API key. The API key can be found on the My Account page in the Cloudflare dashboard.

var cf = require('cloudflare')({
  email: 'you@example.com',
  key: 'your Cloudflare API key'
});

API Overview

Every resource is accessed via your cf instance:

// cf.{ RESOURCE_NAME }.{ METHOD_NAME } 

Every resource method returns a promise, which can be chained or used with async/await.

cf.zones.read('023e105f4ecef8ad9ca31a8372d0c353').then(function (resp) {
  return resp.result.status;
});
 
 
// where supported 
async function getZoneStatus(id) {
  var resp = await cf.zones.read('023e105f4ecef8ad9ca31a8372d0c353');
  return resp.result.status;
}

Available resources and methods

  • dnsRecords
    • browse()
    • read(dnsRecordId)
    • edit(dnsRecordId, params)
    • add(params)
    • del(dnsRecordId)
  • ips
    • browse()
  • zones
    • browse()
    • read(zoneId)
    • edit(zoneId, params)
    • add(params)
    • del(zoneId)
    • activationCheck(zoneId)
    • purgeCache(zoneId, params)
  • user
    • read()
    • edit(params)

how? learn more

Collaborators list

Stats

Try it out

Keywords

cloudflare, api

Dependencies (6)

autocreate, es-class, got, object-assign, url-join, url-pattern

Dependents (17)

ranflare, le-challenge-cloudflare, nginx-zero, cloudflare-batch-cli, cloudflare-dynamic-dns2, cloudflare-ddos-enable, grunt-cloudflarev4, flarectl, dynamic_dns, impequid-dynamic-dns, cloudflare-cli, cloudflare-heimdall, cf-dns-updater, core-server, and more