Créer un lien d'invitation de membre - Alibaba Cloud Model Studio

Créer un lien d'invitation de membre TokenPlan.

Prérequis

Vous avez obtenu l'AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM, et l'identité s'est vu accorder les autorisations RAM nécessaires pour appeler cette opération. Nous vous recommandons de définir l'AccessKey comme variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET plutôt que de le coder en dur.

Description de la requête

Méthode HTTP : POST
URL de la requête
Région
Point de terminaison
Singapour
POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create
Authentification
Cette opération est une opération OpenAPI Alibaba Cloud qui utilise des signatures basées sur AccessKey (l'algorithme ACS3-HMAC-SHA256). Le schéma Authorization: Bearer {API_KEY} n'est pas pris en charge. Une requête doit comporter les en-têtes communs x-acs-action: CreateTokenPlanInviteLink, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce et Authorization.

Nous vous recommandons d'appeler cette opération avec un SDK Alibaba Cloud ou OpenAPI Explorer afin de ne pas avoir à calculer la signature vous-même.

Région	Point de terminaison
Singapour	`POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create`

Chaque utilisateur est autorisé à avoir un seul lien d'invitation valide.
Si l'utilisateur possède déjà un lien d'invitation valide, cette API renverra ce lien.
Pour créer un nouveau lien, appeler l'API RevokeTokenPlanInviteLink pour invalider le lien actuel.
该接口只返回生成的 token，邀请链接的拼接格式为 https://{host}/accept-invite?token=[token]&orgId=[orgId]
Pour le site Chine, l'hôte est tokenplan-enterprise.bailian.aliyunportal.com.
Pour le site international, l'hôte est tokenplan-enterprise.modelstudio.aliyunportal.com.

Paramètres de la requête

Tous les paramètres sont transmis dans la chaîne de requête.

Paramètre	Type	Obligatoire	Description
ExpireType	string	Non	Niveau d'expiration. Par défaut : DAYS_7. DAYS_7 DAYS_30 MONTHS_6 YEAR_1
SsoSource	string	Oui	Méthode de connexion SSO liée au lien d'invitation : SAML DINGTALK

Paramètres de réponse

Paramètre	Type	Description
Success	boolean	Indique si l'appel API a réussi : true : succès false : échec
Code	string	Code d'état de la réponse.
Message	string	Message de réponse.
Data	object	Paramètres métier.
Token	string	Jeton généré.

Exemple de requête

Cette opération utilise les signatures OpenAPI d'Alibaba Cloud. Dans l'exemple suivant, ${SIGNATURE} doit être calculé avec l'algorithme ACS3-HMAC-SHA256, et x-acs-date ainsi que x-acs-signature-nonce doivent être remplacés par des valeurs réelles.

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}"

Exemple de réponse

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

Codes d'erreur

Si l'appel échoue, un message d'erreur est renvoyé. Pour plus de codes d'erreur et de solutions, consultez Codes d'erreur.