API文档

customersms.pro 短信API集成指南

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!"
  }'

身份验证

所有API请求都需要使用API密钥进行身份验证。请在请求正文中包含您的API密钥。

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"
}

端点

端点

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

方法

POST

内容类型

application/json

参数

Parameter Type Required Description
api_key string Required 您的API密钥
phone string/array Required 电话号码 - 字符串或数组
message string Required 短信内容

响应

成功响应

{
  "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"
    }
  ]
}

错误响应

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

代码示例

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'];
}
?>

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();

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)

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!"
  }'

速率限制

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

API请求限制为每个API密钥每分钟100个请求。

支持

Email Support

info@customersms.pro

Response Time

Within 4 hours

Availability

24/7 Support

如需技术支持和API相关问题,请联系我们