|
17514 | 17514 | "Platform/Members" |
17515 | 17515 | ], |
17516 | 17516 | "x-mint": { |
17517 | | - "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | **Members Manage** (`organization`) |", |
| 17517 | + "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | **Members Manage** (`organization`) |\n\n## Usage\n\n- `country_code` must be an ISO 3166-1 alpha-2 region code (e.g. \"CN\"). It is validated and normalized to upper case before storage; invalid values are rejected with a 400.\n- When a member's `phone` has no \"+\" prefix, it is parsed with that member's `country_code` as the region hint (defaults to \"CN\" when omitted).", |
17518 | 17518 | "href": "/en/api-reference/platform/members/member-invite", |
17519 | 17519 | "metadata": { |
17520 | 17520 | "sidebarTitle": "Invite members" |
|
17584 | 17584 | "role_ids": [ |
17585 | 17585 | 6 |
17586 | 17586 | ] |
| 17587 | + }, |
| 17588 | + { |
| 17589 | + "member_name": "Dave", |
| 17590 | + "phone": "13800138000", |
| 17591 | + "country_code": "CN", |
| 17592 | + "locale": "zh-CN", |
| 17593 | + "time_zone": "Asia/Shanghai" |
17587 | 17594 | } |
17588 | 17595 | ] |
17589 | 17596 | } |
|
17821 | 17828 | "Platform/Members" |
17822 | 17829 | ], |
17823 | 17830 | "x-mint": { |
17824 | | - "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **300 requests/minute**; **20 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- Identify the member with one of `member_id`, `member_name`, `email`, `phone`, or `ref_id`. If multiple identifiers are present, the server checks them in that order.\n- When identifying or updating a member by `phone`, include `country_code` when the number needs country-specific parsing.\n- Put the profile fields to write under `updates`: `member_name`, `password`, `phone`, `country_code`, `email`, `avatar`, `locale`, `time_zone`, or `ref_id`.\n- Members provisioned by SSO cannot be changed when SSO marks them as externally managed.\n- `updates` must carry at least one field; an object with every field omitted is rejected.", |
| 17831 | + "content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **300 requests/minute**; **20 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- Identify the member with one of `member_id`, `member_name`, `email`, `phone`, or `ref_id`. If multiple identifiers are present, the server checks them in that order.\n- `updates.country_code` is an ISO 3166-1 alpha-2 region code (e.g. \"CN\", \"US\"). It is an independently updatable field: `updates.phone` is not required, and the new region is stored even when the phone is unchanged. An explicit empty string is rejected with a 400.\n- When `updates.phone` has no \"+\" prefix, it is parsed with `updates.country_code` as the region hint, falling back to the member's stored region and then to \"CN\". Legacy digit calling codes such as \"86\" remain accepted only as parsing hints — stored values are always ISO region codes.\n- The top-level `country_code` is only a parsing hint for the identifying `phone`; it is never stored.\n- Put the profile fields to write under `updates`: `member_name`, `password`, `phone`, `country_code`, `email`, `avatar`, `locale`, `time_zone`, or `ref_id`.\n- Members provisioned by SSO cannot be changed when SSO marks them as externally managed.\n- `updates` must carry at least one field; an object with every field omitted is rejected.", |
17825 | 17832 | "href": "/en/api-reference/platform/members/member-reset-info", |
17826 | 17833 | "metadata": { |
17827 | 17834 | "sidebarTitle": "Reset member info" |
|
21020 | 21027 | "acme-corp" |
21021 | 21028 | ], |
21022 | 21029 | "phone": "138****8000", |
21023 | | - "country_code": "86", |
| 21030 | + "country_code": "CN", |
21024 | 21031 | "email": "ops@acme.example", |
21025 | 21032 | "avatar": "https://cdn.flashcat.cloud/avatar/acme.png", |
21026 | 21033 | "locale": "zh-CN", |
|
45489 | 45496 | }, |
45490 | 45497 | "country_code": { |
45491 | 45498 | "type": "string", |
45492 | | - "description": "Phone country code" |
| 45499 | + "description": "ISO 3166-1 alpha-2 region code of the member's contact phone (e.g. \"CN\", \"US\", \"HK\")." |
45493 | 45500 | }, |
45494 | 45501 | "avatar": { |
45495 | 45502 | "type": "string", |
|
45594 | 45601 | }, |
45595 | 45602 | "country_code": { |
45596 | 45603 | "type": "string", |
45597 | | - "description": "Phone country code" |
| 45604 | + "description": "ISO 3166-1 alpha-2 region code of the member's contact phone (e.g. \"CN\", \"US\", \"HK\")." |
45598 | 45605 | }, |
45599 | 45606 | "phone": { |
45600 | 45607 | "type": "string", |
|
45709 | 45716 | }, |
45710 | 45717 | "country_code": { |
45711 | 45718 | "type": "string", |
45712 | | - "description": "Phone country code, used with phone" |
| 45719 | + "description": "Region hint for parsing `phone` when it has no \"+\" prefix — an ISO 3166-1 alpha-2 code such as \"CN\" (the default when omitted). Legacy digit calling codes like \"86\" are still accepted in this parsing context." |
45713 | 45720 | }, |
45714 | 45721 | "ref_id": { |
45715 | 45722 | "type": "string", |
|
45742 | 45749 | }, |
45743 | 45750 | "country_code": { |
45744 | 45751 | "type": "string", |
45745 | | - "description": "Country code" |
| 45752 | + "description": "ISO 3166-1 alpha-2 region code for `phone` (e.g. \"CN\"). Validated and normalized to upper case before storage; invalid values are rejected with a 400. Also the parsing hint when `phone` has no \"+\" prefix (defaults to \"CN\")." |
45746 | 45753 | }, |
45747 | 45754 | "role_ids": { |
45748 | 45755 | "type": "array", |
|
45939 | 45946 | }, |
45940 | 45947 | "country_code": { |
45941 | 45948 | "type": "string", |
45942 | | - "description": "Country or region code used to parse phone." |
| 45949 | + "description": "Region hint for parsing `phone` when it has no \"+\" prefix — an ISO 3166-1 alpha-2 code such as \"CN\" (the default when omitted). Legacy digit calling codes like \"86\" are still accepted in this parsing context." |
45943 | 45950 | }, |
45944 | 45951 | "ref_id": { |
45945 | 45952 | "type": "string", |
|
45975 | 45982 | }, |
45976 | 45983 | "country_code": { |
45977 | 45984 | "type": "string", |
45978 | | - "description": "Country or region code for the new phone number." |
| 45985 | + "description": "ISO 3166-1 alpha-2 region code (e.g. \"CN\", \"US\"). Updated independently — `phone` is not required — and also used as the parsing hint for `phone`. Invalid values are rejected with a 400; an explicit empty string is not allowed." |
45979 | 45986 | }, |
45980 | 45987 | "email": { |
45981 | 45988 | "type": "string", |
|
46061 | 46068 | "type": "string", |
46062 | 46069 | "description": "Email address" |
46063 | 46070 | }, |
| 46071 | + "country_code": { |
| 46072 | + "type": "string", |
| 46073 | + "description": "ISO 3166-1 alpha-2 region code of the contact phone (e.g. \"CN\", \"US\", \"HK\")." |
| 46074 | + }, |
46064 | 46075 | "phone": { |
46065 | 46076 | "type": "string", |
46066 | 46077 | "description": "Phone number" |
|
48361 | 48372 | }, |
48362 | 48373 | "country_code": { |
48363 | 48374 | "type": "string", |
48364 | | - "description": "Calling country code for the contact phone." |
| 48375 | + "description": "ISO 3166-1 alpha-2 region code of the contact phone (e.g. \"CN\", \"US\", \"HK\")." |
48365 | 48376 | }, |
48366 | 48377 | "email": { |
48367 | 48378 | "type": "string", |
|
0 commit comments