Documentación API

Guía de Integración SMS API de customersms.pro

RESTful API
JSON Responses
Secure Authentication

Quick Start

1

Get API Key

Contact our support team to receive your unique API key

2

Make Request

Send POST request with your API key and message data

3

Receive Response

Get detailed JSON response with delivery status

Example Request

curl -X POST https://customersms.pro/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key_here",
    "phone": "+12125551234",
    "message": "Hello World!"
  }'

Autenticación

Todas las solicitudes de API requieren autenticación usando una clave API. Incluya su clave API en el cuerpo de la solicitud.

Important Note

API keys are sensitive information. Store them securely and never expose them in client-side code. Contact info@customersms.pro to get your API key.

Authentication Example

{
  "api_key": "cspro_your_secret_key_here",
  "phone": "+12125551234",
  "message": "Your message content"
}

Endpoint

Endpoint

https://customersms.pro/sms_system/api.php

Método

POST

Tipo de Contenido

application/json

Parámetros

Parameter Type Required Description
api_key string Required Su clave API
phone string/array Required Número(s) de teléfono - string o array
message string Required Contenido del mensaje SMS

Respuesta

Respuesta Exitosa

{
  "success": true,
  "message": "SMS sending completed",
  "total_numbers": 2,
  "successful_sends": 2,
  "failed_sends": 0,
  "remaining_credits": 98,
  "results": [
    {
      "phone": "+12125551234",
      "success": true,
      "message_id": "msg_123456"
    },
    {
      "phone": "+13235554567",
      "success": true,
      "message_id": "msg_123457"
    }
  ]
}

Respuesta de Error

{
  "success": false,
  "error": "Invalid or inactive API key",
  "code": "INVALID_API_KEY"
}

Ejemplos de Código

Ejemplo PHP

<?php
$api_url = 'https://customersms.pro/sms_system/api.php';
$api_key = 'your_api_key_here';

$data = [
    'api_key' => $api_key,
    'phone' => '+12125551234,+13235554567',
    'message' => 'Hello from customersms.pro!'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response, true);
curl_close($ch);

if ($result['success']) {
    echo "SMS sent successfully!";
} else {
    echo "Error: " . $result['error'];
}
?>

Ejemplo JavaScript

const sendSMS = async () => {
  const apiUrl = 'https://customersms.pro/sms_system/api.php';
  const apiKey = 'your_api_key_here';
  
  const data = {
    api_key: apiKey,
    phone: ['+12125551234', '+13235554567'],
    message: 'Hello from customersms.pro!'
  };
  
  try {
    const response = await fetch(apiUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(data)
    });
    
    const result = await response.json();
    
    if (result.success) {
      console.log('SMS sent successfully!', result);
    } else {
      console.error('Error:', result.error);
    }
  } catch (error) {
    console.error('Network error:', error);
  }
};

sendSMS();

Ejemplo Python

import requests
import json

api_url = 'https://customersms.pro/sms_system/api.php'
api_key = 'your_api_key_here'

data = {
    'api_key': api_key,
    'phone': ['+12125551234', '+13235554567'],
    'message': 'Hello from customersms.pro!'
}

headers = {
    'Content-Type': 'application/json'
}

try:
    response = requests.post(
        api_url, 
        headers=headers, 
        data=json.dumps(data)
    )
    result = response.json()
    
    if result['success']:
        print('SMS sent successfully!', result)
    else:
        print('Error:', result['error'])
        
except requests.exceptions.RequestException as e:
    print('Network error:', e)

Ejemplo cURL

curl -X POST https://customersms.pro/sms_system/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key_here",
    "phone": "+12125551234,+13235554567",
    "message": "Hello from customersms.pro!"
  }'

Límites de Velocidad

Requests per minute 100
Requests per hour 5,000
Requests per day 50,000

Las solicitudes de API están limitadas a 100 solicitudes por minuto por clave API.

Soporte

Email Support

info@customersms.pro

Response Time

Within 4 hours

Availability

24/7 Support

Para soporte técnico y preguntas sobre la API, contáctenos en