Request domain auth code | regfish DNS & TLS API

DNS API-Referenz

v1.6.2

Request domain auth code

Generates the transfer authorization code (AuthInfo) for the domain at the registry. The code enables an outbound transfer — request it only on the domain owner's explicit demand. Guarded by the Domain-Guardian (authinfo rule class) and limited to 3 requests per domain and 10 per account per day — the account limit is what bounds a bulk harvest across the whole portfolio. Every issued code is recorded in the domain guard log (outcome issued), as is every refusal.

POST

/domains/{domain}/authinfo

Domains

Authentifizierung

x-api-key

SchnellstartAuthentifizierung Regfish ConsoleAPI-Key im Regfish-Interface anlegen und testen

Parameter

Name

Typ

Format

Pflicht

Description

domain

path

string

-

Pflicht

Fully Qualified Domain Name.

Request-Beispiel

POST

curl --request POST \
  --url 'https://api.regfish.com/domains/www.example.com/authinfo' \
  --header 'x-api-key: YOUR_API_KEY'

Responses

200

Generated auth code

application/jsonauthinfoResponse

Response-Beispiel 200

{
  "success": true,
  "code": 0,
  "response": {
    "domain": "example",
    "authinfo": "example"
  }
}

401

Unauthorized

application/jsonError

Response-Beispiel 401

{
  "success": false,
  "message": "Unauthorized",
  "error": "Unauthorized"
}

403

Blocked by the Domain-Guardian

application/jsonError

Response-Beispiel 403

{
  "success": false,
  "message": "Blocked by the Domain-Guardian",
  "error": "Blocked by the Domain-Guardian"
}

404

Domain not found

application/jsonError

Response-Beispiel 404

{
  "success": false,
  "message": "Domain not found",
  "error": "Domain not found"
}

429

Daily auth-code limit reached (per domain or per account)

application/jsonError

Response-Beispiel 429

{
  "success": false,
  "message": "Daily auth-code limit reached (per domain or per account)",
  "error": "Daily auth-code limit reached (per domain or per account)"
}

500

Unexpected error

application/jsonError

Response-Beispiel 500

{
  "success": false,
  "message": "Unexpected error",
  "error": "Unexpected error"
}

502

Registry error

application/jsonError

Response-Beispiel 502

{
  "success": false,
  "message": "Registry error",
  "error": "Registry error"
}

Verwandte Modelle

Fully Qualified Domain Name.

Community

Werde ein Teil der Community

Das DNS API von Regfish ist die perfekte Lösung für Entwickler, die ihre Domains und DNS-Zonen automatisieren möchten. Werde Teil der Community und profitiere von den Vorteilen der DNS-Automatisierung. Das DNS API steht jedem Regfish-Kunden kostenlos zur Verfügung.

Weitere Gratis-Features