API

RibLink.ru stellt eine einheitliche Programmierschnittstelle für die Interaktion mit den Komponenten des Systems bereit.

Eine an die API von RibLink.ru gesendete Anfrage erfolgt durch die Übergabe von POST- oder GET-Parametern, der Nutzer-ID (Parameter user_id), in deren Namen die Anfrage ausgeführt wird, sowie eines Schlüssels (Parameter skey), der durch Verschlüsselung der nach Schlüssel sortierten Parameter ("zusammengefügt" mit dem Zeichen ":") mit der Methode sha256 und dem geheimen Schlüssel des Nutzers gebildet wird. Die Erzeugung des API-Schlüssels in PHP sieht wie folgt aus: hash_hmac('sha256', implode(':', $params), {Ваш API ключ из панели управления}, false)
 

Je nachdem, in welcher Sprache (en, ru, de, fr, es, zh, hi) und  in welchem Format Sie die Antwort erhalten möchten (JSON oder XML), wird das Format der Anfrage-URL festgelegt.
 

Um nicht für alle gleichartigen Antwortvarianten doppelte Einträge anzulegen, konzentriert sich diese Anleitung auf die Beschreibung der Arbeit mit der API unter Verwendung Ihrer Sprache de und des einfachsten Formats zur Beschreibung der Daten - JSON.

Die von der API zurückgegebene Antwort gibt es in zwei Typen:
1. Erfolgreiche Operation: {result: true, data: ... }
2. Fehler: {result: false, data: "Fehlerbeschreibung"}, oder {result: false, data: {"param1" => "Fehlerbeschreibung", "param2" => "Fehlerbeschreibung2", ...}}

Bitte beachten Sie, dass alle Datums- und Zeitangaben, die Sie über die API erhalten, in der Zeitzone des Nutzers angegeben werden, in dessen Namen die Anfrage ausgeführt wird. Die Zeitzone des Nutzers kann in den Einstellungen geändert werden.

Sie können eine fertige Lösung verwenden und den PHP-Client für die Arbeit mit der API mit Beispielen herunterladen.

Operationen

Hinweis: Pflichtfelder sind blau markiert.

{
	"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"
	}
}
							

{
	"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"
	}
}
							

{
	"result": true
}
							

{
	"result": true
}
							

{
	"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"
	}
}
							

{
	"result": true
}