Referência API
Pedir aprovação
Regista pedido de revisão de recurso suportado; a política determina o revisor seguinte.
https://api.sparkglim.net/api/white-label/portal/reseller/approval-requestsModelo de acesso
- Modelo de acesso
- Sessão SparkGlim e permissões de membro
- Âmbito necessário
oversight:escalate- Disponibilidade documentada
- Implementado no código
Disponibilidade verificada no código, sem garantia de produção.
Use o fluxo de membros da equipa Criador. A revenda não concede acesso ilimitado à base ou administração.
Cabeçalhos
| Nome | Tipo | Validação |
|---|---|---|
AuthorizationObrigatórioSessão Bearer SparkGlim existente; associação e capacidades atribuídas autorizam cada operação no servidor. | string | Validação: Token Bearer de uma sessão autenticada existente. |
Pedido
| Nome | Tipo | Validação |
|---|---|---|
entityTypeObrigatórioClassificação ou provas guardadas para aprovação e supervisão da conta. | enum | Validação: member | campaign | withdrawal | payout | payment_method | ussd | provider | setting. |
entityIdOpcionalRelação ou revisão existente da conta; propriedade e capacidades são verificadas no servidor. | string|null | Validação: <=160. |
sparkglimReviewRequiredOpcionalClassificação ou provas guardadas para aprovação e supervisão da conta. | boolean | Validação: Valor predefinido: false. |
riskScoreOpcionalClassificação ou provas guardadas para aprovação e supervisão da conta. | integer | Validação: 0–100. |
reasonOpcionalExplicação conservada no registo de aprovação ou revisão. | string|null | Validação: <=2000. |
requestPayloadOpcionalClassificação ou provas guardadas para aprovação e supervisão da conta. | object | Validação: Objeto JSON. |
metadataOpcionalMetadados JSON aceites; nunca substituem autorização, preços ou propriedade. | object | Validação: Objeto JSON. |
Pedido
Os exemplos descrevem o contrato e não são executados. Use registos de teste autorizados; nunca cole segredos reais aqui.
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": {}
}Resposta
{
"success": true,
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"status": "pending"
}
}{
"success": false,
"error": "<ERROR_MESSAGE>"
}Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.
Limites e novas tentativas
Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.
Compatibilidade do código
As operações autorizadas exigem testes específicos da conta.
server/src/api/router.tsserver/src/api/routes/white-label.tsserver/src/white-label/reseller-service.tsserver/src/white-label/schemas.ts