启用 API 使用

要使用 API，首先需要通过勾选激活框来启用其使用：

API 密钥和 PostBack URL

当您启用 API 使用时，您将能够访问 API 密钥。您还可以注册 URL 来接收 API 返回的响应（PostBack）。

PostBack 实现示例：

API 版本 1.1

<?php
  // URL of this file -> http://my-system.com/Api

  // 从 API 接收数据
  $input = file_get_contents("php://input");

  // 检查接收到的数据是否为 'BULK'（压缩格式）
  // 'BULK' 选项直接在实例中配置
  $BULK_identifier = "BULKGZ,";
  if(substr($input, 0, strlen($BULK_identifier)) === $BULK_identifier)
  {
      // 从字符串开头移除 BULKGZ,
      $bulk_messages = substr($input, strlen($BULK_identifier), strlen($input));
      $zlib = base64_decode($bulk_messages);

      // 使用 zlib 解压缩
      $messages = zlib_decode($zlib);

      // 移除 UTF8-BOM（在某些情况下是必要的）
      $messages = trim($messages, "\xEF\xBB\xBF"); 
      
      $messages = json_decode($messages);
      foreach($messages as $message)
      {
          $final_message = base64_decode($message);
          ...
      }
  }
  else // 以 JSON 格式接收的数据（非 'BULK'）
  {
    $data = json_decode($input);
    //...
  }
  //...
?>

API v1.0

<?php
  // URL of this file -> http://my-system.com/Api

  // 从 API 接收数据
  $data = file_get_contents("php://input");

  // 将 JSON 转换为变量
  $messages = json_decode($data);

  // 检查接收到的数据是否为 'BULK'
  // 'BULK' 选项直接在实例中配置
  // 如果 'BULK' 被禁用，则不需要以下代码片段
  $BULK_identifier = "BULK,";
  if(substr($data, 0, strlen($BULK_identifier)) === $BULK_identifier)
  {
    // 从消息开头移除 'BULK,'
    $bulk_messages = json_decode(substr($data, strlen($BULK_identifier), strlen($data)));
    foreach($bulk_messages as $message)
    {
      // 从 base64 解码
      $decoded_message = base64_decode($message);
      //...
    }
  }
  //...
?>

端点

使用以下端点 URL 进行请求：

https://api.witi.me/$command$?wid=$api_key$

$command$ - 替换为所需的命令
$api_key$ - 替换为在实例设置中提供的您的 API 密钥

注意

API 返回的结果为 json 格式。