API de gestión de contactos
Gestione los grupos y contactos de cuentas de Afilnet desde nuestra API. Cree, edito o modifique información de grupos o contactos desde su propio software.
- API HTTP, Gestione grupos y contactos desde cualquier lenguaje de programación
- 99.9% SLA, Optimizamos el rendimiento de todos los servidores.
Funcionalidad de la API
Crear grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=creategroup | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
name | Nombre del grupo | Obligatorio |
type | Tipo de grupo (email o mobile) | Obligatorio |
fields | Listado de campos separados por comas, obligatorio incluir un campo movil si tipo = mobile y un campo email si tipo = email | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
INCORRECT_TYPE | Tipo incorrecto, debe ser mobile o email |
MISSING_MAIN_FIELD | Falta el campo principal (mobile si tipo = mobile o email si tipo = email) |
Parámetros:
- class : group
- method : creategroup
- user : user
- password : password
- name : test name
- type : mobile
- fields : mobile,name,address
Petición:
Obtener campos de un grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=getgroupcolumns | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : getgroupcolumns
- user : user
- password : password
- idgroup : 1000
Petición:
Añadir campo a un grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=addcolumntogroup | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
field | Campo del grupo | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : addcolumntogroup
- user : user
- password : password
- idgroup : 1000
- field : name
Petición:
Elimina campo de un grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=deletecolumnfromgroup | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
field | Campo del grupo | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : deletecolumnfromgroup
- user : user
- password : password
- idgroup : 1000
- field : name
Petición:
Eliminar un grupo de contactos
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=deletegroup | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : deletegroup
- user : user
- password : password
- idgroup : 1000
Petición:
Asigna país a un grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=assigncountrytogroup | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
countryiso3 | Código ISO del país | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
COUNTRY_NOT_FOUND | No existe ningún país con el código indicado |
Parámetros:
- class : group
- method : assigncountrytogroup
- user : user
- password : password
- idgroup : 1000
- countryiso3 : esp
Petición:
Obtener contactos del grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=getcontacts | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : getcontacts
- user : user
- password : password
- idgroup : 1000
Petición:
Obtener un contacto de un grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=getcontact | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | ID del grupo | Obligatorio |
idcontact | ID del contacto | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
NOT_ACCESS_TO_CONTACT | ERROR_NOT_ACCESS_TO_CONTACT |
Parámetros:
- class : group
- method : getcontact
- user : user
- password : password
- idgroup : 1000
- idcontact : 1000
Petición:
Añadir contacto a grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=addcontact | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
contact | Contacto a añadir con los campos separados por comas, ver ejemplo | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
CONTACT_EXISTS | Contacto ya existe en el grupo |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : addcontact
- user : user
- password : password
- idgroup : 1000
- contact : mobile:123456789,name:testname
Petición:
Añade una lista de contactos a un grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=addcontactlist | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | ID del grupo | Obligatorio |
contacts | Lista de contactos en formato JSON | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : addcontactlist
- user : user
- password : password
- idgroup : 1000
- contacts : [{"name":"Test","mobile":"34600000000"},{"name":"Test","mobile":"34600000001"}]
Petición:
Modificar contacto del grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=modifycontact | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
idcontact | Identificador del contacto | Obligatorio |
contact | Contacto a añadir con los campos separados por comas, ver ejemplo | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : modifycontact
- user : user
- password : password
- idgroup : 1000
- idcontact : 1000
- contact : mobile:123456789,name:testname
Petición:
Eliminar contacto del grupo
Parámetro | Descripción | Obligatorio / Opcional |
---|---|---|
class=group | Clase a la que se realiza la petición | Obligatorio |
method=deletecontact | Método de la clase al que se realiza la petición | Obligatorio |
user | El usuario / email de su cuenta de Afilnet | Obligatorio |
password | El password de su cuenta de Afilnet | Obligatorio |
idgroup | Identificador del grupo | Obligatorio |
idcontact | Identificador del contacto | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
Código | Descripción |
---|---|
MISSING_USER | Usuario / email no incluido |
MISSING_PASSWORD | Password no incluido |
MISSING_CLASS | Clase no incluida |
MISSING_METHOD | Método no incluido |
MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
INCORRECT_CLASS | Clase incorrecta |
INCORRECT_METHOD | Método incorrecto |
NOT_ACCESS_TO_GROUP | No dispone de permisos al grupo indicado |
Parámetros:
- class : group
- method : deletecontact
- user : user
- password : password
- idgroup : 1000
- idcontact : 1000
Petición:
Herramientas que potencian nuestra API de gestión de contactos
CONEXIÓN CON API DE FORMA SEGURA
Seguridad adaptada a su empresa
Configure sus conexiones por API, cree nuevos accesos y administre los existentes.
Filtre por IP todos los accesos a la API, añada o elimine IPs habilitadas para garantizar la seguridad de sus accesos.
Lleve un control de todas las conexiones realizadas, la API utilizada y las fechas / hora de conexión
MULTIPLES APIs
Conectividad adaptada a su empresa
Le ofrecemos multiples APIs para conectar con nosotros, disponemos de una API HTTP, BASIC AUTH, SOAP y Autenticación JWT para que conecte con nosotros de la forma que desee.
Conecte con cualquiera de las APIs de forma segura, sencilla y centralizada. Afilnet API es perfecta para su software.
API Logs
Conozca cada petición al detalle
Gracias a nuestros logs podrá revisar todas las peticiones realizadas y la correspondiente respuesta de nuestra API, lo que le permitirá consultar detalles cuando le necesite.
La información que puede consultar es la siguiente:
- IP origen de la petición
- Fecha & Hora de la petición
- API & Método al que se llama
- Parámetros enviados a la API
- Respuesta de la API
- Metadatos
Pasos para usar la API de Contactos
Utilizar la API de gestión de contactos sólo le llevará unos minutos
Solicite su prueba gratuita
Para acceder a la API de contactos deberá estar registrado cómo cliente de Afilnet. Regístrese en sólo unos minutos.
Integre la API de contactos
Relice la integración de la API de contactos con el lenguaje de programación que desee. Utilice nuestros ejemplos para una integración rápida y contacte con nuestro equipo si tiene dudas.
Utilice de forma ilimitada
Haga uso de la API de contactos cómo desee. Esta API no tiene ninguna limitación, gestione sus grupos de contactos cómo desee.
¡Bienvenido a Afilnet!
¡Todo listo!, ha conseguido mejorar sus comunicaciones con Afilnet. Estamos para darle soporte de nuestra API cuando lo necesite