Preguntas frecuentes

¿Cuánto cuesta una llamada?

Un crédito por llamada correcta, devuelva lo que devuelva. Las excepciones son los endpoints de informes en PDF y de chat con IA, que cuestan 25 créditos por llamada. Pedir un cálculo cuesta lo mismo que pedir cuarenta, porque muchos endpoints aceptan un array `keys` y todas las claves de una solicitud quedan cubiertas por ese único crédito.

¿Se cobran las solicitudes fallidas?

No. Occult API nunca cobra una solicitud fallida. El crédito se reserva antes de ejecutar el cálculo y se libera si no termina correctamente, así que un 4xx, un 5xx o un tiempo de espera agotado no cuestan nada, y una integración con errores no puede vaciarte el saldo mientras la depuras. Cada respuesta indica en la cabecera X-Credits-Charged lo que ha costado realmente.

¿Caducan los créditos?

La cuota de un plan se reinicia cada mes. Occult API se vende como planes mensuales o anuales: cada mes trae una cuota nueva, y las llamadas que no uses en un mes no pasan al siguiente. Los planes anuales funcionan igual: doce asignaciones mensuales, facturadas de una sola vez.

¿Hay un plan gratuito?

Las cuentas nuevas reciben créditos gratis que se gastan en la API real con una clave real, no en un sandbox con datos propios. Aparte, el Playground de occultapi.com/playground hace llamadas reales a la API en producción con tu propia clave, y una llamada fallida allí no cuesta nada.

¿Hay que suscribirse?

Sí. Occult API se vende como planes mensuales o anuales que se renuevan automáticamente hasta que los canceles. Al cancelar se detiene la siguiente renovación, y el periodo en curso se puede seguir usando hasta que termine. Ningún nivel deja endpoints fuera: todos los planes pueden llamar a todos los endpoints.

Recibo un 402. ¿Mi clave está mal?

No. Un 402 con el mensaje insufficient_credits significa que la clave de API es válida y que la cuota se ha agotado. Regenerar la clave no sirve de nada: mejora el plan o espera al reinicio mensual. Solo un 401 invalid_api_key indica un problema con la propia clave.

¿Puedo usar una clave de API en el navegador o en una app móvil?

No. Una clave de Occult API es un secreto de servidor. Si la pones en el JavaScript del front-end o en el paquete de una app móvil, cualquiera que instale la app o abra las herramientas de desarrollo puede leerla y gastar tu saldo. Llama a la API desde tu propio servidor y ofrece a tu cliente tu propio endpoint.

Perdí mi clave. ¿Pueden volver a enviármela?

No, y es a propósito. Occult API solo guarda las claves como hashes SHA-256, así que ni un administrador ni un volcado de la base de datos pueden recuperarlas. Crea una clave nueva y revoca la antigua: la revocación es inmediata y no afecta al saldo de créditos.

¿Qué pasa si se filtra una clave?

Revócala en la página de claves; la revocación es inmediata. Cada clave lleva un prefijo público de ocho caracteres, indexado precisamente para que, si una clave se filtra en un repositorio público, se pueda localizar y revocar solo con ese prefijo, sin que nadie necesite la parte secreta.

¿De dónde salen los cálculos?

Occult API calcula a partir de las efemérides de NASA JPL: el conjunto de datos completo, con 735 estrellas fijas, que abarca del 500 al 2999 d. C. Nada se lee de un almanaque precalculado: cada respuesta se calcula para el instante y las coordenadas exactos de la solicitud.

El resultado no coincide con otra fuente. ¿Por qué?

Lo habitual es que se deba al ayanamsa. Las tradiciones indias discrepan de verdad sobre él, y una diferencia de un grado puede hacer que un planeta cruce el límite de un nakshatra. Occult API ofrece 48 ayanamsas y permite corregir cada uno en grados, minutos y segundos, así que lo primero es comprobar si ambas fuentes usan el mismo.

¿Qué velocidad tiene?

El tiempo mediano de respuesta en servidor es de 62 ms, medido sobre todos los ejemplos publicados y no sobre uno escogido. Unos pocos endpoints hacen análisis profundos, como un barrido completo de varshaphal o un año de raasi dasha, y tardan segundos. La referencia lo indica en cada caso, en lugar de esconderlo detrás de la mediana.

¿Hay especificación OpenAPI o SDK?

Occult API publica un documento OpenAPI 3.1 en occultapi.com/openapi.json, generado a partir del mismo catálogo que la documentación, con un ejemplo en cada operación: 255 de los 299 capturados de un servidor en producción y el resto derivados del esquema de la solicitud. Puedes usarlo con openapi-generator o cualquier herramienta equivalente para generar un cliente tipado en cualquier lenguaje. También hay una colección de Postman y un servidor MCP para asistentes de IA.

¿Puede llamarla un asistente de IA?

Sí. Occult API publica un servidor MCP que expone todos los endpoints mediante cinco herramientas. Buscar endpoints y leer esquemas de solicitud a través de él no consume créditos (solo un cálculo real lo hace), así que un asistente puede explorar toda la API antes de gastar nada. En occultapi.com/AGENTS.md hay una guía para agentes de programación.

¿Puedo vender lo que devuelve la API?

Sí. Occult API concede una licencia libre de regalías para usar los datos con fines comerciales en tus propios productos, lo que incluye guardar las respuestas en tu base de datos, generar y vender informes y usarlos en trabajos para clientes. No hace falta citarnos. Lo que no está permitido es revender el acceso a la API como tal, en forma de API.

¿Guardan los datos de nacimiento que envío?

No. La fecha, la hora y el lugar de una solicitud se usan para calcular la respuesta y después no se guardan en ninguna base de datos. De cada llamada se conserva el endpoint, la marca de tiempo, el estado HTTP y los créditos consumidos, que es lo que hace falta para los informes de uso y las consultas de facturación.

¿Ofrecen un DPA?

Sí. Occult API publica un Acuerdo de Tratamiento de Datos conforme al artículo 28 del RGPD, junto con una lista actualizada de subencargados que identifica a todos los terceros que pueden acceder a los datos de los clientes.

Si tu pregunta no está aquí, escríbenos a mridul.kabra23@gmail.com. Para saber qué hemos medido y qué no, consulta la metodología; para saber qué guardamos y qué no hemos construido, la página de transparencia. Los códigos de error están todos en autenticación, donde también se explica por qué un 402 no es un fallo de autenticación.