Authentifizierung
Authentifizieren Sie sich mit einem einzigen API-Schlüssel; das Netzwerk (Testnet vs. Mainnet) wird automatisch durch das Schlüsselpräfix gewählt.
Die Authentifizierung ist bewusst minimal gehalten: ein geheimer API-Schlüssel, der auf Ihrem Server bleibt. Das Schlüsselpräfix wählt außerdem Testnet oder Mainnet für Sie aus, sodass es nichts weiter zu konfigurieren gibt. Neu hier? Siehe wie Sie Ihren API-Schlüssel erhalten.
Sie benötigen nur Ihren API-Schlüssel. Alles andere (Gateway-URL, API-Version) ist Teil der gemeinsamen Konfiguration des SDK, die von Cosmos Pay gepflegt wird.
import { Client } from '@cosmosapp/pay_sdk';
const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });Der API-Schlüssel wird als Authorization: Bearer <apiKey> gesendet.
Netzwerkauswahl (wichtig)
Das Netzwerk wird durch den Schlüsseltyp bestimmt; Sie konfigurieren es NICHT:
| Schlüsselpräfix | Netzwerk |
|---|---|
dv_… | testnet |
prod_… | mainnet |
Daher sind Asset-Aussteller netzwerkspezifisch: Verwenden Sie Assets.* für das Mainnet
und TestnetAssets.* für das Testnet (siehe Assets-Dokumentation).
Den Schlüssel auf dem Server behalten
Der API-Schlüssel ist geheim. Erstellen und validieren Sie Absichten auf Ihrem Server. Der
Browser-Web-Client signiert/übermittelt nur; er benötigt den Schlüssel nicht. (Er kann für
vertrauenswürdige Prototypen einen apiKey annehmen, aber liefern Sie niemals einen Produktionsschlüssel an den Browser aus.)
Referenzen
- Client: Der Haupteinstiegspunkt des SDK. Ein einzelner, atomarer Client, der jede Ressource über ihren eigenen Manager bereitstellt (ein atomares Single-Client-Design).