acme.sh/dnsapi
Karthik 48966ba481
Add DNSMint DNS API (#7238)
* Add DNSMint DNS API

DNSMint mints hostnames on domains it operates and serves from its own
authoritative nameservers, so a customer has no zone of their own and the
challenge is published through its API.

The hostname is derived server-side from the challenge name, so there is
no root zone to detect and no record id to track: the value published is
the value removed. Wildcards work because the API keeps the two newest
values for a name, which is what the apex and wildcard pair needs.

Tested against Let's Encrypt staging for a wildcard plus its apex.

* Add DNSMint DNS API

DNSMint mints hostnames on domains it operates and serves from its own
authoritative nameservers, so records are published through its API
rather than a zone you run.

An ACME challenge goes to the DNS-01 endpoint, which derives the hostname
from the challenge name: no root zone to detect, no record id to track,
and the value published is the value removed. Wildcards work because the
API keeps the two newest values for a name.

Any other TXT name is an ordinary record under a hostname and goes to the
records endpoint instead, which is why the add and rm functions branch on
the _acme-challenge label. Issuing certificates needs only the dns01:write
scope; the record endpoint needs hostnames:read and hostnames:write.

Tested against Let's Encrypt staging for a wildcard plus its apex, and
the non-challenge TXT path against the live API.

* dnsmint: honour DNSMint_Api instead of overwriting it

The assignment was unconditional, so exporting DNSMint_Api did nothing - the
plugin reset it to the default every time it was sourced. Every neighbouring
plugin with an _Api variable treats it as an override; this one only looked
like it did.

Found while writing the dnsapi2 entry: the sentence documenting the override
would have been false.

* dnsmint: format case blocks with shfmt -i 2

* dnsmint: portable record lookup on removal

grep -F is not on Solaris /usr/bin/grep, and "\n" in a sed replacement is a
GNU extension that BSD sed writes as a literal n. The second is the one that
loses data: without the split the whole reply stays on one line, so the match
succeeds whatever the value is and the id taken is the first record under the
hostname rather than the one holding the challenge. Removal then deletes
somebody else's TXT record.

Literal newline in the replacement, as dns_glesys.sh does it, and a case
pattern per line with the case outside a command substitution.

Docs and Issues now point at dnsapi2 and at the tracking issue upstream.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* dnsmint: echo into sed, and keep _head_n 1 on the id

Both from review on #7238.

The reply arrives with no trailing newline, so printf "%s" hands sed an
incomplete final line. Solaris /usr/bin/sed discards one, and here that line
is the whole reply: the loop then sees nothing and every removal reports the
record already gone, leaving the challenge TXT behind. echo, as lines 154 and
172 of this file already do.

_head_n 1 was dropped in 61ef816c. A record object carrying a nested id under
"data" makes _rid two lines and the DELETE URL is then malformed.

---------

Co-authored-by: kxbnb <hello@dnsmint.com>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
2026-09-19 15:45:02 +02:00
..
dns_1984hosting.sh dns_1984hosting: cleanup, memoize zone id (#6978) 2026-06-05 19:28:08 +02:00
dns_acmedns.sh migrate the legacy ACMEDNS_UPDATE_URL from the account conf (#3899) 2026-07-05 17:48:33 +08:00
dns_acmeproxy.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_active24.sh dns_active24: rewrite for supporting new v2 API 2025-05-05 15:48:02 +02:00
dns_ad.sh fix format 2024-10-13 17:41:22 +02:00
dns_ali.sh dns_ali: convert IDN domains to punycode 2026-07-12 17:21:19 +08:00
dns_alviy.sh dnsapi alviy: Use structured info 2024-11-09 18:22:01 +02:00
dns_anx.sh fix format 2024-10-13 17:41:22 +02:00
dns_artfiles.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_arubabusiness.sh Implemented support for Aruba Business DNS API (#7042) 2026-07-02 13:06:41 +08:00
dns_arvan.sh fix format 2024-10-13 17:41:22 +02:00
dns_aurora.sh fix format 2024-10-13 17:41:22 +02:00
dns_autodns.sh dnsapi/dns_autodns: escape XML special characters in credentials (#5317) 2026-07-05 16:29:58 +08:00
dns_aws.sh Updated AWS Route53 service endpoint to the dual-stack endpoint (#6994) 2026-06-05 22:06:49 +02:00
dns_azion.sh fix format 2024-10-13 17:41:22 +02:00
dns_azure.sh Add support for Private DNS zones on Azure (#7227) 2026-09-19 15:44:32 +02:00
dns_baidu.sh fix(dns_baidu): prefer new Baidu DNS API with legacy BCD fallback (#6992) 2026-07-02 13:02:30 +08:00
dns_beget.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_bh.sh Add BEST-HOSTING DNS API (#6859) 2026-03-22 11:36:29 +08:00
dns_bhosted.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_bookmyname.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_bunny.sh fix format 2024-10-13 17:55:22 +02:00
dns_calrissia.sh Add Calrissia.be API (#6811) 2026-07-04 16:54:05 +08:00
dns_cdmon.sh Add CDMON Api (#6984) 2026-06-05 22:02:14 +02:00
dns_cf.sh Reformat using shfmt 2025-11-20 00:29:44 +08:00
dns_clouddns.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_cloudns.sh dns_cloudns: include the server response in the login error 2026-07-12 09:34:59 +08:00
dns_cn.sh dns_cn: convert IDN domain to punycode before API calls 2026-07-04 21:58:57 +08:00
dns_comlaude.sh Matthiasvpfr patch 1 (#7108) 2026-07-12 16:13:42 +08:00
dns_conoha.sh fix format 2024-10-13 17:41:22 +02:00
dns_constellix.sh Convert domain to lower case, needed for Constellix REST API 2025-08-12 19:04:19 +02:00
dns_cpanel.sh dns_cpanel: quote inner expansion in suffix strip (SC2295) 2026-07-12 09:35:22 +08:00
dns_cpanel_uapi.sh Add dns_cpanel_uapi DNS API plugin (#6878) 2026-04-26 14:29:40 +02:00
dns_creoline.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_curanet.sh Update dns_curanet.sh 2025-11-03 18:14:27 +01:00
dns_cyon.sh Fix dns_cyon cleanup failing on FreeBSD 2026-08-02 21:55:52 +08:00
dns_czechia.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_da.sh dns_da: document that special characters in DA_Api credentials must be percent-encoded 2026-07-04 18:19:45 +08:00
dns_ddnss.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_desec.sh dns_desec: fix advertised token variable name (#7081) 2026-07-05 12:03:48 +08:00
dns_df.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_dgon.sh fix format 2024-10-13 17:49:29 +02:00
dns_dnsexit.sh fix: dnsexit api rejects a TTL of zero, changed to 1 (minute) (#7107) 2026-07-12 16:37:21 +08:00
dns_dnshome.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_dnsimple.sh dns_dnsimple: use mutable conf storage so a newly exported token wins 2026-07-12 19:21:48 +08:00
dns_dnsmint.sh Add DNSMint DNS API (#7238) 2026-09-19 15:45:02 +02:00
dns_dnsservices.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_doapi.sh update dns_doapi 2024-05-27 12:45:01 +02:00
dns_domeneshop.sh fix format 2024-10-13 17:41:22 +02:00
dns_dp.sh fix format 2024-10-13 17:41:22 +02:00
dns_dpi.sh fix format 2024-10-13 17:41:22 +02:00
dns_dreamhost.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_duckdns.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_durabledns.sh fix format 2024-10-13 17:41:22 +02:00
dns_dyn.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_dynu.sh dns_dynu: use mutable conf storage so newly exported credentials win 2026-07-12 19:21:56 +08:00
dns_dynv6.sh fix: dynv6 record parsing (#7197) 2026-09-04 14:51:30 +08:00
dns_easydns.sh dns_easydns: match the TXT record by its rdata when removing (#7199) 2026-08-22 10:15:52 +08:00
dns_edgecenter.sh dns_edgecenter.sh: fix structural info 2025-05-19 15:08:54 +03:00
dns_edgedns.sh dnsapi/dns_edgedns: use the system clock for the request timestamp (#3973) 2026-07-05 18:02:34 +08:00
dns_efficientip.sh Remove unecessary base64 encoding 2025-11-25 14:47:40 +01:00
dns_eurodns.sh Add EuroDNS DNS API plugin (dns_eurodns) (#6903) 2026-05-02 10:56:13 +02:00
dns_euserv.sh fix format 2024-10-13 17:41:22 +02:00
dns_exoscale.sh fix: update Exoscale DNS script 2025-12-09 09:49:54 +01:00
dns_firestorm.sh Add dns_firestorm.sh plugin for Firestorm.ch DNS API (#6829) 2026-05-02 10:56:13 +02:00
dns_fornex.sh Update _get_root url in dnsapi/dns_fornex.sh 2025-03-11 08:07:38 +00:00
dns_freedns.sh dns_freedns.sh: use grep -E, BRE \| alternation is a GNU extension 2026-07-10 10:23:59 +08:00
dns_freemyip.sh Refactor dns_freemyip.sh for enhanced compatibility (#7166) 2026-08-02 21:34:41 +08:00
dns_gandi_livedns.sh Use '_mutable' functions for authentication variables 2025-12-08 19:02:33 +01:00
dns_gcloud.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_gcore.sh fix format 2024-10-13 17:41:22 +02:00
dns_gd.sh dns_gd: fix root zone detection for API-restricted accounts https://github.com/acmesh-official/acme.sh/issues/4487 2026-07-03 23:34:27 +08:00
dns_geoscaling.sh fix format 2024-10-13 17:49:29 +02:00
dns_glesys.sh Add Glesys dnsapi provider (#7059) 2026-07-02 13:10:29 +08:00
dns_gname.sh Add Gname.com dnsapi support (#6808) 2026-04-14 20:57:22 +08:00
dns_googledomains.sh fix format 2024-10-13 17:41:22 +02:00
dns_he.sh fix format 2024-10-13 17:49:29 +02:00
dns_he_ddns.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_hestiacp.sh Merge pull request #7140 from radumalica/dns_hestiacp 2026-07-23 11:50:20 +08:00
dns_hetznercloud.sh Wait for Hetzner Cloud DNS actions to complete before returning 2025-11-02 04:07:58 +01:00
dns_hexonet.sh fix format 2024-10-13 17:41:22 +02:00
dns_hostingde.sh fix https://github.com/acmesh-official/acme.sh/issues/4879#issuecomment-2942728895 2026-07-04 11:44:32 +08:00
dns_hostinger.sh Microwavenby dns hostinger (#6843) 2026-07-11 10:04:49 +08:00
dns_hostup.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_huaweicloud.sh dns_huaweicloud: add optional HUAWEICLOUD_Region (default ap-southeast-1) 2026-07-04 19:06:46 +08:00
dns_hw.sh Fix dns_hw: prevent record-set lookup from hanging (#7236) 2026-09-10 21:41:00 +08:00
dns_infoblox.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_infoblox_uddi.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_infomaniak.sh dns_infomaniak: log zones response and fail early in _get_zone 2026-07-13 08:30:43 +08:00
dns_internetbs.sh fix format 2024-10-13 17:49:29 +02:00
dns_inwx.sh dns_inwx: fix _get_root false zone match for single-letter subdomains 2026-07-04 20:28:56 +08:00
dns_ionos.sh DNS_IONOS double sending content type & case sensitive mismatch (#7028) 2026-07-02 23:08:59 +08:00
dns_ionos_cloud.sh dnsapi ionos_cloud: Use structured info 2024-11-09 18:31:52 +02:00
dns_ipprojects.sh [dnsapi] add IP-Projects dns hook (#6959) 2026-05-24 22:24:00 +02:00
dns_ipv64.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_ispconfig.sh dns_ispconfig.sh client_id not numeric at ispconfig v 3.2.7p1 (#4999) 2026-07-10 20:55:23 +08:00
dns_jd.sh dns_jd: upgrade to JD Cloud v2 API (#7207) 2026-08-30 15:33:32 +08:00
dns_joker.sh fix https://github.com/acmesh-official/acme.sh/issues/6498 2026-07-01 21:59:41 +08:00
dns_kappernet.sh fix format 2024-10-13 17:41:22 +02:00
dns_kas.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_kinghost.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_knot.sh dns_knot: add KNOT_ZONE for delegated subdomain zones 2026-07-12 19:22:03 +08:00
dns_la.sh Update dns_la.sh 2025-07-02 21:15:46 +08:00
dns_laodc.sh Add LaoDC DNS API (dns_laodc) (#6974) 2026-07-05 23:30:26 +08:00
dns_leaseweb.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_level27.sh Implement support for DNS Level27 (#7043) 2026-06-29 01:27:41 +08:00
dns_lexicon.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_limacity.sh dnsapi: structured info minor fixes 2024-12-31 11:45:29 +02:00
dns_linode_v4.sh fix pagination bug for domains with a big zone file 2024-11-08 00:59:21 -03:00
dns_loopia.sh fix format 2024-10-13 17:41:22 +02:00
dns_lua.sh fix format 2024-10-13 17:41:22 +02:00
dns_maradns.sh fix format 2024-10-13 17:49:29 +02:00
dns_me.sh dns_me.sh: use LC_ALL=C so the request date header is always English 2026-07-10 11:20:08 +08:00
dns_mgwm.sh Fix formatting issues in dns_mgwm.sh script 2025-12-08 19:31:40 +01:00
dns_miab.sh Revert TXT add update 2024-10-16 11:49:29 +02:00
dns_mijnhost.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_misaka.sh fix format 2024-10-13 17:41:22 +02:00
dns_muumuu.sh Add dns_muumuu: muumuu-domain.com DNS API (#7012) 2026-07-05 16:05:33 +08:00
dns_myapi.sh dnsapi: structured info minor fixes 2024-12-31 11:45:29 +02:00
dns_mydevil.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_mydnsjp.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_myloc.sh Merge pull request #5194 from flesniak/myloc 2026-08-22 10:13:58 +08:00
dns_mythic_beasts.sh dev_mythic_beasts: Fix header name: Accepts => Accept (#6428) 2026-07-03 23:25:38 +08:00
dns_namecheap.sh Fix dns_namecheap ignoring IsOurDNS when matching the root zone 2026-08-06 19:36:26 +08:00
dns_namecom.sh Fix name.com DNS API for processing IDNs (#4381) 2026-07-10 21:56:54 +08:00
dns_namesilo.sh Fix dns_namesilo_rm failing to remove TXT record (#6969) 2026-06-19 14:24:20 +02:00
dns_nanelo.sh nanelo dns: minor log improvements 2025-10-14 15:51:28 +02:00
dns_nederhost.sh fix format 2024-10-13 17:41:22 +02:00
dns_neodigit.sh fix format 2024-10-13 17:41:22 +02:00
dns_netcup.sh Update netcup DNS API to support new API (#7214) 2026-09-10 21:37:03 +08:00
dns_netlify.sh fix format 2024-10-13 17:58:19 +02:00
dns_nexdns.sh feat: added nexdns dnsapi (#7170) 2026-08-07 09:22:28 +08:00
dns_nic.sh fix format 2024-10-13 17:41:22 +02:00
dns_njalla.sh dns_njalla.sh: accept string record ids when removing records 2026-07-10 20:47:31 +08:00
dns_nm.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_nsd.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_nsone.sh fix format 2024-10-13 17:41:22 +02:00
dns_nsupdate.sh Add the information from my last accepted pull that the TSIG key is optional. 2026-02-12 15:32:53 +01:00
dns_nw.sh fix format 2024-10-13 17:58:19 +02:00
dns_oci.sh fix(dns_oci): read ~/.oci/config before cached account.conf values (#7124) 2026-07-14 20:58:47 +08:00
dns_omglol.sh Updated comment to be more clear on variable vs. 2025-12-17 17:15:10 -05:00
dns_one.sh fix format 2024-10-13 17:41:22 +02:00
dns_online.sh fix format 2024-10-13 17:41:22 +02:00
dns_openprovider.sh dnsapi: structured info minor fixes 2024-12-31 11:45:29 +02:00
dns_openprovider_rest.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_openstack.sh DNS provider API: structured description 2024-05-18 12:06:41 +03:00
dns_opnsense.sh dnsapi/dns_opnsense.sh: Refresh for OPNsense v25.7 series 2025-09-15 15:50:48 +10:00
dns_opteamax.sh Add Opteamax DNS API (#7244) 2026-09-11 11:49:47 +08:00
dns_optidata.sh Add Optidata Cloud DNS API (dns_optidata) (#7243) 2026-09-11 11:48:31 +08:00
dns_opusdns.sh fix: start zone detection from i=1 per acme.sh convention 2026-01-23 09:20:00 +01:00
dns_ovh.sh dns_ovh specific permission for record removal (#6386) 2026-07-12 16:21:00 +08:00
dns_pdns.sh dns_pdns: probe zones with the server-side name filter in _get_root 2026-07-12 11:20:53 +08:00
dns_pleskxml.sh dns_pleskxml.sh: use grep -F when matching interpolated values 2026-07-10 12:05:28 +08:00
dns_pointhq.sh fix format 2024-10-13 17:41:22 +02:00
dns_porkbun.sh fix format 2024-10-13 17:41:22 +02:00
dns_poweradmin.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_qc.sh Ran shfmt locally 2025-12-30 16:31:16 -05:00
dns_rackcorp.sh fix format 2024-10-13 17:41:22 +02:00
dns_rackspace.sh fix format 2024-10-13 17:41:22 +02:00
dns_rage4.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_rcode0.sh fix format 2024-10-13 17:49:29 +02:00
dns_regru.sh dns_regru: require a dot boundary in root zone matching 2026-07-05 16:57:59 +08:00
dns_rltx.sh feat: added realtoxmedia dnsapi (#7156) 2026-07-24 13:55:17 +08:00
dns_scaleway.sh fix format 2024-10-13 17:58:19 +02:00
dns_schlundtech.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_selectel.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_selfhost.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_servercow.sh fix format 2024-10-13 17:59:25 +02:00
dns_simply.sh Improve Simply.com API (#6933) 2026-05-24 22:20:40 +02:00
dns_sitehost.sh [dnsapi] add SiteHost DNS API hook (#6891) 2026-04-08 22:07:30 +08:00
dns_sotoon.sh improve: change sotoon api to v2.1 with simplification 2025-12-24 17:19:17 +03:30
dns_spaceship.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_subreg.sh [dnsapi] add subreg.cz dns hook (#6848) 2026-03-22 11:40:44 +08:00
dns_technitium.sh shfmt edit 2026-03-03 05:31:51 -08:00
dns_tele3.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_tencent.sh docs (dns_tencent) : update documentation links 2025-05-23 17:54:56 +08:00
dns_timeweb.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_transip.sh Set DNS Record TTL to 60 instead of 300 sec 2025-05-16 15:40:36 +02:00
dns_udr.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_ultra.sh fix format 2024-10-13 17:41:22 +02:00
dns_unoeuro.sh fix format 2024-10-13 17:41:22 +02:00
dns_variomedia.sh Variomedia API: Fix DNS deletion issues 2025-08-15 09:02:57 +02:00
dns_veesp.sh fix format 2024-10-13 17:41:22 +02:00
dns_vercel.sh fix format 2024-10-13 17:41:22 +02:00
dns_virakcloud.sh run ~/shfmt -l -w -i 2 dnsapi/dns_virakcloud.sh and Remove unnecessary blank lines in dns_virakcloud.sh 2026-01-04 16:33:37 +03:30
dns_volcengine.sh feat: Add Volcano Engine DNS API (#7069) 2026-07-03 10:09:32 +00:00
dns_vscale.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_vultr.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_websupport.sh Upload latest dev branch to master (#3) 2025-08-12 11:12:09 +03:00
dns_wedos.sh Add WEDOS WAPI DNS API (dns_wedos) (#7072) 2026-07-05 12:44:07 +08:00
dns_west_cn.sh dnsapi: Add structured info for lima-city and west.cn 2024-12-28 22:31:24 +02:00
dns_world4you.sh fix: grep -A is not portable, breaks ARI on Solaris 2026-07-25 16:00:03 +08:00
dns_yandex360.sh fix bug for solaris. 2026-07-17 12:38:14 +08:00
dns_yc.sh dns_yc: fix TXT record removal failing with "Unknown key file format" (#7150) 2026-07-28 10:04:20 +08:00
dns_zilore.sh fix format 2024-10-13 17:41:22 +02:00
dns_zone.sh fix format 2024-10-13 17:41:22 +02:00
dns_zoneedit.sh dnsapi: Fix structured info 2024-12-28 17:42:58 +02:00
dns_zonomi.sh dns_zonomi: make the API endpoint configurable via ZM_Api 2026-07-12 10:26:40 +08:00
README.md