Cuenta de cliente
API para empresas
Con la API, tu sistema busca directamente, sin pasar por esta página. Cada consulta usa una búsqueda de tu mismo saldo y devuelve hasta 50 candidatos. La API pide una suscripción mensual, además de lo que cuesta cada consulta. Al suscribirte, tu cuenta recibe el acceso y generas tu llave en esta misma página.
Cómo se obtiene la llave
- Abajo, en Tu acceso, pulsa Suscribirse y paga la suscripción mensual en Stripe.
- Al confirmarse el pago, tu cuenta queda con acceso sin más trámite: la suscripción es lo que deja la API abierta.
- Genera tu llave y elige su vigencia, de 30 días a un año. La llave se muestra una sola vez: guárdala en ese momento.
La dirección de la API aparece aquí cuando tu cuenta ya tiene el acceso. Si pierdes la llave, generas otra y la anterior deja de funcionar en ese momento.
Qué cuesta
El acceso a la API tiene una suscripción de $6,500.00 mxn al mes con IVA incluido. Además, cada búsqueda por API se cobra aparte, al precio por búsqueda: $6.00 mxn con IVA incluido, de tu mismo saldo, el que compras para el buscador del sitio. Los socios conservan el acceso a la API sin suscripción. Las reglas completas están en precios.
La suscripción se renueva cada mes. Sin una suscripción activa, la API responde 402 y esa respuesta no se cobra. Si la cancelas o no se paga, tu llave responde 402 hasta que la reactives.
Cada consulta se cobra según lo que responde el servicio:
- Una consulta que el servicio ejecuta, traiga candidatos o no.
- Una consulta repetida, aunque use la misma llave de petición.
- Una consulta mal formada que el servicio rechaza.
Y no se cobra:
- Una consulta sin llave válida o sin permiso.
- Una consulta sin saldo.
- Una consulta rechazada por exceder el límite de ritmo.
- Una consulta que falla por un error del servicio.
- La constancia, si se pide en la misma consulta.
En códigos de respuesta: se cobra lo que responde 200 y las consultas mal formadas que responden 400 o 413. No se cobran las respuestas 401, 402, 403, 429, 500 y 503.
Cada cuenta puede comparar como máximo 3 fechas de nacimiento distintas contra una misma persona en 30 días. Desde la cuarta, la fecha ya no se compara para esa persona, y la búsqueda se cobra igual.
Tu acceso
Cargando...
La suscripción mensual de la API cuesta $6,500.00 mxn al mes, IVA incluido. Cada búsqueda se cobra aparte, de tu saldo. Se cancela cuando quieras y no se reembolsa el mes en curso. Al pagar, tu cuenta recibe el acceso y puedes generar tu llave.
Tu cuenta no tiene acceso a la API. Si crees que es un error, escribe acontacto@entitymx.com.
$6,500.00 mxn al mes, IVA incluido, y se renueva cada mes. Sin suscripción activa tu llave responde 402 y esa respuesta no se cobra.
Cuenta desde que la generas. Al vencer deja de funcionar y generas otra.
Puedes generar la llave ya, pero sin suscripción activa responde 402 y no busca.
Esta es tu llave. Guárdala ahora: no la volveremos a mostrar.
Si la pierdes, genera una nueva: la anterior deja de funcionar en ese momento.
Cómo usarla
- Una sola operación:
POST /v1/match, con el cuerpo en JSON. - Obligatorio: el nombre y el primer apellido, en
full_nameo engiven_namesypaternal_surname(maternal_surnamees opcional). - Opcionales, para afinar la coincidencia:
curporfc(uno de los dos, nunca ambos),birth_date(AAAA-MM-DD) obirth_year, ystate(clave de entidad, de 01 a 32). - De la CURP y del RFC solo se comparan los 10 primeros caracteres: las 4 siglas del nombre y la fecha de nacimiento (AAMMDD). Si no envías
birth_date, la fecha que trae la CURP o el RFC también cuenta. Sexo, entidad de nacimiento y homoclave no se leen. - La CURP y el RFC que envías no se guardan: solo se usan durante la consulta y en la bitácora queda el nombre del campo, no su valor.
- Cabeceras:
Authorization: Bearercon tu llave, eIdempotency-Key, que es obligatoria, con un identificador distinto por búsqueda. Cada consulta ejecutada se cobra aunque repitas la clave. - Sin suscripción mensual activa, la respuesta es 402 con el código
subscription_required, antes de buscar y sin cobrar. La misma respuesta llega si la suscripción se cancela o no se paga, hasta que la reactives. - Hasta 5 búsquedas por segundo por cuenta, sumando las del buscador del sitio y las de la API. Con
Accept: text/htmlrecibes la constancia en esa misma consulta, sin costo aparte; pedirla después repitiendo la clave es otra búsqueda y cuesta una.
Cancelar suscripción
La suscripción se cancela de inmediato. No se reembolsa ni se prorratea el mes en curso. Tu llave deja de buscar (responde 402) y puedes volver a suscribirte cuando quieras.