Integra con datos y límites claros.

La API es informativa. Preparación para producción en curso: los objetivos siguientes no constituyen un SLA contractual ni una garantía de tasas para cobros o documentos fiscales.

Primera consulta desde tu servidor

cURL
curl --fail-with-body 'https://api.divisa.do/v1/rates?currency=USD&freshness=current' \
  -H "Authorization: Bearer $DIVISA_API_KEY"

Conserva las claves en secretos del servidor. Crea una aplicación por integración. Todas las aplicaciones de producción de una cuenta comparten 1,000 solicitudes diarias y 60 por minuto. Puedes mantener dos claves por aplicación y una tercera durante la rotación de 24 horas.

Cómo interpretar una tasa

buy es la compra de la entidad; sell es su venta. En el parámetro operation, buy significa que el usuario compra y sell que vende. Los importes son cadenas decimales; usa aritmética decimal, nunca Number para calcular dinero. Un lado ausente es null.

Conserva id, entityId, channel, kind, provenance, effectiveDate, publishedAt, datePrecision, lastCheckedAt y expiresAt. provenance identifica la fuente y extracción sin divulgar evidencia privada. Una comprobación reciente no significa una publicación reciente. Las fuentes sin fecha permanecen identificadas como unknown.

Vigencia y cobertura

Los ciclos generales comprueban fuentes a las 08:00, 12:00 y 17:00, hora dominicana. Cada fuente decide cuándo publica. Consulta /v1/coverage para la cobertura pública seleccionada, y freshness=current o freshness=stale para filtrar tasas. Las referencias oficiales no compiten en rankings comerciales.

Un 200 con data vacío significa que no hay coincidencias. Un 503 significa que una dependencia necesaria no está disponible. No conviertas ausencia de datos en cero ni sustituyas una tasa vencida sin avisar al usuario.

Errores, reintentos y caché

401: revisa la clave. 429: espera Retry-After. 503: reintenta con backoff y jitter, con máximo de tres intentos y timeout. Guarda X-Request-Id al reportar errores; no registres Authorization. ETag permite If-None-Match y 304. Las consultas condicionales también consumen cuota. Las respuestas autenticadas no se almacenan en cachés compartidas.

Las colecciones incluyen enlaces HTTP Link a self, describedby y next cuando corresponde en JSON. La paginación por cursor numérico no representa un snapshot: los datos pueden cambiar entre páginas.

Guía de integración desde el backend

Consulta desde el backend, muestra fecha y estado junto con la tasa, conserva su identificador y fuente y maneja explícitamente datos ausentes. Este recorrido valida consultas informativas. Fijar pagos o emitir documentos fiscales requiere acordar primero fuente, fecha y reglas aplicables.

Objetivos y soporte

Objetivos: 99.9% de disponibilidad mensual, p95 menor de 500 ms en lecturas habituales y 99% de ciclos terminados en 30 minutos. Su cumplimiento está pendiente de medición externa durante 30 días. Consulta el estado del servicio. Soporte: info@refactoring.do; sin cobertura humana 24/7 prometida.

Versiones

v1 conserva sus rutas, parámetros y formatos JSON/XML. Las ampliaciones son compatibles. Las rupturas requieren otra versión y anuncio de migración. La exigencia de claves se activará después de validar el registro y anunciar una transición fija de 14 días.

Referencia interactiva · Acceso y cuotas · Cambios del contrato