Manual für API Query für Bild-Anbieter und ProgrammiererCliparto API-Anfragen akzeptiert automatische Anfragen an die Datenbank von Cliparto von anderen Web-Servern oder lokalen Software-Programmen, um die tatsächlichen Zahlen der aktuellen Bilanz, die Anzahl der Downloads, die Anzahl der Bilder, den aktuellen Status des Bildes und andere Daten zu liefern. Wichtiger Hinweis: Die automatische Anfragen werden nur über die API-Abfrage erlaubt. Cliparto behält sich das Recht, den Zugang zu dem Webseite im Falle der Verarbeitung bestimmter Seiten zu blockieren. Wie funktioniert es? Wir haben sehr einfachen Algorithmus für die Datenausgabe:
1. Ihr Skript sendet eine GET-Anfrage an unseren Server an https://cliparto.com/apiq/
2. Unser System prüft die Anfrage.
3. Wann die Anfrage enthält keine Fehler, dann die angefordertene Informationen auf der Seite der Anfrage angezeigt. Andernfalls wird der Fehler angezeigt. Abfrageoptionen Jeder Antrag muss die folgenden Parameter enthalten:
id - eindeutige Benutzer-ID (Sie können es auf der Seite der Benutzer-Einstellungen zu finden)
q - Anfrage-Typ (Liste der akzeptierten Anfrage-Typen wird im folgenden Abschnitt gezeigt)
ext - zusätzliche Parameter (optional, abhängig von der Art der Anfrage)
md5 - MD5-Hash der Anfrage (entsprechend RFC 1321 - The MD5 Message-Digest Algorithm) Um den MD5-Hash zu berechnen, müssen Sie eine Zeichenfolge, die alle Anfrage-Parameter enthält, wie nachfolgend beschrieben zu machen und geben es in dem Wert auf Ihre Skriptsprachen MD5-Funktion. Beispiel: md5 ( id + q + ext + API Code ) Sie können Ihren API-Code auf der Seite der Benutzer-Einstellungen generieren. Beispiel des PHP-Codes um MD5-Hash zu generieren: $string_to_hash=$id.$q.$ext.$api_code;
$md5=md5($string_to_hash); Beispiel der Anfrage: https://cliparto.com/apiq/?id=176050&q=BalanceCurrent&md5=372aadd1bad841a7c898b57dbbecab44 id => 176050 q => BalanceCurrent ext => API Code => 8zn2eBj90M0F md5 => md5( 176050BalanceCurrent8zn2eBj90M0F ) => 372aadd1bad841a7c898b57dbbecab44 Type der Anfragen
q | ext | Daten |
BalanceCurrent | n/a | Die eigentliche Benutzer-Bilanz (USD) |
EarningsTotal | n/a | Der Erwerb für die ganze Zeit |
EarningsThisMonth | n/a | Der Erwerb in diesem Monat (USD) |
EarningsPrevMonth | n/a | Der Erwerb im Vormonat (USD) |
DownloadsTotal | n/a | Die Anzahl der Downloads für die ganze Zeit |
DownloadsThisMonth | n/a | Die Anzahl der Downloads in diesem Monat |
DownloadsPrevMonth | n/a | Die Anzahl der Downloads im Vormonat |
DownloadsList | 1-100 stillschweigend - 10 | Die Liste der letzten Downloads; ext - Anzahl der ausgegebenen Datensätze (Zeilen); Format jeder Zeile - Datum, ID des Bildes, Lizenz-Typ, Größe des Bildes; Erwerb (USD); Land des Kunden (ISO); Suchanfrage |
ImagesTotal | n/a | Die Anzahl der akzeptierten Bilder |
ImagesNew | n/a | Die Anzahl der akzeptierten Bilder in diesem Monat |
ImagesNewPrevMonth | n/a | Die Anzahl der akzeptierten Bilder im Vormonat |
ImageIDByFileName | Dateiname | Gibt die ID des Bildes durch den ursprünglichen Dateinamen; ext - der ursprüngliche Dateiname (ohne Dateinamenerweiterung) |
ImageData | ID des Bildes | Information über das Bild anhand seines ID; ext - ID des Bildes; Format des Outputs - Status des Bildes; Bildtitel; Bildansichten; Downloads des Bildes; Bild-Erwerb (USD); Serie-ID; ursprüngliche Dateiname |
ProcessFilesFromFTP | n/a | All Dateien hochgeladen durch FTP in Upload-Queue hinzufügen |
SubmitToPending | n/a | Alle hochgeladene Bilder zur Prüfung einreichen |
ReleasesList | n/a | Komplette Liste aller Freigaben hochgeladen; Format des Outputs - ID; Typ (1 - Modell, 2 - Eigentum); Name |
AttachReleaseToImage | Release ID:Image ID | Freigabe (Release ID) zum Bild (Image ID) fügen |
Einschränkungen - Nicht mehr als eine Anfrage innerhalb von 20 Sekunden;
- Die gleiche Anfrage mit den gleichen Parametern sollte nicht innerhalb einer Stunde wiederholt werden |