Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/n-octo-n/n8n-nodes-curl
This n8n node lets you call out to the cURL binary to do any kind of supported HTTP operation, via the standard curl command-line syntax.
https://github.com/n-octo-n/n8n-nodes-curl
api curl http https libcurl n8n n8n-community-node-package n8n-node n8n-nodes network nodejs request url
Last synced: 4 months ago
JSON representation
This n8n node lets you call out to the cURL binary to do any kind of supported HTTP operation, via the standard curl command-line syntax.
- Host: GitHub
- URL: https://github.com/n-octo-n/n8n-nodes-curl
- Owner: n-octo-n
- License: mit
- Created: 2023-08-27T16:53:10.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-11-02T08:58:29.000Z (about 1 year ago)
- Last Synced: 2024-09-30T02:40:59.031Z (4 months ago)
- Topics: api, curl, http, https, libcurl, n8n, n8n-community-node-package, n8n-node, n8n-nodes, network, nodejs, request, url
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@n-octo-n/n8n-nodes-curl
- Size: 34.6 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# n8n-nodes-curl
This n8n node lets you call out to the cURL binary to do any kind of supported HTTP operation, via the standard `curl` command-line syntax.
[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
The statically-compiled cURL binaries used by this node are provided by [stunnel/static-curl](https://github.com/stunnel/static-curl). Refer to that repository for a list of the features provided by the binaries.
[Installation](#installation)
[Compatibility](#compatibility)
[Usage](#usage)
[Quirks](#quirks)
[Resources](#resources)
## Installation
Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation. The npm name for this package is `@n-octo-n/n8n-nodes-curl`.
## Compatibility
Tested on n8n `1.4.0` as of 2023/08/29.
## Usage
This node simply provides an input field to pass shell command-line arguments to cURL, and outputs the following object in case of success:
```
{ key | example
----------------|----------------------------------------------------
data |
This is not the string you were expecting.
statusCode | 200
statusMessage | OK
headers | { "content-type": "text/html; charset=utf-8" }
}
```
In case the response includes a `set-cookie` header, the node's output will also include a `setCookie` key with the following content, that allows for easy retrieval of all cookies sent by the server within your workflow:
```
{ key | example
---------|----------------------------------------------------
array | [ "Yummy=1", "SessionId=cafebabe" ]
string | "Yummy=1; SessionId=cafebabe"
object | { "Yummy": { "value": "1" }, "SessionId": { "value": "cafebabe", "domain": "example.com" } }
}
```
Be careful of what data you pass to the input field of this node, as everything is simply handed to the system shell to be passed to cURL. Be especially mindful of using shell quotes and escapes when needed; use JavaScript functions if you need to filter data.
On first use, the node automatically downloads the correct cURL binary for your system architecture (~3 MB, but varies), then stores it for future use. Just wait if it seems like the node takes a while to elaborate.
## Quirks
* Currently, this node only supports dealing with text data. If any HTTP endpoint you call with this node returns binary data, there's no guarantee that the result will be fine.
* Currently, only Linux hosts are supported. All kinds of containers work fine, but Windows and macOS don't work yet.
## Resources
* [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
* [cURL documentation](https://curl.se/docs/)
* [curl | tldr pages](https://tldr.inbrowser.app/pages/common/curl)