v1Ressourcen/Clients/getKundenguthaben abrufen
Kundenguthaben abrufen
Liest das unter Kunden angezeigte Guthaben: erhalten, verbraucht, verfügbar, letzte Gutschrift und die letzten 50 Verlaufseinträge. Erfordert einen identifizierten Agenturbenutzer mit Zugriff auf Kunden und den angeforderten Kunden. Der Bereich client-credits:read ist nur über benutzerdefinierte API-Schlüsselberechtigungen verfügbar. Lesezugriffe initialisieren oder setzen das Guthaben nicht zurück. Interne Nutzungsmengen, Anbieterkosten, Zahlungszugangsdaten und Guthabenkonfiguration werden nicht zurückgegeben.
get
client-credits:read/api/v1/clients/{id}/creditsAntwort
dataobjecterforderlich
clientIdstringerforderlich
givenintegererforderlich
usedintegererforderlich
remainingintegererforderlich
lastAddedobjecterforderlich
creditsintegererforderlich
atstringerforderlich
usedSinceintegererforderlich
bystringerforderlich
historyarray of objecterforderlich
creditsintegererforderlich
remainingAfterintegererforderlich
notestringerforderlich
atstringerforderlich
bystringerforderlich
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
503Der Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie eine Gutschrift mit demselben Idempotenzschlüssel.
get/api/v1/clients/{id}/credits
Ihr API-Schlüssel
{}Anleitungen, die diese Ressource verwenden
- Business Listings API: Complete Developer GuideHow a business listings API works and how to create, update, sync and monitor locations across Google, Apple, Bing and directories with the Synup API.
- Create a Location with the Synup APICreate a business location in one POST, with or without a client, get back a locationId, and know which fields matter and which can wait.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.