Weclapp

In dieser Anleitung erfährst du, wie du in weclapp einen API-Key (Token) erstellst, um anschließend über die REST API auf deine Daten (z. B. Kunden, Angebote, Rechnungen) zuzugreifen. Dies ist nützlich, wenn du externe Tools oder eigene Skripte mit weclapp integrieren möchtest.

---

🔐 Schritt 1: API-Key in weclapp erstellen

1. Einloggen in weclapp

• Gehe zu https://www.weclapp.com/

• Melde dich mit deinem Benutzerkonto an.

2. Zu den Benutzereinstellungen navigieren

• Klicke oben rechts auf dein Benutzerprofil (Avatar).

• Wähle „Mein Profil“ aus.

3. API-Token generieren

• Im Profil findest du den Reiter „API-Token“ oder „Zugriffstoken“.

• Klicke auf „Neues Token erstellen“.

• Vergib einen aussagekräftigen Namen, z. B. „Integration mit externem Tool“.

• Kopiere den angezeigten Token sofort – er wird nach dem Speichern nicht erneut angezeigt.

Der Token ist wie ein Passwort! Bewahre ihn sicher auf und teile ihn nicht öffentlich. Solltest du ihn verlieren, musst du einen neuen Token generieren.

Lege für jede Integration (z. B. ERP-Schnittstelle, Automatisierung, Zapier) einen eigenen Token an, um bei Bedarf gezielt Zugriffe widerrufen zu können.

---

🌐 Schritt 2: Erste API-Anfrage stellen

Voraussetzungen

• Dein API-Token aus Schritt 1

• Eine Umgebung zur Anfrage wie Postman, curl oder Python-Script

• Deine weclapp-Instanz-URL, z. B. https://deinefirma.weclapp.com

---

Beispiel mit cURL

curl -X GET "https://deinefirma.weclapp.com/webapp/api/v1/customer" \
  -H "AuthenticationToken: DEIN_API_TOKEN"

---

Beispiel mit Python

import requests

API_TOKEN = 'DEIN_API_TOKEN'
BASE_URL = 'https://deinefirma.weclapp.com/webapp/api/v1/customer'

headers = {
    'AuthenticationToken': API_TOKEN
}

response = requests.get(BASE_URL, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Fehler: {response.status_code} - {response.text}")

Wenn du eine 403- oder 401-Fehlermeldung erhältst, überprüfe, ob der Token gültig ist und dein Benutzer die erforderlichen Berechtigungen in weclapp besitzt.

---

🔍 Optional: Filter und Parameter

Die weclapp API unterstützt Filter über URL-Parameter. Damit kannst du gezielt Datensätze abfragen, z. B. nach Kundennummer, Angebot oder Status.

Beispiel: Kunden mit bestimmter Kundennummer

https://deinefirma.weclapp.com/webapp/api/v1/customer?customerNumber=10001

Du kannst Filter kombinieren, um präzise Datenabfragen zu erstellen, z. B. nach Datum, Kundentyp oder Rechnungsstatus.

---

📚 Weitere Informationen

Offizielle API-Dokumentation: 👉 https://www.weclapp.com/de/api/

Sie enthält:

• Alle verfügbaren Endpunkte

• Filter- und Sortiermöglichkeiten

• Rückgabeformate (JSON)

• Beispielanfragen

✅ Nach erfolgreicher Einrichtung kannst du deine weclapp-Daten automatisiert abrufen oder in externe Systeme integrieren.