chore: sql review api

Author: tianzhou

content/docs/api/sql-review.md

@@ -5,12 +5,6 @@ title: SQL Review API
 <TutorialBlock url="/docs/tutorials/sql-review" title="Master SQL Review with GUI, GitOps and API" />
 <TutorialBlock url="/docs/tutorials/api-sql-review/" title="Codify SQL Review Policies with Bytebase API" />
 
-|          |                                                                                  |
-| -------- | -------------------------------------------------------------------------------- |
-| Endpoint | [POST /v1/sql/check](https://api.bytebase.com/#tag/sqlservice/POST/v1/sql/check) |
-| Request  | https://api.bytebase.com/#model/checkrequest                                     |
-| Response | https://api.bytebase.com/#model/checkresponse                                    |
-
 The SQL Review API provides SQL checks based on your schema review policy.
 
 <HintBlock type="info">
@@ -19,36 +13,28 @@ Before you start, you should configure the [SQL Review Policy](/docs/sql-review/
 
 </HintBlock>
 
-```text
-curl -X POST %%bb_api_endpoint%%/v1/sql/check \
-     -H 'Authorization: Bearer '${bytebase_token} \
-     -d '{
-           "statement": "ALTER TABLE \"user\" ADD \"address\" integer; ALTER TABLE \"user\" DROP COLUMN \"age\";",
-           "name": "instances/prod-instance/databases/example"
-         }'
-```
-
-```json
-{
-  "advices": [
-    {
-      "status": "ERROR",
-      "code": 105,
-      "title": "schema.backward-compatibility",
-      "content": "\"ALTER TABLE \"user\" DROP COLUMN \"age\";\" may cause incompatibility with the existing data and code",
-      "line": 1,
-      "column": 0,
-      "detail": ""
-    },
-    {
-      "status": "WARNING",
-      "code": 402,
-      "title": "column.no-null",
-      "content": "Column \"address\" in \"public\".\"user\" cannot have NULL value",
-      "line": 1,
-      "column": 0,
-      "detail": ""
-    }
-  ]
-}
-```
+## Batch API (recommended)
+
+|          |                                                                                                                              |
+| -------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| Endpoint | [POST /v1/projects/-/releases:check](https://api.bytebase.com/#tag/releaseservice/POST/v1/projects/{project}/releases:check) |
+| Request  | https://api.bytebase.com/#model/checkreleaserequest                                                                          |
+| Response | https://api.bytebase.com/#model/checkreleaseresponse                                                                         |
+| Example  | https://github.com/bytebase/api-example/tree/main/sql-review#batch-api-recommended                                           |
+
+Batch API allows you to validate multiple statements across multiple databases in a single API call.
+
+You should use batch API for the GitOps workflow. Because a single PR or MR may contain multiple dependent
+migration files (e.g., `1_create_t1_table.sql`, `2_create_t1_index.sql`). By retaining the context from
+earlier files, the Batch API ensures each subsequent file is validated accurately.
+
+## Simple API
+
+|          |                                                                                  |
+| -------- | -------------------------------------------------------------------------------- |
+| Endpoint | [POST /v1/sql/check](https://api.bytebase.com/#tag/sqlservice/POST/v1/sql/check) |
+| Request  | https://api.bytebase.com/#model/checkrequest                                     |
+| Response | https://api.bytebase.com/#model/checkresponse                                    |
+| Example  | https://github.com/bytebase/api-example/tree/main/sql-review#simple-api          |
+
+Simple API allows you to validate a single statement against a single database.