Desarrolla con la API de AlwaysCompleted

Conecta AlwaysCompleted a los procesos de tu servidor para obtener servicios, crear pedidos y seguir su progreso. Esta guía te acompaña desde la primera consulta de solo lectura hasta las comprobaciones necesarias al crear pedidos. Ten abierta la referencia de la API para consultar las listas completas de parámetros y los ejemplos de respuesta.

Prepara la conexión

1. Crea una cuenta y usa su clave API en la configuración de tu servidor.
2. Consulta el catálogo de servicios y las condiciones de los servicios que quieres ofrecer. Los requisitos, las opciones disponibles y los límites de los pedidos dependen del servicio elegido.
3. Envía las solicitudes desde tu propio backend mediante HTTPS. Mantén activada la verificación habitual de certificados TLS.
4. Guarda la clave API de forma segura en tu servidor. No la incluyas en páginas públicas, JavaScript del navegador, capturas de pantalla ni ejemplos de código compartidos.

Haz tu primera consulta de solo lectura

El endpoint documentado acepta solicitudes POST y devuelve JSON. El ejemplo oficial utiliza parámetros de formulario codificados en URL. Cada acción incluye tu clave API y el nombre de la acción.

POST https://alwayscompleted.com/api/v2

key=YOUR_API_KEY&action=services

Sustituye el marcador de ejemplo solo en la configuración de tu servidor. La acción services consulta el catálogo; no crea ningún pedido. Usa la respuesta para identificar los ID de servicio y revisar los campos disponibles antes de crear tu formulario de pedidos.

Usa la información actual de los servicios y de tu cuenta

La lista de servicios indica el nombre, el tipo, la categoría, la tarifa y las cantidades mínima y máxima de cada servicio, además de los indicadores de reposición y cancelación. Relaciona el ID elegido con su descripción y requisitos actuales. Usa los datos recibidos para preparar el pedido, en lugar de copiar los ID o precios ilustrativos de los ejemplos de la documentación.

Usa action=balance para consultar el saldo de tu cuenta y su moneda. Los importes de ejemplo de la referencia son datos de muestra. Tu aplicación debe mostrar la respuesta real y gestionar los errores antes de continuar.

Gestiona los cambios de un catálogo en caché

Al actualizar un catálogo en caché, comprueba si se han eliminado ID de servicio o han cambiado las tarifas o los límites de cantidad antes de volver a habilitar las opciones guardadas. Si un ID seleccionado no aparece en la respuesta actual, pausa ese pedido para revisarlo en lugar de elegir un servicio con un nombre parecido. Si cambia una tarifa, un tipo o un límite de cantidad, actualiza el formulario y valida de nuevo la selección antes de enviar action=add. Guarda los detalles comprobados del servicio junto al registro local del pedido para poder relacionar las consultas posteriores con la selección que tu aplicación revisó realmente.

Crea pedidos con las comprobaciones necesarias

Para crear un pedido, envía action=add con el ID del servicio elegido y los campos que requiere ese tipo de servicio. Un pedido Default utiliza link y quantity; otros tipos tienen parámetros distintos. Consulta la sección correspondiente de la referencia antes de enviarlo.

Cuando el pedido se cree correctamente, guarda el ID recibido junto a tu registro del pedido. Si una solicitud agota el tiempo de espera o la respuesta no está clara, comprueba el resultado antes de repetirla. Reenviar una solicitud add sin comprobarlo puede crear un duplicado involuntario. Nunca crees pedidos como prueba automática de conexión.

Consulta los pedidos y las solicitudes posteriores compatibles

Usa action=status con order para consultar un pedido, o con orders e ID separados por comas para un lote de hasta 100. La respuesta documentada incluye status, charge, start_count, remains y currency. Revisa cada resultado: un lote puede contener un error para un ID concreto.

La reposición y la cancelación son solicitudes sujetas a disponibilidad y a las condiciones del servicio elegido. Usa action=refill para solicitar una reposición, action=refill_status para seguirla y action=cancel para solicitar una cancelación. Las variantes por lotes documentadas aceptan hasta 100 ID. Enviar una solicitud no garantiza que se apruebe la reposición o la cancelación.

Continúa con la integración

Consulta la referencia completa de la API para ver los parámetros exactos de cada acción y sus ejemplos. Si estás creando un sistema de servicios para clientes, consulta AlwaysCompleted para revendedores. Revisa los Términos y políticas junto a la descripción de cada servicio antes de aceptar pedidos de clientes.