README

JotForm API - PHP 客户端

安装

通过git clone安装

    $ git clone git://github.com/jotform/jotform-api-php.git
    $ cd jotform-api-php

或

通过Composer包管理器安装 (https://getcomposer.org.cn/)

composer.json

    {
        "require": {
            "jotform/jotform-api-php": "dev-master"
        }
    }

    $ php composer.phar install

文档

您可以在https://api.jotform.com/docs/找到此客户端API的文档

身份验证

JotForm API需要API密钥来执行所有与用户相关的调用。您可以在API部分中创建您的API密钥。

示例

打印用户的全部表单

<?php
    
    include "jotform-api-php/JotForm.php";
    
    $jotformAPI = new JotForm("YOUR API KEY");
    $forms = $jotformAPI->getForms();
    
    foreach ($forms as $form) {
        print $form["title"];
    }

?>

获取最新表单的提交

<?php
    
    try {
        include "jotform-api-php/JotForm.php";
        
        $jotformAPI = new JotForm("YOUR API KEY");

        $forms = $jotformAPI->getForms(0, 1, null, null);

        $latestForm = $forms[0];

        $latestFormID = $latestForm["id"];

        $submissions = $jotformAPI->getFormSubmissions($latestFormID);

        var_dump($submissions);

    }
    catch (Exception $e) {
        var_dump($e->getMessage());
    }
    
?>

按创建日期排序获取最新的100条提交

<?php
    
    try {
        include "jotform-api-php/JotForm.php";
        
        $jotformAPI = new JotForm("YOUR API KEY");

        $submissions = $jotformAPI->getSubmissions(0, 100, null, "created_at");

        var_dump($submissions);
    }
    catch (Exception $e) {
        var_dump($e->getMessage());
    }
    
?>

提交和表单过滤示例

<?php

    try {
        include "jotform-api-php/JotForm.php";
        
        $jotformAPI = new JotForm("YOUR API KEY");
        
        $filter = array(
                "id:gt" => "239252191641336722",
                "created_at:gt" => "2013-07-09 07:48:34",
        );
        
        $subs = $jotformAPI->getSubmissions(0, 0, $filter, "");
        var_dump($subs); 
        
        $filter = array(
                "id:gt" => "239176717911737253",
        );
        
        $formSubs = $jotformAPI->getForms(0, 0, 2, $filter);
        var_dump($formSubs);
    } catch (Exception $e) {
            var_dump($e->getMessage());
    }
    
?>

删除最后50条提交

<?php
    
    try {
        include "jotform-api-php/JotForm.php";
        
        $jotformAPI = new JotForm("YOUR API KEY");

        $submissions = $jotformAPI->getSubmissions(0, 50, null, null);

        foreach ($submissions as $submission) {
            $result = $jotformAPI->deleteSubmission($submission["id"]);
            print $result;
        }
    }
    catch (Exception $e) {
        var_dump($e->getMessage());
    }
    
?>

首先，从 jotform-api-php/JotForm.php 文件中包含 JotForm 类。这个类提供了对JotForm API的访问。您需要使用您的API密钥创建一个API客户端实例。在异常（错误的身份验证等）的情况下，您可以捕获它或让它以致命错误失败。