developer.iai.one

Lớp xây dựng

Developer surface

Lớp xây dựng

developer.iai.one là lớp xây dựng cho API, auth, webhook và thực thi tích hợp.

Bắt đầu từ bằng chứng, không từ giả định.

Required routes

Mỗi developer route có owner và proof boundary.

Các route này là documentation shell cho tới khi live runtime proof cho phép claim mạnh hơn.

Quickstart

Walkthrough build setup theo evidence-first.

Auth

Ranh giới tích hợp identity dùng chung.

API reference

Endpoint shape và runtime ownership.

Webhooks

Event truth, signature và replay expectation.

SDK

Ví dụ và hướng dẫn implementation.

Nodes

Các khối tích hợp có thể thực thi.

Changelog

Contract delta và release note.

Quickstart

Xây từ các route đã xác thực.

Dùng các bước này để nối API, auth, webhooks, SDK, nodes và changelog truth mà không vượt rào evidence.

1. Đọc ranh giới

Xác nhận surface nào sở hữu hành động trước khi viết code.

2. Kiểm contract shape

Dùng đúng request, response và auth contract đã được ghi nhận.

3. Implement tối thiểu

Sửa nhỏ nhất an toàn và giữ proof đi kèm.

4. Ghi evidence

Đính smoke result, route proof và owner note trước release.

Auth

app.iai.one

Route auth xác định tích hợp identity theo shared truth và giữ access đúng surface.

Mở

API

api.iai.one

Route tham chiếu API khóa endpoint shape, auth boundary và runtime ownership.

Mở runtime

Webhook

api.flow.iai.one

Route webhook khóa event truth, signature handling và replay expectation.

Mở runtime

Surface liên kết

Developer xây bên cạnh hệ, không đứng trên hệ.

Dùng các surface liên kết cho product access, runtime, docs và control truth.

Gốc

Root định nghĩa ranh giới hiến pháp và vocabulary.

Trang chủ

Home định tuyến người dùng vào đúng surface.

Tài liệu

Docs giữ kiến trúc, chuẩn và release evidence.

Flow

Flow sở hữu workflow và runtime execution.

Điều hành

Dash sở hữu control và monitoring của operator.

Ứng dụng

App sở hữu hành trình sản phẩm hướng người dùng.

Developer không thay docs làm source of truth.

Developer không thực thi runtime nếu không có ownership từ Flow hoặc API.

Developer không publicize surface chưa release.