API
RibLink.ru proporciona una interfaz de programacion unica para interactuar con los componentes del sistema.
La solicitud enviada a la API de RibLink.ru se realiza mediante la transmision de parametros POST o GET, el ID del usuario (parametro user_id) en cuyo nombre se realiza la solicitud, asi como una clave (parametro skey) que se forma mediante el cifrado de los parametros ordenados por clave ("pegados" mediante el simbolo ":") con el metodo sha256 y la clave secreta del usuario. La generacion de la clave API en PHP tiene el siguiente aspecto: hash_hmac('sha256', implode(':', $params), {Ваш API ключ из панели управления}, false)
Su clave para la API: inicia sesion para verlo
Dependiendo del idioma (en, ru, de, fr, es, zh, hi) y del formato en que desee recibir la respuesta (JSON o XML), se establece el formato del enlace de la solicitud.
Ejemplo: https://api.riblink.rues/request/json/campaigns/create
Para no duplicar registros para todas las variantes de respuesta del mismo tipo, la presente guia se centrara en la descripcion del trabajo con la API utilizando su idioma es y el formato de descripcion de datos mas sencillo: JSON.
La respuesta recibida de la API puede ser de dos tipos:
1. Exito de la operacion: {result: true, data: ... }
2. Error: {result: false, data: "descripcion del error"}, o bien {result: false, data: {"param1" => "descripcion del error", "param2" => "descripcion del error2", ...}}
Tenga en cuenta que todas las fechas y horas que reciba mediante el acceso a la API se indican en la zona horaria del usuario en cuyo nombre se realiza la solicitud. La zona horaria del usuario se puede cambiar en la seccion de Configuracion.
Puede utilizar una solucion ya preparada y descargar el cliente de interaccion con la API en PHP con ejemplos.
Operaciones
Nota: los obligatorios estan marcados en azul.
Crear campana / Actualizar datos de la campana
https://api.riblink.ru/es/request/json/campaigns/createParametros:
- title - Nombre de la campana
- campaign_id - ID de la campana si quieres actualizar los datos de una campana creada anteriormente
- links_type - Tipo de enlaces: 0 - solo clave (predeterminado), 1 - clave y parte del enlace
- ads_type - Tipo de publicidad: 0 - desactivado, 1 - pagina de carga (predeterminado)
- ads_popunder - Conectar popunder/clickunder (activado por defecto)
- ads_adult - Permitir publicidad para adultos (adult) (desactivado por defecto)
- ads_interval - Intervalo de visualizacion de anuncios para la misma persona (seg.): 0 - sin limites (predeterminado), 3600 - una vez por hora, 86400 - una vez por dia
- show_dest_url - Mostrar al usuario el enlace final de destino (desactivado por defecto)
- links_title - Titulo para todos los enlaces
- links_description - Descripcion para todos los enlaces
- links_button - Texto del boton de redireccion
- public_stat - Estadisticas publicas en los enlaces
- password - Contrasena para enlaces
- password_confirm - Repite la contrasena
- domain_id - ID del dominio que conectaste antes. Todos los enlaces de la campana usaran este dominio
Ejemplo de respuesta:
{
"result": true,
"data": {
"id": 521,
"title": "My new campaign",
"type": "manual",
"status": "active",
"ads_type": 0,
"ads_popunder": 1,
"ads_adult": 0,
"ads_interval": 0,
"links_type": 0,
"show_dest_url": 0,
"links_title": "",
"links_description": "",
"links_button": "",
"has_links_password": true,
"domain": "https://rib1.ru",
"public_stat": 0,
"urls_amount": 0,
"created": "2017-09-15 20:38:54"
}
}
Obtener datos de la campana
https://api.riblink.ru/es/request/json/campaigns/getParametros:
- campaign_id - ID de la campana
Ejemplo de respuesta:
{
"result": true,
"data": {
"id": 521,
"title": "My new campaign",
"type": "manual",
"status": "active",
"ads_type": 0,
"ads_popunder": 1,
"ads_adult": 0,
"ads_interval": 0,
"links_type": 0,
"show_dest_url": 0,
"links_title": "",
"links_description": "",
"links_button": "",
"has_links_password": true,
"domain": "https://rib1.ru",
"public_stat": 0,
"urls_amount": 0,
"created": "2017-09-15 20:38:54"
}
}
Crear enlace / Actualizar datos del enlace
https://api.riblink.ru/es/request/json/campaigns/links/createParametros:
- url - Enlace que debe acortarse/convertirse
- link_id - ID del enlace si quieres actualizar los datos de un enlace existente
- campaign_id - ID de la campana a la que se anadira el enlace (solo al crear uno nuevo). Si no se indica, el enlace se anadira a la campana predeterminada
- url_key - Clave del enlace (como termina el enlace corto). Si no se indica, se creara una aleatoria
- title - Nombre del enlace
- description - Descripcion del enlace
- button - Texto del boton de redireccion
- comment - Comentario del enlace (solo tu lo ves)
Ejemplo de respuesta:
{
"result": true
}
Obtener datos del enlace
https://api.riblink.ru/es/request/json/campaigns/links/getParametros:
- link_id - ID del enlace
- url_key - Clave del enlace (como termina el enlace corto)
Ejemplo de respuesta:
{
"result": true,
"data": {
"id": 36523,
"campaign_id": 521,
"campaign_title": "My new campaign",
"url_key": "bx5i",
"url": "https://riblink.ru/index/rules",
"title": "",
"description": "",
"button": "",
"comment": "",
"created": "2017-09-16 13:23:24"
}
}