Skip to main content

A Python wrapper for Porkbun API with extra features and shortcuts

Project description

Porkbun API

This is an API wrapper for Porkbun written in Python with few extra features/shortcuts.

Porkbun API documentation

This project is subject to breaking changes as Porkbun API may change and/or become invalid. I do not guarantee anything.

Installing

You can install this through PyPi with pip: pip install porkbun-api

Or you can grab a .whl or .tar.gz file from Codeberg releases.

Usage

This wrapper supports everything other than operations with ID's for now.

Available functions and arguments: Please keep in mind every function requires an apikey and secretapikey arguments, but you can set APIKEY and SECRETAPIKEY variables with their respective values and not have to give keys as arguments at every function call.

  • ping()
    • Optional: ipv4only (takes True or False and returns IPv4 only if True and IPv6 if available otherwise. Default = True).
    • Returns IP address.
  • nsupdate()
    • Requires domain (takes a string of the domain you want to work on) and nslist (a list containing nameservers).
    • Does not return anything, changes the authoritative nameservers for given domain.
  • create()
    • Requires domain, rtype (string of the record type such as A, AAAA, MX, etc), and content (string value for said request type such as the IP address).
    • Optional: subdomain (string subdomain for said domain) and ttl (integer number for time to live, default and minimum for Porkbun is 600).
    • Does not return anything. Creates a new DNS record with given arguments.
  • read()
  • update()
    • Requires domain, rtype, and content.
    • Optional: name and ttl.
    • Does not return anything. Updates the matching record with given content
  • delete()
    • Requires domain and rtype.
    • Optional subdomain.
    • Does not return anything. Deletes the matching record.
  • ddns_update()
    • Requires domain.
    • Optional: ip (the string IP address to update the record with. If not given, uses the return of ping() as IP), subdomain, and ipv4only.

Examples

import porkbun_api as pb
from time import sleep # only as an example, not required.

pb.APIKEY = "pk1_..."
pb.SECRETAPIKEY = "sk1_..."

pb.ping()

pb.create(domain = "m3r.one", rtype = "A", content = "23.94.123.251")

pb.delete(domain = "m3r.one", rtype = "A", subdomain = "bin", apikey = "pk1_overwrite-the-variable", secretapikey = "sk1_overwrite-the-variable")

while True:
  pb.ddns_update(domain = "m3r.one")
  sleep(86400)

Notes

It is recommended to use try - except blocks with every function because it raises a PorkbunError exception if Porkbun returns an error for whatever reason. Plus, requests library will raise exceptions itself if something goes wrong with the request.

Feel free to open issues or contact me in case you wish to see extra features added.


This project is not affiliated with Porkbun LLC.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

porkbun-api-1.0.tar.gz (4.4 kB view hashes)

Uploaded Source

Built Distribution

porkbun_api-1.0-py3-none-any.whl (4.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page