La API de SMM Africa es un punto final único basado en acciones para flujos de trabajo de catálogo, saldo, pedido, estado, recarga y cancelación. Acepta JSON, campos codificados en URL y datos de formularios de varias partes de solo campos, por lo que los paneles de revendedores comunes se pueden integrar sin un adaptador.
La API no elimina la variabilidad del proveedor ni las responsabilidades del revendedor. Una integración sólida mantiene una instantánea del servicio actual, asigna a cada cliente el ID de pedido SMM Africa, conserva el objetivo y la cantidad enviados y presenta el estado y la elegibilidad para reembolso o recarga con precisión.
Punto final y autenticación
Enviar una solicitud HTTPS POST a https://smm.africa/api/v3 con JSON, Aplicación application/x-www-form-urlencodedo solo de campo multipart/form-data. Autenticar con Authorization: Bearer YOUR_API_KEY o el estándar Tecla key . Se recomiendan campos codificados en URL para paneles de revendedores comunes.
curl -X POST https://smm.africa/api/v3 -H "Content-Type: application/x-www-form-urlencoded" --data-urlencode "key=YOUR_API_KEY" --data-urlencode "action=balance"Mantenga la clave en el servidor. No lo envíe en JavaScript del navegador, un paquete móvil, un repositorio público, registros visibles para el cliente, eventos de análisis o capturas de pantalla. Gírelo de los controles de seguridad de la cuenta si pudo haber estado expuesto.
Las seis acciones documentadas Servicios
- : devuelve el catálogo de servicios actual. Saldo
- : devuelve el saldo y la moneda de la billetera compartida.
- agregar: envía un pedido para un ID de servicio, objetivo y cantidad actuales. Estado
- : devuelve campos operativos para un ID de pedido SMM Africa.
- : solicita una revisión de recarga para un pedido elegible.
- cancelar: solicita la cancelación de un pedido elegible.
Las seis acciones utilizan el mismo punto final. el Acción action decide la forma de la solicitud y la respuesta.
Obtener servicios antes de exponer un catálogo
El servicios services documenta un ID de servicio, nombre, tipo, categoría, tarifa, mínimo, máximo, indicador de recarga y indicador de cancelación. La tasa se expresa por 1000 en la moneda de la billetera. Los ID de servicio, precios, límites, nombres e indicadores pueden cambiar, así que no los codifique como datos permanentes del producto.
Un revendedor puede almacenar en caché la respuesta para facilitar su uso, pero debe registrar cuándo se obtuvo y actualizarla antes de aceptar un pedido. Si el catálogo de cara al cliente cambia un nombre o precio, conserve el ID de servicio SMM Africa original y los detalles que se muestran cuando se realizó el pedido.
Realizar un pedido con la acción de agregar
El servicios add requiere Servicio service, Enlace link, y quantity. Opcional runs y interval se aplican solo a servicios de alimentación por goteo compatibles. Valide el objetivo con la nota de servicio en vivo y mantenga la cantidad entre el mínimo y el máximo actuales.
{ "action": "add", "service": 1234, "link": "https://instagram.com/your-profile", "quantity": 500
}Una respuesta exitosa devuelve un orden order . Almacene esa identificación inmediatamente con la referencia del cliente, la instantánea del servicio, el objetivo, la cantidad enviada, el cargo esperado y la marca de tiempo. El revendedor es propietario de este mapeo; la API no puede inferir qué cliente final o factura pertenece al pedido.
Representa el estado con precisión Estado
El servicios status acepta el ID de pedido SMM Africa. La respuesta documentada puede incluir cargo, recuento inicial, estado del pedido, restos y moneda. Las posibles etiquetas de estado incluyen Pendiente, En curso, Procesando, Parcial, Completado y Cancelado.
Utilice estos campos para mostrar el progreso del pedido en un portal de cliente. Mantenga los informes de campaña separados y utilice los análisis de la plataforma social para determinar el alcance, la participación y la respuesta de la audiencia.
La recarga y cancelación son solicitudes, no promesas
El servicios refill y cancel utilizan un ID de pedido. Un indicador de servicio actual puede indicar si una acción está expuesta, pero la elegibilidad final aún depende del servicio, el estado del pedido, el momento, la respuesta del proveedor y la política publicada.
No prometa a un cliente que cada gota será recargada o que cada pedido enviado podrá cancelarse. Conserve la lista original, las marcas de tiempo del pedido y la respuesta para que el soporte tenga la evidencia necesaria para la revisión.
Manejo de errores y sondeo
- 400: inspecciona la solicitud y los campos obligatorios.
- 401: deténgase y revise la clave; no vuelva a intentar credenciales inválidas continuamente.
- 429: respeta el
Retry-Afterencabezado y retroceso. - 500: registra un registro de correlación redactado y vuelve a intentarlo de forma conservadora en lugar de crear pedidos duplicados.
Nunca registre el token de portador completo. Si se produce un error de red después de enviar add, verifique si el pedido se creó antes de volver a enviar la misma solicitud del cliente.
Una secuencia de integración más segura
- Lea el Referencia de API humana referencia de API para personas y Documento OpenAPI.
- Pruebe la autenticación con equilibrio
balancee inspeccionar la corriente Respuestaservices. - Realice un pequeño pedido manual para el ID de servicio exacto y el tipo de objetivo que planea exponer.
- Observe el estado del pedido, la variabilidad del tiempo y cualquier comportamiento de recarga o cancelación.
- Cree el cliente del lado del servidor, la instantánea del servicio, la asignación de pedidos, los registros redactados y el manejo del límite de velocidad.
- Explique la entrega, la plataforma, la retención, la opción de soporte y los límites de los resultados en sus propios términos de cliente.
Conclusión
Una API de panel SMM puede hacer que un flujo de trabajo probado sea más fácil de operar. Utilice la documentación actual, conserve el ID del servicio y el ID del pedido, asegure la clave y presente el estado del pedido con precisión a los clientes.