Agregar un dominio propio
const url = 'https://app.openfactura.co/api/v1/ext/marca/plataforma/dominios';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"host":"facturas.tuempresa.com"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Sección titulada «Authorizations»Request Bodyrequired
Sección titulada «Request Bodyrequired»object
Example
facturas.tuempresa.comResponses
Sección titulada «Responses»Dominio creado.
object
Registros que debes crear en el DNS de tu dominio.
object
Example
{ "host": "facturas.tuempresa.com", "estado": "pendiente", "dns": [ { "tipo": "CNAME", "para": "trafico" } ]}Datos inválidos
object
object
Example
{ "error": { "code": "plan_requerido" }}Falta la clave o la sesión
object
object
Example
{ "error": { "code": "plan_requerido" }}Tu plan no lo incluye (plan_requerido)
object
object
Example
{ "error": { "code": "plan_requerido" }}Sin permiso o clave no habilitada para Plataforma (clave_sin_plataforma)
object
object
Example
{ "error": { "code": "plan_requerido" }}Conflicto (p. ej. cliente_no_pendiente, external_id_repetido)
object
object
Example
{ "error": { "code": "plan_requerido" }}Límite de empresas del plan (limite_plan)
object
object
Example
{ "error": { "code": "plan_requerido" }}No pudimos hablar con Cloudflare al registrar, revisar o borrar el dominio (cloudflare_no_disponible)
object
object
Example
{ "error": { "code": "plan_requerido" }}Los dominios propios no están habilitados en este servidor (dominios_no_disponibles)
object
object
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.