Docs API 文档

Appearance

合同列表 ​

请求信息 ​

  • 接口: /agent-api/user/{user_id}/contract/{type}
  • 请求方式: GET

路由参数 ​

参数类型示例解释必填
user_idstring5832d184-dd53-42a0-8ace-0bf8d660f4cc用户id是
typestringuncompleted(签约回款中)/completed(回款完成)/remind(续约提醒)合同的类型是

请求参数 ​

参数类型示例解释必填
pageint1页码是
ended_atarray["2021-12-14", "2021-12-17"]合同到期时间否
sign_atarray["2021-12-14", "2021-12-17"]合同签约时间否
feearray[10000,20000]合同签约金额否
customer_namestring客户客户名称否
product_namestring产品产品名称否
customer_idstring9992f0da-25e0-48eb-acab-7950959a7b71客户ID否
name_phonestring合同合同名称/客户名称/号码(组合查询)否

请求示例 ​

cURL
curl -X GET "https://ai.api.longlonglong.cn/agent-api/user/5832d184-dd53-42a0-8ace-0bf8d660f4cc/contract/uncompleted?page=1" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
Go
package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://ai.api.longlonglong.cn/agent-api/user/5832d184-dd53-42a0-8ace-0bf8d660f4cc/contract/uncompleted?page=1"

    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
JavaScript
const axios = require('axios');

axios.get('https://ai.api.longlonglong.cn/agent-api/user/5832d184-dd53-42a0-8ace-0bf8d660f4cc/contract/uncompleted?page=1', {
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
    }
})
.then(response => {
    console.log(response.data);
})
.catch(error => {
    console.error('Error:', error);
});
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://ai.api.longlonglong.cn/agent-api/user/5832d184-dd53-42a0-8ace-0bf8d660f4cc/contract/uncompleted?page=1";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Content-Type", "application/json")
                .header("Authorization", "Bearer YOUR_TOKEN")
                .GET()
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}
PHP
<?php

$url = 'https://ai.api.longlonglong.cn/agent-api/user/5832d184-dd53-42a0-8ace-0bf8d660f4cc/contract/uncompleted?page=1';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_TOKEN'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
Python
import requests

url = 'https://ai.api.longlonglong.cn/agent-api/user/5832d184-dd53-42a0-8ace-0bf8d660f4cc/contract/uncompleted?page=1'

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.get(url, headers=headers)
print(response.json())
C++
#include <iostream>
#include <string>
#include <curl/curl.h>

size_t WriteCallback(void* contents, size_t size, size_t nmemb, void* userp) {
    ((std::string*)userp)->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl;
    CURLcode res;
    std::string readBuffer;

    curl = curl_easy_init();
    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://ai.api.longlonglong.cn/agent-api/user/5832d184-dd53-42a0-8ace-0bf8d660f4cc/contract/uncompleted?page=1");

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Content-Type: application/json");
        headers = curl_slist_append(headers, "Authorization: Bearer YOUR_TOKEN");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);

        res = curl_easy_perform(curl);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);

        std::cout << readBuffer << std::endl;
    }
    return 0;
}

响应示例 ​

状态码：200 OK

json
{
    "code": 200,
    "status": "success",
    "message": "查看签约回款中成功",
    "meta": {
        "has_pages": false,
        "total": 1,
        "last_page": 1,
        "current_page": 1,
        "per_page": 15
    },
    "data": [{
        "id": 1,//合同ID
        "name": "合同1号",//合同名称
        "fee": 60000,//签约金额
        "signatory": "签约方1号",//签约方名称
        "signed_at": "2021-12-16 00:00:00",//签约时间
        "ended_at": "2021-12-17 00:00:00",//到期时间
        "customer_id": "01ff0167-5cae-4c93-9678-3bdef3ae1b6c",//客户ID
        "created_user_id": "f00c8abc-433f-4666-a9d6-70479605ced1",//创建者ID
        "sale_user_id": "efd49f55-8793-4393-ab77-465f99f3a292",//销售人员ID
        "contract_attachments": [
            "contract-attachment/mxvFJHNU51u6SSv8kH7KLnw7LvE9o0TYZ84iUQZz.jpg"
        ],
        "invoice_attachments": [
            "invoice-attachment/yHVd4G4XKAOXkBNbDT2P84TErnUROpzfTGfvD9XR.jpg"
        ],
        "party_a": "甲方负责人1号",//甲方负责人名称
        "party_b": "乙方负责人1号",//乙方负责人名称
        "status": 0,//合同状态(见下方解释)
        "renewal_status": 0,
        "remarks": "我是备注",//备注
        "created_at": "2021-12-16 10:55:34",//合同创建时间
        "updated_at": "2021-12-16 10:55:34",
        "is_overdue": true,//是否逾期（true代表逾期，fasle代表还未逾期）
        "status_str": "未回款",//合同状态具体含义
        "schedules": [{//计划回款
            "id": "bde976a0-9afd-4ad2-ad9a-dd7e1704d503",
            "contract_id": 1,//合同ID
            "plan_payment_time": "2021-12-16 00:00:00",//计划回款时间
            "plan_payment_fee": 10000,//计划回款金额
            "actual_payment_time": null,//实际回款时间
            "actual_payment_fee": 0,//实际回款金额
            "status": false,//是否回款
            "remark": null,
            "created_at": "2021-12-16 10:55:35",
            "updated_at": "2021-12-16 10:55:35"
        }],
        "creator": {//合同创建人具体信息
            "id": "f00c8abc-433f-4666-a9d6-70479605ced1",
            "name": "1121",
            "type": 4,
            "type_note": "会员"
        },
        "sale_user": {//销售人员具体信息
            "id": "efd49f55-8793-4393-ab77-465f99f3a292",
            "name": "测试陈帮骐",
            "type": 8,
            "type_note": "子账户"
        },
        "customer": {//具体的客户信息
            "id": "01ff0167-5cae-4c93-9678-3bdef3ae1b6c",
            "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1",
            "created_user_id": "f00c8abc-433f-4666-a9d6-70479605ced1",
            "phone": "18361206587",//客户号码
            "is_back": 0,
            "source_id": 14,
            "industry_id": 23,
            "grade_id": 18,
            "name": "我是签约客户1号",//客户名称
            "sex": 1,
            "sort": 0,
            "created_at": "2021-12-16 10:50:24",
            "updated_at": "2021-12-16 10:59:58",
            "inputted_at": "2021-12-16 10:49:35",
            "province_id": 432,
            "city_id": 526,
            "operator": 3,
            "flow": 2,
            "extra": null,
            "expect_transaction_at": null,
            "expect_transaction_fee": "0.00",
            "unfollow_back_at": null,
            "unsettled_back_at": null,
            "followed_at": null,
            "crm_sign": {//具体的签约信息
                "id": "e4e3513d-790c-49c3-ae18-b0c6ea62fd17",
                "customer_id": "01ff0167-5cae-4c93-9678-3bdef3ae1b6c",
                "fee": "50000.00",
                "signed_at": "2021-12-16 00:00:00",
                "created_at": "2021-12-16 10:50:25",
                "updated_at": "2021-12-16 10:50:25",
                "products": [{//签约的产品(可签约多个)
                    "sign_id": "e4e3513d-790c-49c3-ae18-b0c6ea62fd17",
                    "product_id": 1,
                    "product_name": "AI呼出机器人",//产品名称
                    "product": {
                        "id": 1,
                        "user_id": "f00c8abc-433f-4666-a9d6-70479605ced1",
                        "name": "AI呼出机器人",
                        "price": "1500.00",
                        "image": "crm-product/v1h7P9TYFLedYPgotz0zqo5sP051fgmWwLZpSgrd.jpg",
                        "created_at": "2021-11-09 11:32:56",
                        "updated_at": "2021-11-09 11:32:56",
                        "image_url": "http://www.xxx.com/api/public-resource/crm-product/v1h7P9TYFLedYPgotz0zqo5sP051fgmWwLZpSgrd.jpg"//产品地址
                    }
                }]
            },
            "province": {
                "id": 432,
                "pid": null,
                "city": "江苏",
                "area_code": "0519",
                "post_code": "213000",
                "created_at": "2019-05-11 02:26:27",
                "updated_at": "2019-05-11 02:26:27"
            },
            "city": {
                "id": 526,
                "pid": 432,
                "city": "徐州",
                "area_code": "0516",
                "post_code": "221000",
                "created_at": "2019-05-11 02:26:28",
                "updated_at": "2019-05-11 02:26:28"
            }
        },
        "invoiceAttachmentUrl": [//发票地址
            "http://www.xxx.com/api/public-resource/invoice-attachment/yHVd4G4XKAOXkBNbDT2P84TErnUROpzfTGfvD9XR.jpg"
        ],
        "contractAttachmentUrl": [//合同地址
            "http://www.xxx.com/api/public-resource/contract-attachment/mxvFJHNU51u6SSv8kH7KLnw7LvE9o0TYZ84iUQZz.jpg"
        ]
    }]
}

注意事项 ​

  • 签约回款中、回款完成、续约提醒的列表均通过此接口进行查询，通过在路由中传相应的参数进行请求：uncompleted(签约回款中)、completed(回款完成)、remind(续约提醒)
  • 合同中的 status 含义：0:未还款，1:部分还款，2:已结清

基于 MIT 许可发布

Copyright © 2015-present AICC Team