---
title: "获取自定义协议服务器信息列表"
method: POST
path: "/api/v1/things/protocol/service/index"
tags: ["things/protocol/service", "thingsProtocolService"]
---

# 获取自定义协议服务器信息列表

`POST /api/v1/things/protocol/service/index`

## Request body

- ProtocolServiceIndexReq
  - `code` string, required
  - `page` PageInfo
    - `orders` OrderBy[] — 排序
      - `field` string — 排序的字段名
      - `sort` integer — 排序方式：1 从小到大, 2 从大到小
    - `page` integer — 页码
    - `size` integer — 每页大小

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` ProtocolServiceIndexResp
    - `list` ProtocolService[], required — 自定义协议信息
      - `code` string, required — 协议code
      - `createdTime` integer, required — 首次加入时间
      - `id` integer, required
      - `ip` string, required — 协议服务的ip地址
      - `port` integer, required — 监听的端口,如果没有填0即可
      - `status` integer, required — 服务状态
      - `updatedTime` integer, required — 更新时间
    - `total` integer — 拥有的总数
  - `msg` string

## Changes

- **2026-03-27** `b9582d0ab6af` — 1 breaking, 1 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
- **2025-03-14** `e87dbcac5d9e` — 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/unitedrhino/apis/things-api/changes/api/v1/things/protocol/service/index/post.md)

---

[API](https://skmtc.dev/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.dev/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitedrhino/things-api/revisions/f3bdeb916389/schema)