Tools Arce Systems

Documentación de la APIs

API Documentation

La API proporciona varias funcionalidades para interactuar con diferentes servicios. Aquí está la documentación para usar estas APIs.

The API provides various functionalities to interact with different services. Here is the documentation to use these APIs.

API: Asbucket

Endpoint: POST /api/asbucket

Esta API permite cargar y almacenar archivos mediante una URL especificada.

Almacena las imágenes, videos, documentos y audios de forma permanente, para que nunca más recibas un error de “URL signature expired / Expiración del vínculo a documentos”.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Parámetros

Nombre Tipo Descripción
fileUrl string La URL del archivo que se desea cargar y almacenar.

Ejemplo de Solicitud

POST https://tools.arcesystems.com.co/api/asbucket
Headers:
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer tu_token_aqui

Body (urlencoded):
    fileUrl=https://arcesystems.com.co/assets/img/services2.png

Ejemplo de Respuesta

{
    "status": 200,
    "message": "Archivo guardado con éxito",
    "newPath": "https://tools.arcesystems.com.co/as_bucket/20240716140835_EfsoC.png"
}

{
    "status": 403,
    "message": "Access Denied: Your IP address or token is not allowed to access this page."
}

Endpoint: POST /api/asbucket

This API allows uploading and storing files via a specified URL.

Stores images, videos, documents, and audios permanently, so you never get a “URL signature expired” error again.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Parameters

Name Type Description
fileUrl string The URL of the file to be uploaded and stored.

Example Request

POST https://tools.arcesystems.com.co/api/asbucket
Headers:
    Content-Type: application/x-www-form-urlencoded
    Authorization: Bearer your_token_here

Body (urlencoded):
    fileUrl=https://arcesystems.com.co/assets/img/services2.png

Example Response

{
    "status": 200,
    "message": "File saved successfully",
    "newPath": "https://tools.arcesystems.com.co/as_bucket/20240716140835_EfsoC.png"
}

{
    "status": 403,
    "message": "Access Denied: Your IP address or token is not allowed to access this page."
}
API: Greeting

Endpoint: GET /api/greeting

Esta API devuelve un saludo basado en la hora actual del servidor.

Parámetros

Esta API no requiere parámetros.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

GET https://tools.arcesystems.com.co/api/greeting
Host: tools.arcesystems.com.co
Authorization: Bearer tu_token_aqui

Ejemplo de Respuesta

{
    "greeting": "Buenos días"
}

Endpoint: GET /api/greeting

This API returns a greeting based on the current server time.

Parameters

This API does not require parameters.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

GET https://tools.arcesystems.com.co/api/greeting
Host: tools.arcesystems.com.co
Authorization: Bearer your_token_here

Example Response

{
    "greeting": "Good morning"
}
API: Formatted Date

Endpoint: GET /api/formatted_date

Esta API devuelve la fecha actual en formato español.

Parámetros

Esta API no requiere parámetros.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

GET https://tools.arcesystems.com.co/api/formatted_date
Host: tools.arcesystems.com.co
Authorization: Bearer tu_token_aqui

Ejemplo de Respuesta

{
    "formatted_date": "15 de julio de 2024"
}

Endpoint: GET /api/formatted_date

This API returns the current date in Spanish format.

Parameters

This API does not require parameters.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

GET https://tools.arcesystems.com.co/api/formatted_date
Host: tools.arcesystems.com.co
Authorization: Bearer your_token_here

Example Response

{
    "formatted_date": "July 15, 2024"
}
API: Number to Words

Endpoint: GET /api/number_to_words/15234001

Esta API convierte un número a su representación en palabras en español.

Parámetros

El número a convertir se pasa directamente en la URL.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

GET https://tools.arcesystems.com.co/api/number_to_words/15234001
Host: tools.arcesystems.com.co
Authorization: Bearer tu_token_aqui

Ejemplo de Respuesta

{
    "number_in_words": "Quince millones doscientos treinta y cuatro mil uno"
}

Endpoint: GET /api/number_to_words/15234001

This API converts a number to its representation in Spanish words.

Parameters

The number to convert is passed directly in the URL.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

GET https://tools.arcesystems.com.co/api/number_to_words/15234001
Host: tools.arcesystems.com.co
Authorization: Bearer your_token_here

Example Response

{
    "number_in_words": "Fifteen million two hundred thirty-four thousand one"
}
API: TRM Today

Endpoint: GET /api/trm_today

Esta API obtiene la Tasa Representativa del Mercado (TRM) actual desde el servicio de datos abiertos del gobierno colombiano.

Parámetros

Esta API no requiere parámetros.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

GET https://tools.arcesystems.com.co/api/trm_today
Host: tools.arcesystems.com.co
Authorization: Bearer tu_token_aqui

Ejemplo de Respuesta

{
    "trm_today": "4010.35"
}

Endpoint: GET /api/trm_today

This API fetches the current Representative Market Rate (TRM) from the Colombian government's open data service.

Parameters

This API does not require parameters.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

GET https://tools.arcesystems.com.co/api/trm_today
Host: tools.arcesystems.com.co
Authorization: Bearer your_token_here

Example Response

{
    "trm_today": "4010.35"
}
API: Validate Days Between

Endpoint: GET /api/validate_days_between/20230901/20230923

Esta API calcula el número de días entre dos fechas dadas.

Parámetros

Nombre Tipo Descripción
start_date string La fecha de inicio en formato YYYYMMDD.
end_date string La fecha de finalización en formato YYYYMMDD.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

GET https://tools.arcesystems.com.co/api/validate_days_between/20240901/20240923
Host: tools.arcesystems.com.co
Authorization: Bearer tu_token_aqui

Ejemplo de Respuesta

{
    "days_between": 22
}

Endpoint: GET /api/validate_days_between/20230901/20230923

This API calculates the number of days between two given dates.

Parameters

Name Type Description
start_date string The start date in YYYYMMDD format.
end_date string The end date in YYYYMMDD format.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

GET https://tools.arcesystems.com.co/api/validate_days_between/20240901/20240923
Host: tools.arcesystems.com.co
Authorization: Bearer your_token_here

Example Response

{
    "days_between": 22
}
API: Split Name

Endpoint: POST /api/split_name

Esta API separa un nombre completo en nombres y apellidos.

Parámetros

Nombre Tipo Descripción
cadena string La cadena de texto que contiene el nombre completo a separar.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

POST https://tools.arcesystems.com.co/api/split_name
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer tu_token_aqui
Content-Length: 50

cadena=ALIRIA%20DEL%20CARMEN%20GONZALEZ%20VALENCIA

Ejemplo de Respuesta

{
    "nombre": "ALIRIA DEL CARMEN",
    "apellido": "GONZALEZ VALENCIA"
}

Endpoint: POST /api/split_name

This API splits a full name into first names and last names.

Parameters

Name Type Description
cadena string The text string containing the full name to be split.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

POST https://tools.arcesystems.com.co/api/split_name
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer your_token_here
Content-Length: 50

cadena=ALIRIA%20DEL%20CARMEN%20GONZALEZ%20VALENCIA

Example Response

{
    "nombre": "ALIRIA DEL CARMEN",
    "apellido": "GONZALEZ VALENCIA"
}
API: Sentiment Analysis

Endpoint: POST /api/sentiment_analysis

Esta API analiza el sentimiento de un texto dado (positivo, negativo, neutral).

Parámetros

Nombre Tipo Descripción
text string El texto que se desea analizar.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

POST https://tools.arcesystems.com.co/api/sentiment_analysis
Host: tools.arcesystems.com.co
Content-Type: application/json
Authorization: Bearer tu_token_aqui

{
    "text": "Estoy muy feliz con el servicio!"
}

Ejemplo de Respuesta

{
    "sentiment": "positive"
}

Endpoint: POST /api/sentiment_analysis

This API analyzes the sentiment of a given text (positive, negative, neutral).

Parameters

Name Type Description
text string The text to be analyzed.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

POST https://tools.arcesystems.com.co/api/sentiment_analysis
Host: tools.arcesystems.com.co
Content-Type: application/json
Authorization: Bearer your_token_here

{
    "text": "I am very happy with the service!"
}

Example Response

{
    "sentiment": "positive"
}
API: OCR DNI

Endpoint: POST /api/ocr_dni_url

Esta API procesa un archivo PDF o imagen proporcionado mediante una URL para extraer y organizar la información del DNI.

Parámetros

  • fileUrl (string, requerido): URL del archivo PDF o imagen a procesar. Máximo 2 páginas para PDFs y 4 MB para imágenes.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

POST https://tools.arcesystems.com.co/api/ocr_dni_url
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer tu_token_aqui
Content-Length: 135

fileUrl=https%3A%2F%2Fcdn.redbucket.media%2F7C866%2F20240711200132-416e-1273403wa20240711original_86ce76418e230a287c3d307bd583c973.jpeg

Ejemplo de Respuesta Exitosa

{
    "informacion_personal": {
        "nombres": "Yenith Andrea",
        "apellidos": "Escobar Gonzalez",
        "identificacion": {
            "tipo": "Cedula de Ciudadania",
            "numero": "38.680.867"
        }
    },
    "firma": "Benny Andrea Scobo. 6",
    "pais": "Colombia"
}

Ejemplo de Respuesta con Error

{
    "error": "No se pudo completar la operación. Inténtalo de nuevo."
}

Endpoint: POST /api/ocr_dni_url

This API processes a provided PDF or image file via a URL to extract and organize DNI information.

Parameters

  • fileUrl (string, required): URL of the PDF or image file to be processed. Maximum of 2 pages for PDFs and 4 MB for images.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

POST https://tools.arcesystems.com.co/api/ocr_dni_url
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer your_token_here
Content-Length: 135

fileUrl=https%3A%2F%2Fcdn.redbucket.media%2F7C866%2F20240711200132-416e-1273403wa20240711original_86ce76418e230a287c3d307bd583c973.jpeg

Example Successful Response

{
    "informacion_personal": {
        "nombres": "Yenith Andrea",
        "apellidos": "Escobar Gonzalez",
        "identificacion": {
            "tipo": "Cedula de Ciudadania",
            "numero": "38.680.867"
        }
    },
    "firma": "Benny Andrea Scobo. 6",
    "pais": "Colombia"
}

Example Error Response

{
    "error": "No se pudo completar la operación. Inténtalo de nuevo."
}
API: Shorten URL

Endpoint: POST /api/shorten

Esta API convierte URLs largas en versiones más cortas.

Uso: Facilitar el compartir enlaces en redes sociales, correos electrónicos y mensajes de texto.

Parámetros

Nombre Tipo Descripción
url string La URL larga que se desea acortar.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

POST https://tools.arcesystems.com.co/api/shorten
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer tu_token_aqui

url=https://cdn.redbucket.media/7C866/20240516150249-67b0-1273403wa20240516original_4afc001ad429cf80fb2f2c77f533eccb.jpeg

Ejemplo de Respuesta

{
    "short_url": "https://tools.arcesystems.com.co/short/jx93pA"
}

Endpoint: POST /api/shorten

This API converts long URLs into shorter versions.

Use: Facilitate sharing links on social media, emails, and text messages.

Parameters

Name Type Description
url string The long URL to be shortened.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

POST https://tools.arcesystems.com.co/api/shorten
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer your_token_here

url=https%3A%2F%2Fcdn.redbucket.media%2F7C866%2F20240516150249-67b0-1273403wa20240516original_4afc001ad429cf80fb2f2c77f533eccb.jpeg

Example Response

{
    "short_url": "https://tools.arcesystems.com.co/short/jx93pA"
}
API: QR Code Generator

Endpoint: POST /api/generate_qr_code

Genera un código QR a partir de datos proporcionados.

Parámetros

Nombre Tipo Descripción
data string Los datos que se desean codificar en el código QR.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

POST https://tools.arcesystems.com.co/api/generate_qr_code
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer tu_token_aqui

data=Hola Mundo

Ejemplo de Respuesta

[La imagen del código QR en formato PNG]

Endpoint: POST /api/generate_qr_code

Generates a QR code from provided data.

Parameters

Name Type Description
data string The data to encode in the QR code.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

POST https://tools.arcesystems.com.co/api/generate_qr_code
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer your_token_here

data=Hello World

Example Response

[The QR code image in PNG format]
API: Barcode Generator

Endpoint: POST /api/generate_barcode

Genera un código de barras a partir de datos proporcionados.

Parámetros

Nombre Tipo Descripción
data string Los datos que se desean codificar en el código de barras.

Autenticación

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Solicitud

POST https://tools.arcesystems.com.co/api/generate_barcode
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer tu_token_aqui

data=1234567890

Ejemplo de Respuesta

[La imagen del código de barras en formato PNG]

Endpoint: POST /api/generate_barcode

Generates a barcode from provided data.

Parameters

Name Type Description
data string The data to encode in the barcode.

Authentication

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Request

POST https://tools.arcesystems.com.co/api/generate_barcode
Host: tools.arcesystems.com.co
Content-Type: application/x-www-form-urlencoded
Authorization: Bearer your_token_here

data=1234567890

Example Response

[The barcode image in PNG format]
Contacto para Servicios Contact for Services

Para usar los servicios

Si desea utilizar los servicios, por favor comuníquese con Arce Systems al correo comercial@arcesystems.com.co.

La autenticación se realiza mediante IP permitida o token. Si la IP no está permitida, se debe proporcionar un token válido en el encabezado de autorización.

Ejemplo de Respuesta para IP no permitida

{
    "status": 403,
    "message": "Access Denied: Your IP address or token is not allowed to access this page."
}

To use the services

If you want to use the services, please contact Arce Systems at comercial@arcesystems.com.co.

Authentication is done via allowed IP or token. If the IP is not allowed, a valid token must be provided in the authorization header.

Example Response for Disallowed IP

{
    "status": 403,
    "message": "Access Denied: Your IP address or token is not allowed to access this page."
}