API de Buró de IngresosConsentimientos
Crear consentimiento
posthttps://api.burodeingresos.com/consents
Registra un consentimiento para un identificador. Acepta una CURP de 18 caracteres (persona física) o un RFC de 12 caracteres (persona moral). El payload es el mismo en ambos casos.
Un consentimiento vence 365 días después de su creación. A partir de entonces, POST /verifications para ese identificador devuelve consent_expired hasta que usted cree un nuevo consentimiento. Los datos de verificaciones ya completadas se pueden seguir leyendo.
Parámetros del cuerpo
Payload del consentimiento. Misma estructura para identificadores de persona física (CURP de 18 caracteres) y de persona moral (RFC de 12 caracteres).
identifierstringobligatoriolongitud entre 12 y 18
Identificador del titular de los datos: CURP de 18 caracteres para personas físicas o RFC de 12 caracteres para personas morales.
ip_addressstringobligatorio
Dirección IP del usuario que otorga el consentimiento. Debe ser una dirección IPv4 (p. ej., 192.168.2.74) o IPv6 (p. ej., 2001:db8::1) válida.
privacy_notice_urluriobligatorio
URL del aviso de privacidad aceptado por el usuario.
Respuestas
201Consentimiento creado correctamente.
iduuid
Identificador único del consentimiento creado.
identifierstring
El CURP (persona física, 18 caracteres) o RFC (persona moral, 12 caracteres) asociado al consentimiento.
ip_addressstring
La dirección IP del usuario que otorgó el consentimiento. Se devuelve como dirección IPv4 o IPv6.
privacy_notice_urluri
URL del aviso de privacidad aceptado por el usuario.
created_atdate-time
Fecha y hora en que se creó el consentimiento.
expires_atdate-time
Fecha y hora en que expira el consentimiento (365 días después de su creación). A partir de ese momento, las nuevas verificaciones para el identificador requieren un nuevo consentimiento; los datos ya obtenidos pueden seguir consultándose.
400Bad Request - Parámetros de entrada inválidos, como campos obligatorios faltantes o valores de campo inválidos.
errorobject
401Unauthorized - API key inválida o faltante.
errorobject