Habilitando o uso da API

Para utilizar a API, primeiramente habilite sua utilização marcando a caixa de ativação:

Chave da API e URL do PostBack

Ao habilitar o uso da API, você terá acesso à chave de utilização da API. Também poderá cadastrar a url para recebimento das respostas devolvidas pela API (PostBack).

Exemplo de implementação do PostBack:

API Versão 1.1

<?php
  // URL deste arquivo -> http://meu-sistema.com/Api

  // recebe os dados da API
  $dados = file_get_contents("php://input");

  // verifica se os dados recebidos são 'BULK' (comprimidos)
  // a opção de 'BULK' é configurada diretamente na instância
  $BULK_identifier = "BULKGZ,";
  if(substr($input, 0, strlen($BULK_identifier)) === $BULK_identifier)
  {
      // remove BULKGZ, do inicio da string
      $bulk_messages = substr($input, strlen($BULK_identifier), strlen($input));
      $zlib = base64_decode($bulk_messages);

      // descomprime utilizando zlib
      $messages = zlib_decode($zlib);

      // remove UT8-BOM (necessário em alguns casos)
      $messages = trim($messages, "\xEF\xBB\xBF"); 
      
      $messages = json_decode($messages);
      foreach($messages as $message)
      {
          $final_message = base64_decode($message);
          ...
      }
  }
  else // dados recebidos no formato JSON (não é 'BULK')
  {
    $dados = json_decode($dados);
    //...
  }
  //...
?>

API v1.0

<?php
  // URL deste arquivo -> http://meu-sistema.com/Api

  // recebe os dados da API
  $dados = file_get_contents("php://input");

  // transforma JSON em uma variável
  $mensagens = json_decode($dados);

  // verifica se os dados recebidos são 'BULK'
  // a opção de 'BULK' é configurada diretamente na instância
  // se o 'BULK' estiver DESABILITADO, não é necessário o trecho de código a seguir
  $BULK_identifier = "BULK,";
  if(substr($dados, 0, strlen($BULK_identifier)) === $BULK_identifier)
  {
    // remove 'BULK', do inicio da mensagem
    $bulk_messages = json_decode(substr($dados, strlen($BULK_identifier), strlen($dados)));
    foreach($bulk_messages as $mensagem)
    {
      // decodifica de base64
      $mensagem_decodificada = base64_decode($mensagem);
      //...
    }
  }
  //...
?>

EndPoint

Utilize a seguinte URL de EndPoint para realização das requisições:

https://api.witi.me/$comando$?wid=$chave_api$

$comando$ - Substitua pelo comando desejado
$chave_api- Substitua pela sua chave de API disponibilizado nas configurações da instância

Nota

Os resultados retornados pela API estão no formato json