Domainrecords eines Accounts auslesen

GET/accounts/{accountIdentifier}/domainrecords/

API version

v1

Request method

GET

Operation ID

listDomainrecordsByAccount

---

Diese Operation liest die Domainrecords eines einzelnen Accounts aus

Request

• accountIdentifierstring

  required

  Name oder ID eines Accounts

Responses

Format

application/json

Description

Die Domainrecords des Accounts

Schema documentation

• Array[
• *object
  • accountobject
    • customerNumbernumber
    • descriptionstring
    • disabledboolean
    • namestring
    • statusstring
    • uidnumber
    • virtualboolean
  • certificateobject
    • altNamesarray of string
      • Array[
      • *string
      ]
  • commonNamestring
  • isInclusiveboolean
  • stagestring
  • statusDescriptionstring
  • uidnumber
• domainNamestring

  required
• forceHttpsboolean

  Indicates if an automatic HTTPS redirect should be performed for this domain.

• fullNamestring

  required

  The full name of the domain record (including parent domain and TLD).

• ipAddressstring

  The IP address of the server which is hosting this domain. If the domain is registered via mittwald (more precisely: if its DNS zone is managed by mittwald), this will automatically be the content of the DNS A record. If the DNS zone is managed by an external DNS vendor, this IP address needs to be configured as A record there.

• isSubDomainboolean

  required
• isUsingMittwaldMailsystemboolean

  required

  true if this domain record uses the mittwald mail system. In this case, the DNS zone's MX records will point to the mittwald-operated email server.

• registrarStatusstring
• statusnumber

  required
• targetstring
• tldstring

  required
• uidnumber

]

Example

Content-Type: application/json

[
  {
    "account": {
      "customerNumber": 123,
      "description": "string",
      "disabled": true,
      "name": "string",
      "status": "string",
      "uid": 123,
      "virtual": true
    },
    "certificate": {
      "altNames": [
        "string"
      ],
      "commonName": "string",
      "isInclusive": true,
      "stage": "string",
      "statusDescription": "string",
      "uid": 123
    },
    "domainName": "string",
    "forceHttps": true,
    "fullName": "string",
    "ipAddress": "string",
    "isSubDomain": true,
    "isUsingMittwaldMailsystem": true,
    "registrarStatus": "string",
    "status": 123,
    "target": "string",
    "tld": "string",
    "uid": 123
  }
]

JSON Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "domainName",
      "fullName",
      "isSubDomain",
      "isUsingMittwaldMailsystem",
      "tld",
      "status"
    ],
    "properties": {
      "account": {
        "type": "object",
        "properties": {
          "customerNumber": {
            "type": "number"
          },
          "description": {
            "type": "string"
          },
          "disabled": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "uid": {
            "type": "number"
          },
          "virtual": {
            "type": "boolean"
          }
        }
      },
      "certificate": {
        "type": "object",
        "properties": {
          "altNames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "commonName": {
            "type": "string"
          },
          "isInclusive": {
            "type": "boolean"
          },
          "stage": {
            "type": "string"
          },
          "statusDescription": {
            "type": "string"
          },
          "uid": {
            "type": "number"
          }
        }
      },
      "domainName": {
        "type": "string"
      },
      "forceHttps": {
        "type": "boolean",
        "description": "Indicates if an automatic HTTPS redirect should be performed for this domain.\n"
      },
      "fullName": {
        "type": "string",
        "description": "The full name of the domain record (including parent domain and TLD)."
      },
      "ipAddress": {
        "type": "string",
        "description": "The IP address of the server which is hosting this domain. If the domain is registered via mittwald (more precisely: if its DNS zone is managed by mittwald), this will automatically be the content of the DNS A record. If the DNS zone is managed by an external DNS vendor, this IP address needs to be configured as A record there.\n"
      },
      "isSubDomain": {
        "type": "boolean"
      },
      "isUsingMittwaldMailsystem": {
        "type": "boolean",
        "description": "`true` if this domain record uses the mittwald mail system. In this case, the DNS zone's MX records will point to the mittwald-operated email server.\n"
      },
      "registrarStatus": {
        "type": "string"
      },
      "status": {
        "type": "number"
      },
      "target": {
        "type": "string"
      },
      "tld": {
        "type": "string"
      },
      "uid": {
        "type": "number"
      }
    }
  }
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v1/accounts/string/domainrecords?limit=50&offset=123&visibleOnly=true