---
updatedAt: 2026-04-22T09:23:29.000Z
agentTools:
  projectIndex: https://arctos.readme.io/llms.txt
---

# 取得驗證碼

This is your first endpoint! Edit this page to start documenting your API.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "arctos OpenAPI"
  },
  "servers": [
    {
      "url": "https://www-sit.arctos.tw/api/v2"
    },
    {
      "url": "https://www-sit.arctos.tw/api/mock-v2"
    },
    {
      "url": "https://api-healthplus-sit.arctos.tw/api/v2"
    },
    {
      "url": "https://ctbc-sit.arctos.tw/api/v2"
    }
  ],
  "paths": {
    "/../auth/code": {
      "post": {
        "summary": "取得驗證碼",
        "tags": [
          "AUTH",
          "直連 SDK FLOW",
          "中繼 SDK FLOW"
        ],
        "description": "This is your first endpoint! Edit this page to start documenting your API.",
        "operationId": "post_api_auth_code",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "examples": {
                  "Example 1": {
                    "summary": "Example 1",
                    "value": {
                      "status": 1,
                      "message": "success",
                      "info": {
                        "code": "def5020010e70fd084ca280ed731a0fc38eb876c233a361e20119532e9a8991bac3e4ad959d20e629d45c57001db50594cf49242a3c2dcffa2d4c86454f89e2630ffe26536c7218bbd6199ae0c241761db3940599b0402d1a2127b76e037d0b325dcb591e85e72e9b4fe1111563d273ace82d7ca4faa6873dd66627e8f8658c0bc6603ea192de4b38c785a6537a978a6a810c0f2d6c3b2a28f68aadace13b125b5cb7d8bb42d6b5599db48916004a5729958efebdd6f0d6e6c9e59b9bde464936073813e5d7e08b39e61af6d751a7edaddb849af71e43e957305a3fb7cf5f2de38f256b072a539674a38c87d640b2d45dc618d4a1fa8d43ea05c34a3645e5c82b5f579dcff35b8e939616681e14b202ecca8c3cb28c2ce4f3bdb86de6a278600442abd896fa66e4bedfdb5f0ddf7193f2594a1aca26a78e08ab50cc4c8989f8059e377247871c9582dc46b90e250136518bac92560976e15758593876d4d2b7cf34411d6589f30bcba93d2c5fa7b55eff2"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "arc-license-id",
            "in": "header",
            "required": true,
            "description": "arctos application id",
            "schema": {
              "type": "string",
              "default": "9ec06e76-a8f0-4ad7-bf90-4d9840ba7d87"
            }
          },
          {
            "name": "arc-license-key",
            "in": "header",
            "required": true,
            "description": "arctos application key",
            "schema": {
              "type": "string",
              "default": "pTh3erjr0SHkuD8qY64LMQa5cOR5yjcbIYPch5nQ"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AuthCodeRequest"
              },
              "examples": {
                "Example SWITCH": {
                  "summary": "Example SWITCH",
                  "value": {
                    "user_id": "100001",
                    "name": "Roger",
                    "role": "SWITCH"
                  }
                },
                "Example CLIENT": {
                  "summary": "Example CLIENT",
                  "value": {
                    "user_id": "200001",
                    "name": "Alice",
                    "role": "CLIENT"
                  }
                },
                "Example MODERATOR": {
                  "summary": "Example MODERATOR",
                  "value": {
                    "user_id": "300001",
                    "name": "Bob",
                    "role": "MODERATOR"
                  }
                },
                "Example PUBLISHER": {
                  "summary": "Example PUBLISHER",
                  "value": {
                    "user_id": "400001",
                    "name": "Charlie",
                    "role": "PUBLISHER"
                  }
                },
                "Example ADMIN": {
                  "summary": "Example ADMIN",
                  "value": {
                    "user_id": "500001",
                    "name": "David",
                    "role": "ADMIN"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AuthCodeRequest": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string",
            "default": "",
            "description": "使用者識別ID: 可以為EMail、統一編號、身分證字號(僅允許使用英數字與底線)。",
            "x-readme-id": "0.0"
          },
          "name": {
            "type": "string",
            "default": "",
            "description": "使用者名稱: 可以為電話號碼、登入用戶名。",
            "x-readme-id": "0.1"
          },
          "role": {
            "type": "string",
            "default": "",
            "description": "使用者角色: ADMIN、SWITCH、CLIENT、MODERATOR、PUBLISHER",
            "enum": [
              "ADMIN",
              "SWITCH",
              "CLIENT",
              "MODERATOR",
              "PUBLISHER"
            ],
            "x-readme-id": "0.2"
          }
        },
        "required": [
          "user_id",
          "name",
          "role"
        ]
      }
    }
  }
}
```