v1Ressources/Clients/getConsulter les crédits du client
Consulter les crédits du client
Lit les crédits affichés dans Clients : reçus, utilisés, disponibles, dernier ajout et les 50 dernières entrées de l’historique. Nécessite un utilisateur identifié de l’agence ayant accès à Clients et au client demandé. L’autorisation client-credits:read est disponible uniquement dans les autorisations personnalisées des clés API. La lecture n’initialise ni ne réinitialise le solde. Aucune quantité d’usage interne, aucun coût fournisseur, identifiant de paiement ou paramètre de crédits n’est renvoyé.
get
client-credits:read/api/v1/clients/{id}/creditsRéponse
dataobjectobligatoire
clientIdstringobligatoire
givenintegerobligatoire
usedintegerobligatoire
remainingintegerobligatoire
lastAddedobjectobligatoire
creditsintegerobligatoire
atstringobligatoire
usedSinceintegerobligatoire
bystringobligatoire
historyarray of objectobligatoire
creditsintegerobligatoire
remainingAfterintegerobligatoire
notestringobligatoire
atstringobligatoire
bystringobligatoire
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
503Le service est temporairement indisponible. Réessayez l’ajout de crédits avec la même clé d’idempotence.
get/api/v1/clients/{id}/credits
Votre clé API
{}Guides qui utilisent cette ressource
- 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.