Was ist ikas.dev?

ikas.dev ist die zentrale Plattform für Entwickler, die Apps oder Themes für das E-Commerce-System von ikas erstellen möchten. Ob Du eigene Themes von Grund auf programmieren willst oder mithilfe der leistungsstarken GraphQL-API eine App entwickeln möchtest – ikas.dev bietet Dir alle Werkzeuge und die passende Dokumentation dazu.

Was kannst Du auf ikas.dev machen?

Auf ikas.dev stehen Dir derzeit folgende Bereiche zur Verfügung:

API-Dokumentation: Alles zur Verwendung der ikas GraphQL-API
Themes: Baue eigene Themes für den ikas Storefront Editor
Dashboard: Entwicklerrelevante Funktionen des ikas-Dashboards im Überblick
Partnerbereich: Verwaltung Deiner Partner- und Entwicklerkonten
(Apps-Bereich: Coming soon)

Eigene App mit der ikas API entwickeln

Wenn Du eine eigene Anwendung erstellen möchtest, kannst Du auf die leistungsstarke GraphQL API von ikas zugreifen.

Voraussetzungen:

Logge Dich in Dein ikas-Dashboard ein.
Gehe im linken Menü zu Apps > Meine Apps.
Klicke oben rechts auf Gehe zu den privaten Apps.
Du wirst nun zur Übersichtsseite Deiner privaten Apps weitergeleitet. Klicke dort oben rechts auf Private App hinzufügen.
Gib einen App-Namen sowie eine E-Mail-Adresse ein.
Wähle als App-Typ Standard-App (Reguläre ikas-Anwendung, die über API in Deinen Shop integriert wird).
Aktiviere alle benötigten Zugriffsberechtigungen.
Definiere, ob die App ein Verkaufskanal ist.
Ist die erstellte private App ein Verkaufskanal, kannst Du mithilfe der API Bestellungen erstellen und verwalten.
Nach dem Speichern erhältst Du eine Client ID und ein Client Secret.

Diese Zugangsdaten benötigst Du, um Dich über die API zu authentifizieren.

API-Zugang:

API-Adresse: https://api.myikas.com/api/v1/admin/graphql
Playground: Interaktiver GraphQL Playground verfügbar
Authentifizierung: Token-basierte Authentifizierung über client_id und client_secret

Mehr Details zu der API-Nutzung findest Du unter API Docs auf ikas.dev/docs/intro.

Eigene Themes entwickeln

Wenn Du individuelle Storefronts gestalten möchtest, ist der Bereich Themes auf ikas.dev für Dich relevant.

Vorteile:

Themes werden mit Next.js, TypeScript und MobX entwickelt.
Du musst keine vollständigen Seiten schreiben, sondern dynamisch anpassbare React-Komponenten, also flexibel einsetzbare Bausteine.

Vor dem Start: Partnerkonto erforderlich

Bevor Du mit der Theme-Entwicklung beginnst, erstelle über die Partnerschnittstelle ein ikas-Partnerkonto und führe diese zwei Schritte aus:

Entwicklungsshop erstellen
Theme anlegen und Theme-Konfiguration erstellen

Einrichtung testen

Öffne ein Terminal und führe folgenden Befehl aus, um das Theme-Projekt auf Deinem Rechner zu erstellen:

npx create-ikas-theme@lastest

Kopiere danach Deine Theme-Konfiguration in die Datei config.json und starte das Projekt:

cd your-theme
yarn install
yarn dev

→ Dein Theme ist dann unter http://localhost:3333 erreichbar.

Hinweis: Aktuell wird nur Yarn unterstützt.

Mehr Details zu der eigenen Theme-Entwicklung findest Du unter Themes auf ikas.dev/docs/theme/getting-started/introduction .

Hinweis: Die Theme-Entwicklung befindet sich aktuell noch in der Beta-Version.

Partner-Interface nutzen

Um mit der Entwicklung zu starten, benötigst Du ein Partnerkonto:

Registriere Dich über das Partner Interface auf ikas.dev.
Erstelle einen Partner (für Dich selbst oder Deine Kunden).
Lege einen Entwicklungs-Store an.
Starte mit der Erstellung von Themes oder Apps.

Mehr Details zu dem Partner-Interface findest Du unter Partners auf ikas.dev/docs/partner/introduction .

Dashboard-Funktionen für Entwickler

Auf ikas.dev findest Du auch Dokumentationen zu relevanten Dashboard-Funktionen – etwa zur Verwaltung Deiner Themes oder Apps im Backend als Entwickler.

Mehr Details zu den Dashboard-Funktionen findest Du unter Dashboard auf ikas.dev/docs/dashboard/introduction .

Ob App oder Theme – mit ikas.dev setzt Du Deine Ideen technisch sauber und flexibel um.