Support

Fehler werden im allgemeinen als SoapFault/Exception geworfen, so dass um jeden Aufruf ein entsprechender try AND catch Block gesetzt werden sollte. Der Fehler kann dann anhand Error-Message behandelt werden. Die Error-Message enspricht der Syntax '(ERRORCODE) ERRORMESSAGE'.

Ein Übersicht über die möglichen Fehlercodes sind im Kapitel Fehlercodes Übersicht (SoapFaults/Exceptions) zu finden.

API Version abfragen

Return: string - api version

Parameter: -

PDF-Dokumente können über POST unter folgender URL hochgeladen werden: http://epaper.1000grad.com/html/api/v2/pdf-upload

Return: string - JSON-Formatiertes Array

{
    'success': TRUE,
    'pdfId': 'PDF-ID'
} 

{
    'success': FALSE,
    'errors': {
        'clientCode': 'ERROR-Code',
        'errorDesc': 'Fehlermeldung'
    }
}  

Parameter:

• string $apikey - API Key
• file $file - PDF-Dokument

Ein Beispiel wie Sie cURL implementieren finden Sie hier.

(php: cURL - Manual)

empfängt ein PDF Dokument als Base64 codierten String. Für die weitere Verarbeitung wird eine PDF ID zurückgegeben, welche für die Erstellung eines ePapers verwendet werden kann. Diese Funktion ist nur für PDF Dokumente bis 50 MB geeignet! Verwenden Sie stattdessen die Funktion PDF Upload über Formular!

Return: string - PDF ID

Parameter:

• string $apikey - API Key
• string $base64code - Base64 kodierte PDF-Datei (php: base64_encode)

Informationen zu einem PDF. Falls die pdfid nicht gefunden wird, wird ein leeres Array ausgegeben.

Return: string - JSON-Formatiertes Array

Parameter:

• string $apikey - API Key
• string $pdfid - PDF ID

Erstellt ein ePaper aus der PDF ID von pdfUploadAsBase64. Die ePaper ID wird in weiteren Methoden benötigt. Damit ist das ePaper im System angelegt. Anschließend muss noch der Render-Prozess gestartet werden über epaperStartRenderprocess

Return: string - ePaper ID

Parameter:

• string $apikey - API Key
• string $pdfid - PDF ID aus der Funktion pdfUploadAsBase64

Startet den Renderprozess für ein ePaper.

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID aus der Funktion epaperCreateFromPdf

Tauscht die PDF Datei eines existierenden ePaper gegen eine andere PDF Datei aus

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID
• string $base64code pdf as base64 encoded string
• integer $pageNum
• boolean $replacePage
• string $insertPosition
• string json formatted

Gibt Informationen zu einem ePaper als Json String zurück.

{
    'id': 'ID',
    'filename': 'Dateiname',
    'secure_filename': 'Dateiname mit sicheren Zeichen'
    'title': 'Titel'
    'pages': 'Seitenzahl'
    'zip_url': 'URL zur ZIP Datei, falls publiziert'
    'published': 'Publiziert ja/nein (0,1)'
    'status': 'Status Text',
    'renderprocess': {
        'status_text': 'Status Text',
        'current_page': 'Anzahl fertige Seiten',
        'percent': 'fertig in Prozent',
        'process_level': '0: Kein Prozess, 1: Renderprozess, 2: Publikationsprozess'
    },
    'settings': {
        //ePaper Einstellungen 'key': 'value'
    }
}

Weitere Informationen zum ePaper Status Text sind im Kapitel ePaper Status Übersicht zu finden.

Return: string JSON-Format

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Gibt den Statustext eines ePaper zurück.

Weitere Informationen zum ePaper Status Text sind im Kapitel ePaper Status Übersicht zu finden.

Return: string

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Löscht ein ePaper

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Ermittelt die ID eines ePaper anhand eines übergebenen Pfades. Wird kein ePaper ermittelt, wird ein leerer String zurückgegeben.

Return: string - ePaper ID

Parameter:

• string $apikey - API Key
• string $path - Pfad des ePaper, z.B.: ornder1/ordner2/epaper_dateiname

Legt eine ePaper Einstellung fest.

Weitere Informationen zu den Einstellungen sind im Kapitel ePaper Settings zu finden.

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID
• integer $pageId - ID Page, entspricht im Normalfall der Seitennummer, sofern keine Seiten gelöscht oder hinzugefügt wurden. Seiten können über die Methode epaperGetPages abgefragt werden
• array $options - enthält die Werte zum Setzen von Titel, Kurzbeschreibung, Autor, Einrückung und ob der Eintrag im Ihvz. aktiv ist

Legt den Namen eines ePapers fest.

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID
• string $name - Name des ePapers

Legt eine ePaper Einstellung fest.

Weitere Informationen zu den Einstellungen sind im Kapitel ePaper Settings zu finden.

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID
• string $key - Einstellungs Key
• string $value - Wert

Setzt für die ePaper Einstellungen verschiedene Grafiken. Grafiken werden als String Parameter base64 kodiert übergeben.

Weitere Informationen zu den Einstellungen sind im Kapitel ePaper Settings zu finden.

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID
• string $key - Erlaubte Werte: 'logo', 'background', 'background_left', 'background_right'
• string $file - Pfad des Bildes, falls ein leerer String angegeben wird, wird das entsprechende Bild entfernt

Fügt Media Items einer Seite im ePaper hinzu.

Return: int - ID Media

Parameter:

• string $apikey - API Key
• string $epaperId - ID des epaper
• integer $pageId - ID Page, entspricht im Normalfall der Seitennummer, sofern keine Seiten gelöscht oder hinzugefügt wurden. Seiten können über die Methode epaperGetPages abgefragt werden
• string $type - Erlaubte Werte: 'link': Weblink, 'gallery': Bildergallerie(noch nicht implentiert), 'video': Video, 'linkintern': interner Link
• string $data - siehe Information zu $data
• array $options - siehe Information zu $options

Information zu $data:

Je nach $type übergebenen Werten, werden folgende Angaben erwartet:

Information zu $options:

Updatet ein Media Item

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ID des epaper
• integer $pageId - ID Page (siehe auch epaperGetPages)
• integer $mediaId - ID Media (siehe auch epaperGetMediaItems)
• string $type - Erlaubte Werte: 'link': Weblink, 'gallery': Bildergallerie(noch nicht implentiert), 'video': Video, 'linkintern': interner Link
• string $data - siehe Information zu $data
• array $options - siehe Information zu $options

Information zu $data:

Je nach $type übergebenen Werten, werden folgende Angaben erwartet:

Information zu $options:

Löscht ein Media Item

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID
• integer $pageId - ID Page (siehe auch epaperGetPages)
• integer $mediaId - ID Media (siehe auch epaperGetMediaItems)

epaperSetDownloadOptionForPage

Gibt eine Liste aller im ePaper vorhandenen Seiten als Json Array zurück.

Return: string - JSON-Format

[{
    'id': '1', //integer - ID Page
    'page': '1', //integer - Page number
    'render_done': true, //boolean - page render complete 
    'render_error': false, //boolean - error occured on render process 
    'error_text': NULL, //string - error text 
    'error_swf': NULL, //string - error text 
    'pdf_width': '595', //integer - page width of pdf,
    'pdf_height': '842', //integer - page height of pdf 
    'swf_width' = > '565', //integer - page width after rendering
    'swf_height' = > '799', //integer - page height after rendering 
    'swf_quality' = > '1' //integer - quality identifier of rendered swf(1: best)
}, {
    'id': '2', //integer - ID Page
    'page': '2', //integer - Page number
    'render_done': true, //boolean - page render complete 
    'render_error': false, //boolean - error occured on render process 
    'error_text': NULL, //string - error text 
    'error_swf': NULL, //string - error text 
    'pdf_width': '595', //integer - page width of pdf,
    'pdf_height': '842', //integer - page height of pdf 
    'swf_width' = > '565', //integer - page width after rendering
    'swf_height' = > '799', //integer - page height after rendering 
    'swf_quality' = > '1' //integer - quality identifier of rendered swf(1: best)
}, {
    ...
}]

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Gibt die komplette Liste mit den Media Items eines ePaper als Json String zurück

Return: string - JSON-Format

[{
    'id': '1',
    'id_page': '1',
    'sort_num': '1',
    'media_type' = > 'link',
    ...more...
}, {
    'id': '2',
    'id_page': '1',
    'sort_num': '2',
    'media_type' = > 'video',
    ...more...
}]

Parameter:

• string $apikey - API Key
• string $epaperId - ePaperID

epaperGetPath

Gibt den vollen Ordner Pfad eines ePaper als String zurück

Return: string - Pfad des ePapers, z.B.: /folder1/folder2/myepaper

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Verschiebt ein ePaper in einen Ordner

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID
• string $targetPath - Zielpfad des ePaper inkl. Dateiname
• boolean $overwrite - Überschreibt ein ePaper falls ePaper mit Dateinamen bereits vorhanden ist

Achtung: Bei der Verwendung der REST API kann für $overwrite nur 0 als Wert für false übergeben werden. Alle anderen Werte (true, false, 1, etc..) werden als String und damit als true interpretiert.

Gibt eine Liste von ePapern anhand des Verzeichnisses als Json String zurück

Return: string - JSON-Format

[{
    'id': '4f965147a414c',
    'status': 'ready',
    'filename': 'myepaper1',
    'pages': 12
}, {
    'id': '4f9655b8828a5',
    'status': 'ready',
    'filename': 'myepaper2',
    'pages': 24
}]

Parameter:

• string $apikey - API Key
• string $folder - Name/Pfad des Ordners

Publiziert ein ePaper.

Achtung: Fehler 1101 wird geworfen, fall nicht genügend Lizensen vorhanden sind.

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Überträgt ein ePaper auf einen FTP Server, falls die FTP Zugangsdaten im Ordner angegeben sind.

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Gibt die URL der Zip zurück, falls ZIP nicht vorhanden, wird ein Fehler 1301 geworfen.

Return: string - URL

Parameter:

• string $apikey - API Key
• string $epaperId - ePaper ID

Importiert eine ePaper Exportdatei

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ID des ePaper
• string $base64code - Base64 kodierte ePaper Export Datei
• boolean $importPages - Importieren der Seiteninformationen, wie Titel, Beschreibung, Autor
• boolean $importSettings - Importieren der ePaper Einstellungen
• boolean $importMedia - Importieren der Media Items
• boolean $deleteMedia - bereits vorhandene Media Items überschreiben
• boolean $importGalleries - Importieren der Galerien
• boolean $deleteGalleries - bereits vorhandene Galerien überschreiben

Gibt die komplette Baumstruktur eines Accounts als Json String zurück

Return: string - JSON-Format

[{
    'level': '1',
    'name': 'folder1',
    'children': [{
        'level': '2',
        'name': 'subfolder1',
        'children': []
    }, {
        'level': '2',
        'name': 'subfolder2',
        'children': []
    }, ...]
}, {
    'level': '1',
    'name': 'folder2',
    'children': []
}, ...]

Parameter:

• string $apikey - API Key

Bereich Weblink (Kanäle)

channelsGetList

Gibt eine Liste der verfügbaren Kanäle als Json String zurück

Return: string - JSON-Format

Parameter:

• string $apikey - API Key

channelsGetChannelInfo

Gibt die Informationen für einen besitmmten Kanal zurück

Return: string - JSON-Format

Parameter:

• string $apikey - API Key
• string $channelId - ID des Kanals

channelsPublishEpaperToChannel

Publiziert ein ePaper in einen Kanal

Return: boolean

Parameter:

• string $apikey - API Key
• string $epaperId - ID des ePapers
• string $channelId - ID des Kanals

channelsRemoveEpaperFromChannel

Entfernt ein vorhandenes ePaper aus einem Kanal

Return: boolean

Parameter:

• string $apikey - API Key
• string $channelId - ID des Kanals

channelsSetChannelTitle

Setzt den Titel eines Kanals

Return: boolean

Parameter:

• string $apikey - API Key
• string $channelId - ID des Kanals
• string $title