Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/patrikx3/freenom
🌐 Feenom Promise/Async/Await
https://github.com/patrikx3/freenom
async corifeus extra freenom freenom-api p3x promise
Last synced: about 2 months ago
JSON representation
🌐 Feenom Promise/Async/Await
- Host: GitHub
- URL: https://github.com/patrikx3/freenom
- Owner: patrikx3
- License: mit
- Created: 2017-06-11T08:55:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-07-15T05:56:49.000Z (7 months ago)
- Last Synced: 2024-12-05T00:09:28.646Z (2 months ago)
- Topics: async, corifeus, extra, freenom, freenom-api, p3x, promise
- Language: JavaScript
- Homepage: https://www.corifeus.com/freenom
- Size: 225 KB
- Stars: 33
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[//]: #@corifeus-header
[](https://www.npmjs.com/package/p3x-freenom) [](https://paypal.me/patrikx3) [](https://www.patrikx3.com/en/front/contact) [](https://www.facebook.com/corifeus.software) [](https://stats.uptimerobot.com/9ggnzcWrw)
# 🌐 Freenom API - Promise and auto renew expiring domains v2024.10.103
**Bugs are evident™ - MATRIX️**
### NodeJS LTS is supported
### Built on NodeJs version
```txt
v22.3.0
```
# Description
[//]: #@corifeus-header:end
## To be able to register and renew FREE DOMAINS
Before, we were able to register and renew with free domains, but by now, these functions are allowed and working ONLY with PAID domains.
### Some links
http://www.freenom.com/en/resellers.html
http://www.freenom.com/en/termsandconditions.html
## API
http://www.freenom.com/en/freenom-api.html
I am using these only right now. So no other functions but very easy to add in and Promise based.
```js
const Freenom = require('p3x-freenom');
const freenom = await Freenom({
email: 'p3x@corifeus',
password: 'password',
});
await freenom.service.ping();
await freenom.domain.search({
domainname: 'patrikx3.com',
domaintype: 'FREE'
})
await freenom.domain.delete({ domainname: 'random.tk'));
await freenom.domain.register({
domainname: [
'random.tk',
'random1.tk',
'random2.tk',
],
domaintype: 'FREE',
period: '1Y',
nameserver: [
'ns1.ns.tk',
'ns2.ns.tk',
]
})
await freenom.domain.delete, { domainname: domains })
// if you have no domain in the list, instead of
// giving an empty list, it shows and error!!!
// so make sure you have one in the domain list
// because freenom.domain.expiringRenew will of course
// throw an error as well!!!
await freenom.domain.list()
```
# The good extra functions
It automatically renew the free domains (it checks if it is within 14 days expiry and then does it).
```js
// just a helper, you don't relly need it
const renewable = await freenom.domain.expiring({
expiry: '60 days',
});
// the magic
await freenom.domain.expiringRenew({
period: '12M',
})
```
[//]: #@corifeus-footer
---
## Support Our Open-Source Project ❤️
If you appreciate our work, consider starring this repository or making a donation to support server maintenance and ongoing development. Your support means the world to us—thank you!
### Server Availability
Our server may occasionally be down, but please be patient. Typically, it will be back online within 15-30 minutes. We appreciate your understanding.
### About My Domains
All my domains, including [patrikx3.com](https://patrikx3.com) and [corifeus.com](https://corifeus.com), are developed in my spare time. While you may encounter minor errors, the sites are generally stable and fully functional.
### Versioning Policy
**Version Structure:** We follow a Major.Minor.Patch versioning scheme:
- **Major:** Corresponds to the current year.
- **Minor:** Set as 4 for releases from January to June, and 10 for July to December.
- **Patch:** Incremental, updated with each build.
**Important Changes:** Any breaking changes are prominently noted in the readme to keep you informed.
---
[**P3X-FREENOM**](https://corifeus.com/freenom) Build v2024.10.103
[](https://www.npmjs.com/package/p3x-freenom) [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6) [](https://www.patrikx3.com/en/front/contact) [](https://www.facebook.com/corifeus.software)
[//]: #@corifeus-footer:end