zeit / Now Client
Programming Languages
Labels
Projects that are alternatives of or similar to Now Client
now client
DEPRECATED: Read more here.
The official JavaScript client for interacting with the now instant API (please note that this API only allows you to send strings, it doesn't support streaming - but binary files can be encoded as base64 strings).
Usage
Firstly, install the package using npm:
npm install --save now-client
Next, load it:
const NowClient = require('now-client')
Then initialize it:
-
<token>holds your token, which can obtained here (optional, will read from~/.now/auth.jsonif not defined - you can also define it using theNOW_TOKENenvironment variable) -
<team>specifies the ID of the team to which the actions should apply (optional)
const now = new NowClient(<token>, <team>)
And finally, you can use its methods to retrieve data:
await now.getDeployments()
API Reference
Kind: global class
-
Now
- new Now([token])
-
.getDeployments([callback]) ⇒
Promise -
.getDeployment(id, [callback]) ⇒
Promise -
.createDeployment(body, [callback]) ⇒
Promise -
.deleteDeployment(id, [callback]) ⇒
Promise -
.getFiles(id, [callback]) ⇒
Promise -
.getFile(id, fileId, [callback]) ⇒
Promise -
.getDomains([callback]) ⇒
Promise -
.addDomain(domain, [callback]) ⇒
Promise -
.deleteDomain(name, [callback]) ⇒
Promise -
.getCertificates([cn], [callback]) ⇒
Promise -
.createCertificate(cn, [callback]) ⇒
Promise -
.renewCertificate(cn, [callback]) ⇒
Promise -
.replaceCertificate(cn, cert, key, [ca], [callback]) ⇒
Promise -
.deleteCertificate(cn, [callback]) ⇒
Promise -
.getAliases([id OR callback], [callback]) ⇒
Promise -
.createAlias(id, alias, [callback]) ⇒
Promise -
.deleteAlias(id, [callback]) ⇒
Promise -
.getSecrets([id OR callback], [callback]) ⇒
Promise -
.createSecret(name, value, [callback]) ⇒
Promise -
.renameSecret(id, name, [callback]) ⇒
Promise -
.deleteSecret(id, [callback]) ⇒
Promise
new Now([token])
Initializes the API. Looks for token in ~/.now.json if none is provided.
| Param | Type | Description |
|---|---|---|
| [token] | String |
Your now API token. |
now.getDeployments([callback]) ⇒ Promise
Returns an array with all deployments.
Kind: instance method of Now
See: https://zeit.co/api#list-endpoint
| Param | Type | Description |
|---|---|---|
| [callback] | function |
Callback will be called with (err, deployments)
|
now.getDeployment(id, [callback]) ⇒ Promise
Returns an object with deployment data.
Kind: instance method of Now
See: https://zeit.co/api#get-endpoint
| Param | Type | Description |
|---|---|---|
| id | String |
ID of deployment |
| [callback] | function |
Callback will be called with (err, deployment)
|
now.createDeployment(body, [callback]) ⇒ Promise
Creates a new deployment and returns its data.
Kind: instance method of Now
See: https://zeit.co/api#instant-endpoint
| Param | Type | Description |
|---|---|---|
| body | Object |
The keys should represent a file path, with their respective values containing the file contents. |
| [callback] | function |
Callback will be called with (err, deployment)
|
now.deleteDeployment(id, [callback]) ⇒ Promise
Deletes a deployment and returns its data.
Kind: instance method of Now
See: https://zeit.co/api#rm-endpoint
| Param | Type | Description |
|---|---|---|
| id | String |
ID of deployment |
| [callback] | function |
Callback will be called with (err, deployment)
|
now.getFiles(id, [callback]) ⇒ Promise
Returns an array with the file structure.
Kind: instance method of Now
See: https://zeit.co/api#file-structure-endpoint
| Param | Type | Description |
|---|---|---|
| id | String |
ID of deployment |
| [callback] | function |
Callback will be called with (err, fileStructure)
|
now.getFile(id, fileId, [callback]) ⇒ Promise
Returns the content of a file either as string or object, depending on the filetype.
Kind: instance method of Now
See: https://zeit.co/api#file--endpoint
| Param | Type | Description |
|---|---|---|
| id | String |
ID of deployment |
| fileId | String |
ID of the file |
| [callback] | function |
Callback will be called with (err, fileContent)
|
now.getDomains([callback])] ⇒ Promise
Returns an array with all domain names and related aliases.
Kind: instance method of Now
See: https://zeit.co/api#get-domains
| Param | Type | Description |
|---|---|---|
| [callback] | function |
Callback will be called with (err, domains)
|
now.addDomain(domain, [callback])] ⇒ Promise
Adds a new domain and returns its data.
Kind: instance method of Now
See: https://zeit.co/api#post.domains
| Param | Type | Description |
|---|---|---|
| domain | object |
An object containing a string name and a boolean isExternalDNS
|
| [callback] | function |
Callback will be called with (err)
|
now.deleteDomain(name, [callback])] ⇒ Promise
Deletes a domain name.
Kind: instance method of Now
See: https://zeit.co/api#delete-domains
| Param | Type | Description |
|---|---|---|
| name | String |
Domain name |
| [callback] | function |
Callback will be called with (err)
|
now.getDomainRecords(domain, [callback])] ⇒ Promise
Returns an array with all DNS records configured for a domain name.
Kind: instance method of Now
See: https://zeit.co/api#get-domain-records
| Param | Type | Description |
|---|---|---|
| name | String |
Domain name |
| [callback] | function |
Callback will be called with (err, domains)
|
now.addDomainRecord(domain, recordData, [callback])] ⇒ Promise
Adds a new DNS record for a domain.
Kind: instance method of Now
See: https://zeit.co/api#post-domain-records
| Param | Type | Description |
|---|---|---|
| domain | String |
Domain name |
| recordData | object |
An object containing a description of the new record according to the documentation. |
| [callback] | function |
Callback will be called with (err)
|
now.deleteDomainRecord(name, recordId, [callback])] ⇒ Promise
Deletes a DNS record associated with a domain.
Kind: instance method of Now
See: https://zeit.co/api#delete-domain-records
| Param | Type | Description |
|---|---|---|
| domain | String |
Domain name |
| recordId | String |
Record ID |
| [callback] | function |
Callback will be called with (err)
|
now.getCertificates([cn], [callback])] ⇒ Promise
Returns an array of all certificates.
Kind: instance method of Now
See: https://zeit.co/api#get-certs
| Param | Type | Description |
|---|---|---|
| [cn] | String |
Common Name |
| [callback] | function |
Callback will be called with (err, certs)
|
now.createCertificate(cn, [callback])] ⇒ Promise
Creates a new certificate for a domain registered to the user.
Kind: instance method of Now
See: https://zeit.co/api#post-certs
| Param | Type | Description |
|---|---|---|
| cn | String |
Common Name |
| [callback] | function |
Callback will be called with (err)
|
now.renewCertificate(cn, [callback])] ⇒ Promise
Renews an existing certificate.
Kind: instance method of Now
See: https://zeit.co/api#post-certs
| Param | Type | Description |
|---|---|---|
| cn | String |
Common Name |
| [callback] | function |
Callback will be called with (err)
|
now.replaceCertificate(cn, cert, key, [ca], [callback])] ⇒ Promise
Replace an existing certificate.
Kind: instance method of Now
See: https://zeit.co/api#put-certs
| Param | Type | Description |
|---|---|---|
| cn | String |
Common Name |
| cert | String |
X.509 certificate |
| key | String |
Private key for the certificate |
| ca | String |
CA certificate chain |
| [callback] | function |
Callback will be called with (err, created)
|
now.deleteCertificate(cn, [callback])] ⇒ Promise
Deletes a certificate.
Kind: instance method of Now
See: https://zeit.co/api#delete-certs
| Param | Type | Description |
|---|---|---|
| cn | String |
Common Name |
| [callback] | function |
Callback will be called with (err)
|
now.getAliases([id OR callback], [callback]) ⇒ Promise
Returns an array with all aliases.
Kind: instance method of Now
See: https://zeit.co/api#user-aliases
| Param | Type | Description |
|---|---|---|
| [id OR callback] |
String | function
|
ID of deployment or callback |
| [callback] | function |
Callback will be called with (err, aliases)
|
now.createAlias(id, alias, [callback]) ⇒ Promise
Creates an alias for the given deployment.
Kind: instance method of Now
See: https://zeit.co/api#create-alias
| Param | Type | Description |
|---|---|---|
| id | String |
ID of deployment |
| alias | String |
Hostname or custom url for the alias |
| [callback] | function |
Callback will be called with (err, data)
|
now.deleteAlias(id, [callback]) ⇒ Promise
Deletes an alias and returns a status.
Kind: instance method of Now
See: https://zeit.co/api#delete-user-aliases
| Param | Type | Description |
|---|---|---|
| id | String |
ID of alias |
| [callback] | function |
Callback will be called with (err, status)
|
now.getSecrets([id OR callback], [callback]) ⇒ Promise
Returns an array with all secrets.
Kind: instance method of Now
See: https://zeit.co/api#get-now-secrets
| Param | Type | Description |
|---|---|---|
| [id OR callback] |
String | function
|
ID of deployment or callback |
| [callback] | function |
Callback will be called with (err, secrets)
|
now.createSecret(name, value, [callback]) ⇒ Promise
Creates a secret and returns its ID.
Kind: instance method of Now
See: https://zeit.co/api#post-now-secrets
| Param | Type | Description |
|---|---|---|
| name | String |
name for the secret |
| value | String |
value for the secret |
| [callback] | function |
Callback will be called with (err, data)
|
now.renameSecret(id, name, [callback]) ⇒ Promise
Changes the name of the given secret and returns its ID and name.
Kind: instance method of Now
See: https://zeit.co/api#patch-now-secrets
| Param | Type | Description |
|---|---|---|
| id | String |
id or name of the secret |
| name | String |
new name for the secret |
| [callback] | function |
Callback will be called with (err, data)
|
now.deleteSecret(id, [callback]) ⇒ Promise
Deletes a secret and returns its ID.
Kind: instance method of Now
See: https://zeit.co/api#delete-now-secrets
| Param | Type | Description |
|---|---|---|
| id | String |
ID or name of the secret |
| [callback] | function |
Callback will be called with (err, status)
|
