Uso, fiabilidad y tratamiento de datos
Comprende los registros, niveles, errores, reintentos, credenciales, retención y activación sin conexión.
Unidades, niveles y ciclos de facturación
Una unidad base abarca hasta 1.000 puntos de código Unicode por texto, redondeando cada texto por separado hacia arriba, con un mínimo de una unidad. El nivel de API aplica su factor. Las fracciones se conservan en décimas de unidad.
| Nivel | Factor de unidad | Límite de solicitudes nativas |
|---|---|---|
| Standard | 1,0 | 64 textos · 200.000 puntos de código por texto |
| Batch | 0,5 | 200 textos · 200.000 puntos de código por texto |
| Real-Time | 1,6 | 4 textos · 4.000 puntos de código por texto |
Por ejemplo, dos textos de 800 caracteres consumen 2 unidades Standard, 1 Batch o 3,2 Real-Time. Batch nativo es un nivel de menor prioridad; los trabajos asíncronos de Azure tienen un ciclo distinto.
Primero se usa la cuota del plan y después los paquetes. La cuota mensual se reinicia en cada ciclo y no se acumula. Los paquetes no caducan. Una mejora pagada inicia un ciclo con toda la nueva cuota; una reducción o cancelación se aplica al final del período. Revisa el importe en el panel antes de confirmar.
Consulta el consumo en Panel o GET /v1/usage. El portal de facturación ofrece facturas PDF, datos de empresa y métodos de pago. Los impuestos aplicables se calculan al pagar y las facturas se envían por correo tras la compra.
Errores y reintentos
Los errores de la API nativa usan {"error":{"code":"…","message":"…"}}. Los endpoints compatibles con Azure usan sus propios formatos de error. Conserva X-Request-Id para el diagnóstico.
| Estado | Acción |
|---|---|
| 401 | Comprueba la clave, su revocación y el entorno. |
| 402 | Añade unidades; el error indica la cantidad necesaria y disponible. |
| 403 | Comprueba si el plan incluye el nivel solicitado. |
| 413 / 422 | Corrige la entrada o divide la solicitud dentro de los límites documentados. |
| 429 | Respeta Retry-After, y reintenta con espera creciente y aleatoria. |
| 503 | Fallo temporal del servicio. Respeta Retry-After si está presente. |
Los errores de validación y las solicitudes rechazadas antes del procesamiento no consumen unidades. Perder la conexión no demuestra un fallo: conserva la referencia y revisa el consumo antes de repetir una carga grande. Los resultados síncronos no se guardan para recuperarlos.
Tratamiento de datos y claves
Los textos síncronos y correspondencias se procesan en memoria. Los registros de consumo contienen identificadores, cantidades y tiempos, no documentos. Las entradas y resultados asíncronos requieren almacenamiento temporal cifrado y caducan a las 24 horas. Tu aplicación controla la conservación de los resultados y correspondencias recibidos.
Crea y revoca claves API en el panel. Starter permite una clave; los planes superiores hasta cinco. Las claves de producción empiezan por shr_live_, las de pruebas por shr_test_. Pertenecen a entornos separados. No las incluyas en aplicaciones del navegador, URL ni mensajes de soporte.
Activación sin conexión
