API-Schlüssel holen

Jede Anfrage an Cosmos Pay wird mit einem API-Schlüssel authentifiziert. Sie erstellen und verwalten Schlüssel im Entwickler-Dashboard. Ein Schlüssel trägt zwei wichtige Eigenschaften: die Umgebung, zu der er gehört (die auf jeder Chain Testnet oder Mainnet bestimmt), und die Berechtigungen, die er nutzen darf.

Einen Schlüssel erstellen

1. Melden Sie sich an der Entwicklerplattform unter dev.cosmospay.lat an und öffnen Sie das Dashboard.
2. Wählen Sie die Umgebung über den Test-/Produktion-Schalter des Dashboards:
   • Test stellt dv_…-Schlüssel aus, die im Testnet laufen. Nutzen Sie diese während der Entwicklung.
   • Produktion stellt prod_…-Schlüssel aus, die im Mainnet laufen. Nutzen Sie diese für den Live-Betrieb.
3. Gehen Sie zu API Keys → Create.
4. Geben Sie dem Schlüssel einen Namen (und optional eine Beschreibung), damit Sie ihn später wiedererkennen.
5. Wählen Sie eine Rolle:
   • User: eingeschränkt. Wählen Sie aus der Matrix genau die Berechtigungen, die er braucht (pro Ressource: read und/oder write für Zahlungen, Webhooks, Produkte, Kunden und Analysen).
   • Admin: voller Zugriff; umgeht die Berechtigungsmatrix. Sparsam einsetzen.
6. Erstellen Sie ihn und kopieren Sie den Schlüssel sofort.

Den Schlüssel verwenden

Bewahren Sie den Schlüssel auf Ihrem Server auf und übergeben Sie ihn an das SDK (oder senden Sie ihn als Bearer-Token an die REST-API):

import { Client } from '@cosmosapp/pay_sdk';

// Reads e.g. COSMOS_PAY_API_KEY from your server environment; never hard-code it.
const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });

Authorization: Bearer dv_xxxxxxxxxxxxxxxxxxxxxxxx

Bewährte Vorgehensweise

• Ein Schlüssel pro Umgebung / Dienst. Verwenden Sie einen prod_-Schlüssel nicht im Test wieder und rotieren Sie Schlüssel pro Dienst, damit Sie einen widerrufen können, ohne den Rest lahmzulegen.
• Liefern Sie einen Schlüssel niemals an den Browser aus. Der Web-Client signiert Transaktionen mit dem Wallet des Nutzers und benötigt Ihren Schlüssel nicht.
• Bei Offenlegung rotieren. Wenn ein Schlüssel durchsickert, rotieren Sie ihn im Dashboard; der alte Wert wird sofort ungültig.

Nächste Schritte