Manual für API Query für Bild-Anbieter und Programmierer

Cliparto 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

qextDaten
BalanceCurrentn/aDie eigentliche Benutzer-Bilanz (USD)
EarningsTotaln/aDer Erwerb für die ganze Zeit
EarningsThisMonthn/aDer Erwerb in diesem Monat (USD)
EarningsPrevMonthn/aDer Erwerb im Vormonat (USD)
DownloadsTotaln/aDie Anzahl der Downloads für die ganze Zeit
DownloadsThisMonthn/aDie Anzahl der Downloads in diesem Monat
DownloadsPrevMonthn/aDie Anzahl der Downloads im Vormonat
DownloadsList1-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
ImagesTotaln/aDie Anzahl der akzeptierten Bilder
ImagesNewn/aDie Anzahl der akzeptierten Bilder in diesem Monat
ImagesNewPrevMonthn/aDie Anzahl der akzeptierten Bilder im Vormonat
ImageIDByFileNameDateinameGibt die ID des Bildes durch den ursprünglichen Dateinamen;
ext - der ursprüngliche Dateiname (ohne Dateinamenerweiterung)
ImageDataID des BildesInformation ü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
ProcessFilesFromFTPn/aAll Dateien hochgeladen durch FTP in Upload-Queue hinzufügen
SubmitToPendingn/aAlle hochgeladene Bilder zur Prüfung einreichen
ReleasesListn/aKomplette Liste aller Freigaben hochgeladen;
Format des Outputs - ID; Typ (1 - Modell, 2 - Eigentum); Name
AttachReleaseToImageRelease ID:Image IDFreigabe (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

◢ Mein Cliparto
Haben Sie Vector-Images.com Konto?
Sie brauchen nicht erneut registrieren. Verwenden Sie einfach Ihren Login auf Cliparto auch.

 

Hilfe
Tel.: +1-941-404-2399
E-mail: help@cliparto.com
Impressum Rechtliches Partnerschaft
0.856