https://api.getincloud.online/jacaerys/v1/forwards/keywordsListar palabras clave del usuario
Recupera todas las palabras clave asociadas a la cuenta del usuario.
GET https://api.getincloud.online/jacaerys/v1/forwards/keywordsSirve para obtener una visión general de los términos de activación configurados en los diferentes procesos de reenvío.
Parámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| page | integer | No | Número de página para la paginación. |
| limit | integer | No | Cantidad de registros por página. |
| clientId | string | No | Filtra las palabras clave asociadas a un identificador de cliente específico. |
| externalId | string | No | Filtra los resultados según un identificador de sistema externo. |
Encabezados
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Authorization | string | Sí | Token de portador para la autenticación. Formato: Bearer <YOUR_TOKEN>. |
| accept | string | No | application/json. |
Respuestas
- 200 OK: la solicitud fue exitosa.
- keywords (array de objetos): palabras clave encontradas. Cada objeto incluye:
- keyword (string): texto de la palabra clave.
- origin (string): código corto o número largo al que está vinculada.
- processId (string): identificador único del proceso de reenvío que usa esta palabra clave.
- meta (objeto): datos de paginación.
- totalItems (integer): total de palabras clave encontradas.
- itemCount (integer): cantidad de elementos en la respuesta actual.
- itemsPerPage (integer): límite de elementos por página.
- totalPages (integer): total de páginas disponibles.
- currentPage (integer): página actual.
- 400 Bad Request: parámetros de consulta mal formateados.
- 401 Unauthorized: el token Bearer es inválido, ha expirado o no se proporcionó.
- 403 Forbidden: el usuario no tiene permisos para acceder a la lista de palabras clave de este cliente o entorno.
- 404 Not Found: no se encontraron palabras clave bajo los criterios especificados.
- 500 Internal Server Error: error inesperado en el servidor.
Notas técnicas
- Unicidad: dentro de un mismo origin, las palabras clave deben ser únicas. Este listado permite verificar qué términos ya están ocupados.
- Codificación y sensibilidad: las palabras clave se almacenan como cadenas de texto y el sistema suele tratarlas sin distinguir mayúsculas y minúsculas (case-insensitive). Se recomienda mantener la consistencia en el registro.
- Segmentación: las palabras clave con caracteres especiales pueden influir en la lógica de coincidencia si el terminal del usuario final envía el mensaje en una codificación distinta (como Unicode en lugar de GSM-7).
Ejemplo de solicitud
curl --request GET \
--url 'https://api.getincloud.online/jacaerys/v1/forwards/keywords?page=1&limit=10' \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN'Respuesta 200 OK
{
"keywords": [
{
"keyword": "PROMO",
"origin": "141518",
"processId": "fwd_123456789"
},
{
"keyword": "AYUDA",
"origin": "141518",
"processId": "fwd_987654321"
}
],
"meta": {
"totalItems": 2,
"itemCount": 2,
"itemsPerPage": 10,
"totalPages": 1,
"currentPage": 1
}
}