Xuất bản lên directory

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. Trước tiên, kiểm tra tích hợp 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.
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.

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.

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

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

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.

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.

Trình duyệt
API

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.

Agent và các quy trình tự động có thể gửi origin đến API của directory.

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.

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.

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ố

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.

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.

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.

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.

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.

Bắt đầu

Nhận thanh toán

Nhận biết khách hàng

Được tìm thấy

Xuất bản