访客预约

开发中

POST

http://prod-cn.your-api-server.com/api/open/client/ipp/personpass/v1/visitorappointment/submit

最后修改时间：2025-06-27 02:37:19

责任人：未设置

请求参数

Query 参数

project

string

可选

项目id或者项目编码。可由实施提供或者通过项目列表接口获取(http://aiot.docs.chn-das.com/api-139664251)

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Authorization

string

可选

默认值:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU

Body 参数application/json

访客预约

enterpriseId

string

拜访企业Id

必需

customerUserId

string

拜访客户的用户Id

必需

>= 0 字符<= 36 字符

visitReason

enum<integer> <int32>

可选

枚举值:

51020253035

validStartTime

integer <int64>

来访开始时间

必需

validEndTime

integer <int64>

来访结束时间

必需

visitors

array [object {8}]

访客信息

必需

name

string

访客姓名

必需

>= 0 字符<= 20 字符

mobile

string

访客电话

必需

>= 0 字符<= 15 字符

idType

enum<integer> <int32>

可选

枚举值:

5101520

idNumber

string | null

证件号

可选

>= 0 字符<= 50 字符

photo

string | null

照片地址

可选

>= 0 字符<= 200 字符

photoExt

object

访客照片扩展信息

可选

plateNumber

string | null

车牌号

可选

>= 0 字符<= 15 字符

carType

enum<integer> <int32>

可选

枚举值:

5101520

示例

{
  "enterpriseId": "string",
  "customerUserId": "string",
  "visitReason": 5,
  "validStartTime": 0,
  "validEndTime": 0,
  "visitors": [
    {
      "name": "string",
      "mobile": "string",
      "idType": 5,
      "idNumber": "string",
      "photo": "string",
      "photoExt": {
        "isUploadToExt": true,
        "extPhotoUrl": "string"
      },
      "plateNumber": "string",
      "carType": 5
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/api/open/client/ipp/personpass/v1/visitorappointment/submit?project=1192410229407772672&instance=' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2ZXIiOmZhbHNlLCJzdWIiOiIxNzQzMDg0NTg3MjY0ODE5MjAxIiwiZmxhZyI6NiwiY2xpZW50VHlwZSI6bnVsbCwidXNlcl9uYW1lIjoiMTM3NjIyMzIwMDciLCJzY29wZSI6WyJzZXZlciJdLCJuYW1lIjoiMTM3NjIyMzIwMDciLCJleHAiOjE3MjA1OTcyMzAsImp0aSI6ImE5NjIxN2NiLTBiZDUtNGE1YS1iNmMzLWY1YTVlMjY3ZDIyMSIsInRlbmFudCI6InQxNzQzMDg0NTg3Mjc3NDAyMTEzIiwiY2xpZW50X2lkIjoic3lzIn0.5UPL14t8CI7oySNuurTwkWaob9HstDEILr6bpWb16QU' \
--header 'Content-Type: application/json' \
--data-raw '{
  "enterpriseId": "string",
  "customerUserId": "string",
  "visitReason": 5,
  "validStartTime": 0,
  "validEndTime": 0,
  "visitors": [
    {
      "name": "string",
      "mobile": "string",
      "idType": 5,
      "idNumber": "string",
      "photo": "string",
      "photoExt": {
        "isUploadToExt": true,
        "extPhotoUrl": "string"
      },
      "plateNumber": "string",
      "carType": 5
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

string | null

访客记录Id

可选

示例

{
    "id": "string"
}

🟠400400响应结构

修改于 2025-06-27 02:37:19

获取工位关联信息