Alibaba Cloud Model Studio:Crear enlace de invitación de miembro

Crear un enlace de invitación de miembro de TokenPlan.

Requisitos previos

Ha obtenido la AccessKey de una cuenta de Alibaba Cloud o de un usuario RAM, y a la identidad se le han otorgado los permisos RAM necesarios para invocar esta operación. Le recomendamos que configure la AccessKey como las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET en lugar de codificarla directamente.

Descripción de la solicitud

• Método HTTP: POST

• URL de solicitud

  Región	Endpoint
  Singapur	POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create

• Autenticación

  Esta operación es una operación de OpenAPI de Alibaba Cloud que utiliza firmas basadas en AccessKey (el algoritmo ACS3-HMAC-SHA256). No se admite el esquema Authorization: Bearer {API_KEY}. Una solicitud debe llevar los encabezados comunes x-acs-action: CreateTokenPlanInviteLink, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce y Authorization.

  Le recomendamos que invoque esta operación con un SDK de Alibaba Cloud o OpenAPI Explorer para no tener que calcular la firma usted mismo.

Cada usuario solo puede tener un enlace de invitación válido.
Si el usuario ya tiene un enlace de invitación válido, esta API devolverá dicho enlace.
Para crear un nuevo enlace, llame a la API RevokeTokenPlanInviteLink para invalidar el enlace actual.
Esta API solo devuelve el token generado. El enlace de invitación se ensambla con el siguiente formato: https://{host}/accept-invite?token=[token]&orgId=[orgId]
Para el sitio de China, el host es tokenplan-enterprise.bailian.aliyunportal.com.
Para el sitio internacional, el host es tokenplan-enterprise.modelstudio.aliyunportal.com.

Parámetros de solicitud

Todos los parámetros se pasan en la cadena de consulta.

Parámetro	Tipo	Obligatorio	Descripción
ExpireType	string	No	Nivel de caducidad. Valor predeterminado: DAYS_7. DAYS_7 DAYS_30 MONTHS_6 YEAR_1
SsoSource	string	Sí	Método de inicio de sesión SSO vinculado al enlace de invitación: SAML DINGTALK

Parámetros de respuesta

Parámetro	Tipo	Descripción
Success	boolean	Indica si la llamada a la API fue exitosa: true: éxito false: fallo
Code	string	Código de estado de la respuesta.
Message	string	Mensaje de respuesta.
Data	object	Parámetros de negocio.
Token	string	Token generado.

Ejemplo de solicitud

Esta operación utiliza firmas de OpenAPI de Alibaba Cloud. En el siguiente ejemplo, ${SIGNATURE} debe calcularse con el algoritmo ACS3-HMAC-SHA256, y x-acs-date y x-acs-signature-nonce deben reemplazarse con valores reales.

curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create?ExpireType=DAYS_7&SsoSource=SAML" \
    --header "x-acs-action: CreateTokenPlanInviteLink" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: ${SIGNATURE_NONCE}" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

Ejemplo de respuesta

{
  "Success": true,
  "Data": {
    "Token": "sk-ws-D.****.*******"
  }
}

Códigos de error

Si la llamada falla, se devuelve un mensaje de error. Para obtener más códigos de error y soluciones, consulte Códigos de error.