> ## Documentation Index
> Fetch the complete documentation index at: https://ifdocdemo.lumivescence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Xuất bản lên directory

> Kiểm tra tính hợp lệ của các tài liệu dịch vụ và gửi origin của bạn lên directory của InFlow, để agent có thể tìm thấy dịch vụ của bạn.

Niêm yết dịch vụ của bạn trong directory của InFlow, để agent có thể tìm thấy dịch vụ bằng InFlow CLI. Xem [Directory của InFlow](https://ifdocdemo.lumivescence.com/vi/concepts/directory.md).

Trước tiên, [kiểm tra tích hợp](https://ifdocdemo.lumivescence.com/vi/sellers/verify-your-integration.md) của bạn trên dịch vụ đang chạy.

## Những gì directory chấp nhận

Directory chấp nhận một trong hai loại tài liệu công khai.

| Tài liệu | Chi tiết |
| - | - |
| Tài liệu khám phá | Định dạng gốc. Phục vụ tài liệu này tại `/.well-known/odp` trên origin của bạn. Xem [Niêm yết sản phẩm](https://ifdocdemo.lumivescence.com/vi/sellers/make-products-discoverable.md). |
| Tài liệu OpenAPI 3.x | Một tài liệu JSON. Gửi URL chính xác của tài liệu, hoặc một origin mà tại đó directory có thể khám phá tài liệu. |

Directory chỉ đọc tài liệu. Directory không gọi endpoint của bạn và không thanh toán. Các tài liệu và các endpoint đã khai báo phải truy cập công khai được. Directory không thể đọc một server `localhost`, nên xuất bản sau khi bạn [chuyển sang production](https://ifdocdemo.lumivescence.com/vi/sellers/go-live.md).

## Bước 1: Kiểm tra tính hợp lệ của dịch vụ

Trình kiểm tra hợp lệ chạy cùng các bước kiểm tra chặn như directory: metadata của listing, tài nguyên thương hiệu, khả năng ghi danh đã công bố và các khai báo thanh toán. Trình này không xuất bản dịch vụ của bạn và không gọi endpoint của bạn.

**1. Mở trình kiểm tra hợp lệ**

Mở `directory.inflowpay.ai/validate` trong trình duyệt.

**2. Nhập nguồn**

Nhập một origin HTTPS, hoặc URL chính xác của một tài liệu OpenAPI dạng JSON. Để kiểm tra tính hợp lệ của một collection trong tài liệu khám phá, thêm `#collection=your-collection-id` vào origin.

**3. Chạy các bước kiểm tra**

Hoàn tất captcha. Sau đó chọn **Validate Service**. Sửa từng vấn đề trong báo cáo. Sau đó chạy lại các bước kiểm tra.

## Bước 2: Gửi dịch vụ

Với một dịch vụ có tài liệu khám phá, gửi origin HTTPS trần và chính tắc phục vụ tài liệu đó.

| Đúng | Không đúng |
| - | - |
| `https://api.example.com` | `https://api.example.com/.well-known/odp` |
| | `https://api.example.com/products/42` |
| | `http://api.example.com` |
| | `https://api.example.com/?v=2` |

Để gửi một collection của tài liệu khám phá, thêm `#collection=<id>` vào origin. Với một dịch vụ OpenAPI, gửi URL chính xác của tài liệu. Quản trị viên directory cấu hình các collection OpenAPI.

> [tab] Trình duyệt
>
> Mở `directory.inflowpay.ai/publish` trong trình duyệt. Nhập origin hoặc URL tài liệu OpenAPI của bạn. Hoàn tất captcha. Sau đó chọn **Submit Service**.

> [tab] API
>
> Agent và các quy trình tự động có thể gửi origin đến API của directory.
>
> ```bash theme={null}
> curl --request POST https://directory.inflowpay.ai/v1/services \
>   --header 'Content-Type: application/json' \
>   --data '{"origin":"https://api.example.com"}'
> ```

Directory kiểm tra tính hợp lệ của tài liệu công khai trước khi chấp nhận dịch vụ để lập chỉ mục.

## Bước 3: Xác nhận listing

Một lần gửi thành công không chứng minh rằng directory đã lập chỉ mục dịch vụ của bạn. Tìm dịch vụ của bạn trong directory.

```bash theme={null}
inflow directory search "your service name" --environment production
```

Dịch vụ của bạn nằm trong directory production. Một CLI dùng sandbox không tìm thấy dịch vụ này.

Sau đó đọc dịch vụ của bạn như một agent.

```bash theme={null}
inflow inspect https://api.example.com
inflow odp inspect https://api.example.com
```

Xác nhận rằng kết quả cho thấy listing, ghi danh và cả hai giao thức thanh toán của bạn.

## Khắc phục sự cố

> [accordion] Trình kiểm tra hợp lệ từ chối origin
>
> Xóa đường dẫn và chuỗi truy vấn. Fragment duy nhất mà directory chấp nhận là `#collection=<id>`. Dùng HTTPS.

> [accordion] Trình kiểm tra hợp lệ không đọc được tài liệu
>
> Tài liệu phải công khai. Mở `https://your-origin/.well-known/odp` trong trình duyệt từ bên ngoài mạng của bạn.

> [accordion] Listing không hiển thị các thay đổi của bạn
>
> Directory đọc lại từng tài liệu khám phá sau mỗi 24 giờ. Để cập nhật listing sớm hơn, gửi lại origin tại `directory.inflowpay.ai/publish`.

> [accordion] Dịch vụ không xuất hiện trong một bộ lọc thanh toán
>
> Một listing OpenAPI không có thông tin thanh toán. Phục vụ một tài liệu khám phá tại origin đã niêm yết.

> [accordion] Directory niêm yết dịch vụ, nhưng agent không thể thanh toán
>
> Directory không kiểm thử thanh toán. Chạy `inflow mpp inspect` hoặc `inflow x402 inspect` trên một endpoint có thu phí. Sau đó làm theo [Kiểm tra tích hợp](https://ifdocdemo.lumivescence.com/vi/sellers/verify-your-integration.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.