Ir al contenido
POST
/api/v1/ext/marca/plataforma/dominios
curl --request POST \
--url https://app.openfactura.co/api/v1/ext/marca/plataforma/dominios \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "host": "facturas.tuempresa.com" }'

Requiere el plan Platform y una cuenta que no sea administrada por otra plataforma (si no, 402 plan_requerido). Crea el dominio en estado pendiente y devuelve los registros DNS que debes crear. Errores: 400 host_invalido, 409 dominio_en_uso, 409 limite_dominios, 429 limite_excedido, 502 cloudflare_no_disponible, 503 dominios_no_disponibles. Permiso emisor:write.

Media typeapplication/json
object
host
required
string

Example

facturas.tuempresa.com

Dominio creado.

Media typeapplication/json
object
id
string
host
string
estado
string
Allowed values: pendiente verificando activo error
error
string | null
dns

Registros que debes crear en el DNS de tu dominio.

Array<object>
object
tipo
string
Allowed values: CNAME TXT
nombre
string
valor
string
para
string
Allowed values: trafico propiedad certificado
creado
integer
activado
integer | null

Example

{
"host": "facturas.tuempresa.com",
"estado": "pendiente",
"dns": [
{
"tipo": "CNAME",
"para": "trafico"
}
]
}

Datos inválidos

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Falta la clave o la sesión

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Tu plan no lo incluye (plan_requerido)

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Sin permiso o clave no habilitada para Plataforma (clave_sin_plataforma)

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Conflicto (p. ej. cliente_no_pendiente, external_id_repetido)

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Límite de empresas del plan (limite_plan)

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

No pudimos hablar con Cloudflare al registrar, revisar o borrar el dominio (cloudflare_no_disponible)

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Los dominios propios no están habilitados en este servidor (dominios_no_disponibles)

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Para asistentes de IA: llms.txt ·llms-full.txt ·cada página en Markdown añadiendo .md a su ruta.