Guide
Autorisation de ressources de portrait
Créer une session de scan de code QR pour portrait et confirmer la fin de la collecte
Autorisation de ressources de portrait
Les ressources de portrait doivent être collectées et autorisées sur téléphone par la personne concernée elle-même ; un import d'image ordinaire ne peut pas remplacer cette procédure.
Créer une session de scan de code QR pour portrait
/api/v1/materials/portrait/sessionsMéthode d'authentification
Authorization: Bearer <API_KEY>.
Corps de la requête · application/json
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
continuous_create | boolean | Non | Lorsque la valeur est true, continue de créer la session d'autorisation suivante une fois l'analyse terminée |
Exemple de requête
curl -X POST "$LOCOPAL_BASE_URL/api/v1/materials/portrait/sessions" \
-H "Authorization: Bearer $LOCOPAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"continuous_create":false}'Paramètres de réponse
| Paramètre | Type | Description |
|---|---|---|
code | integer | 0 en cas de succès |
msg | string | 真人授权会话已创建 en cas de succès |
data.session.authorization_url | string | Adresse de la page d'autorisation, à convertir en code QR et à remettre à la personne concernée |
data.session.session_token | string | Jeton de session, conservé uniquement côté serveur |
data.session.expires_in | integer | Durée de validité de la session (secondes) |
data.session.expire_time | string | Date d'expiration de la session (chaîne de date ISO) |
Corps de la réponse
{
"code": 0,
"data": {
"session": {
"authorization_url": "https://授权页面地址",
"session_token": "session-token",
"expires_in": 600,
"expire_time": "2026-09-09T08:10:00.000Z"
}
},
"msg": "真人授权会话已创建"
}Ne consignez pas session_token dans les journaux, ne l'envoyez pas à d'autres comptes et ne le conservez pas à long terme ; recréez une session après expiration.
Réponses d'erreur
| HTTP | msg | Description |
|---|---|---|
400 | 请求体必须是 JSON 对象 | Le corps de la requête n'est pas un JSON valide |
401 | Invalid token | Clé API absente, erronée ou expirée |
503 | 素材服务暂不可用 | Le canal de collecte de portrait n'est pas prêt ; conservez l'heure de la requête et contactez le support de la plateforme |
Confirmer la fin du scan de code QR du portrait
/api/v1/materials/portrait/resolveMéthode d'authentification
Authorization: Bearer <API_KEY>.
Corps de la requête · application/json
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
session_token | string | Oui | Le data.session.session_token renvoyé lors de la création de la session de scan |
Exemple de requête
curl -X POST "$LOCOPAL_BASE_URL/api/v1/materials/portrait/resolve" \
-H "Authorization: Bearer $LOCOPAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_token":"session-token"}'Paramètres de réponse
| Paramètre | Type | Description |
|---|---|---|
code | integer | 0 en cas de succès |
msg | string | 真人授权已完成 en cas de succès |
data.group.id | string | ID du groupe de ressources de portrait généré par la collecte |
data.group.name | string | Nom du groupe |
data.group.type | string | Toujours real |
data.group.description | string / null | Description du groupe |
Corps de la réponse
{
"code": 0,
"data": {
"group": {
"id": "group-20260911034940-lrtht",
"name": "真人素材库",
"type": "real",
"description": null
}
},
"msg": "真人授权已完成"
}Après une analyse réussie, appelez Synchroniser le statut des ressources et interrogez la liste des ressources pour lire l'asset_id et le status de la ressource de portrait.
Réponses d'erreur
| HTTP | msg | Description |
|---|---|---|
400 | 请求体必须是 JSON 对象 | Le corps de la requête n'est pas un JSON valide |
401 | Invalid token | Clé API absente, erronée ou expirée |
503 | 素材服务暂不可用 | La session n'existe pas, la collecte n'est pas encore terminée, ou le canal de collecte de portrait n'est pas prêt |
Synchroniser le statut des ressources
Actualiser, pour le compte actuel, le nom, le statut, les informations d'erreur et l'adresse d'accès des groupes et des ressources
Questions fréquentes sur la bibliothèque de ressources
Appartenance des groupes, durée de validation, fréquence d'interrogation et exigences relatives aux adresses d'image