Référence API
Demander une approbation
Enregistre une demande de révision d’une ressource prise en charge ; la politique détermine le réviseur.
https://api.sparkglim.net/api/white-label/portal/reseller/approval-requestsModèle d’accès
- Modèle d’accès
- Session SparkGlim et permissions de membre
- Portée requise
oversight:escalate- Disponibilité documentée
- Implémenté dans le code
La disponibilité est vérifiée dans le code, pas garantie en production.
Utilisez le parcours de membre d’équipe Créateur. La revente ne donne jamais accès illimité à la base ou à l’administration.
En-têtes
| Nom | Type | Validation |
|---|---|---|
AuthorizationObligatoireSession Bearer SparkGlim existante ; appartenance et capacités attribuées autorisent chaque opération côté serveur. | string | Validation : Jeton Bearer d’une session authentifiée existante. |
Requête
| Nom | Type | Validation |
|---|---|---|
entityTypeObligatoireClassification de ressource ou justificatifs conservés pour approbation et supervision du compte. | enum | Validation : member | campaign | withdrawal | payout | payment_method | ussd | provider | setting. |
entityIdFacultatifRelation ou révision du compte existante ; propriété et capacités sont vérifiées côté serveur. | string|null | Validation : <=160. |
sparkglimReviewRequiredFacultatifClassification de ressource ou justificatifs conservés pour approbation et supervision du compte. | boolean | Validation : Valeur par défaut : false. |
riskScoreFacultatifClassification de ressource ou justificatifs conservés pour approbation et supervision du compte. | integer | Validation : 0–100. |
reasonFacultatifExplication conservée avec le dossier d’approbation ou de révision. | string|null | Validation : <=2000. |
requestPayloadFacultatifClassification de ressource ou justificatifs conservés pour approbation et supervision du compte. | object | Validation : Objet JSON. |
metadataFacultatifMétadonnées JSON supplémentaires acceptées ; elles ne remplacent jamais autorisation, prix ou propriété. | object | Validation : Objet JSON. |
Requête
Les exemples décrivent le contrat et ne sont pas exécutés. Utilisez des données de test autorisées ; ne saisissez jamais de secret réel ici.
POST /api/white-label/portal/reseller/approval-requests HTTP/1.1
Host: api.sparkglim.net
Authorization: Bearer <EXISTING_SESSION_TOKEN>
Content-Type: application/json
{
"entityType": "campaign",
"reason": "Example approval request",
"requestPayload": {}
}Réponse
{
"success": true,
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"status": "pending"
}
}{
"success": false,
"error": "<ERROR_MESSAGE>"
}Validation, permissions, données indisponibles et pannes utilisent le statut HTTP et l’erreur du gestionnaire.
Limites et tentatives
Limite serveur par défaut : 100 requêtes par IP sur 60 secondes. Des contrôles spécifiques s’appliquent.
Compatibilité du code
Les opérations autorisées nécessitent des tests propres au compte.
server/src/api/router.tsserver/src/api/routes/white-label.tsserver/src/white-label/reseller-service.tsserver/src/white-label/schemas.ts