Cloudflare

Cloudflare API Client. NOT OFFICIAL. Written for the Elixir community, based on :restlax.

Installation

If available in Hex, the package can be installed by adding cloudflare to your list of dependencies in mix.exs:

def deps do
  [
    {:cloudflare, "~> 0.1.0"}
  ]
end

Configuration

config :cloudflare,
  auth_token: "my-auth-token"

Or

config :cloudflare,
  auth_email: "my@email.com",
  auth_key: "my-auth-key"

Or both ¯\(°_o)/¯.

Or passed in

Cloudflare.Zone.index(opts: [auth_token: "my-auth-token"])

Cloudflare.Zone.index(opts: [auth_email: "my@email.com", auth_key: "my-auth-key"])

Or directly as header

Cloudflare.Zone.index(headers: [{"Authorization", "Bearer my-auth-token"}])

Cloudflare.Zone.index(headers: [{"X-Auth-Email", "my@email.com"}, {"X-Auth-Key", "my-auth-key"}])

Usage

Cloudflare.Zone.index()

Cloudflare.DnsRecord.index(params: [zone_id: "my-zone-id"])

Cloudflare.DnsRecord.create(
  %{type: "A", name: "my.domain", content: "127.0.0.1", ttl: 120},
  params: [zone_id: "my-zone-id"]
)

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/cloudflare.

Development

Half manually scraped Cloudflare docs are located in priv/docs. Pick an entity and write module for it.

Simple entities can be as easy as Cloudflare.Account and Cloudflare.User

Some need a little customization like Cloudflare.DnsRecord

Some need more Cloudflare.ZoneSetting