Partager via

Syntaxe de chaîne de requête pour le serveur de test PlayReady

Aperçu

Le serveur de test PlayReady prend en charge la syntaxe de chaîne de requête pour les demandes de licence, en fournissant une méthode basée sur l’URL pour spécifier les paramètres de licence. Cette approche permet aux développeurs d’incorporer la configuration de licence directement dans l’URL, ce qui facilite le test de différents scénarios et configurations.

Format de syntaxe

La syntaxe de chaîne de requête utilise des paramètres d’URL standard pour spécifier les exigences de licence :

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=CONFIGURATION&kid=KEY_ID

Paramètres pris en charge

Paramètre de configuration (cfg)

Le cfg paramètre spécifie la configuration de la licence :

  • persistent : crée une licence persistante qui peut être stockée sur l’appareil
  • non persistant : crée une licence temporaire qui expire lorsque l’application se ferme
  • location : crée une licence de location avec des restrictions temporelles
  • abonnement : crée une licence basée sur un abonnement

Paramètre d’ID de clé (kid)

Le kid paramètre spécifie l’ID de clé pour le déchiffrement du contenu :

  • Doit être un format GUID valide
  • Correspond à l’identificateur de clé de chiffrement du contenu
  • Utilisé pour faire correspondre la licence avec le contenu chiffré

Exemples d’URL

Licence permanente de base

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=persistent&kid=12345678-1234-1234-1234-123456789012

Licence non persistante

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=non-persistent&kid=87654321-4321-4321-4321-210987654321

Licence de location avec expiration de 48 heures

https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=rental&kid=12345678-1234-1234-1234-123456789012&expiry=48h

Scénarios de test

Acquisition de licences de base

  1. Générer une demande de licence à l’aide de votre client PlayReady
  2. Construire l’URL avec les paramètres appropriés
  3. Envoyer une requête HTTP POST à l’URL construite
  4. Traiter la réponse de licence retournée

Différents types de licences

Testez différentes configurations de licence en modifiant le cfg paramètre :

  • Tester le comportement persistant et non persistant
  • Vérifier la fonctionnalité d’expiration de location
  • Valider l’accès en fonction de l’abonnement

Gestion des erreurs

Scénarios d’erreur courants et réponses :

ID de clé non valide

  • Erreur : GUID mal formé dans kid le paramètre
  • Réponse : Requête incorrecte HTTP 400 avec détails d’erreur

Configuration non prise en charge

  • Erreur : valeur non valide pour cfg le paramètre
  • Réponse : Requête incorrecte HTTP 400 avec des valeurs prises en charge

Paramètres manquants

  • Erreur : Paramètres requis non fournis
  • Réponse : Requête incorrecte HTTP 400 avec configuration requise pour les paramètres

Meilleures pratiques

  1. Encodage d’URL : garantir l’encodage d’URL approprié des valeurs de paramètre
  2. Utilisation https : Toujours utiliser des connexions sécurisées pour les demandes de licence
  3. Validation des paramètres : Valider les paramètres avant d’effectuer des requêtes
  4. Gestion des erreurs : Implémenter une gestion robuste des erreurs pour différents scénarios

Exemples d’intégration

JavaScript/HTML5

const licenseUrl = `https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=persistent&kid=${keyId}`;
// Use with your PlayReady implementation

C# Application

string licenseUrl = $"https://playready.directtaps.net/pr/svc/rightsmanager.asmx?cfg=persistent&kid={keyId}";
// Use with PlayReady SDK

Support et résolution des problèmes

Pour les problèmes liés à la syntaxe de chaîne de requête :

  1. Vérifier la mise en forme et les valeurs des paramètres
  2. Vérifier l’encodage d’URL de caractères spéciaux
  3. Valider le format d’ID de clé (GUID)
  4. Tester avec différentes configurations de licence
  5. Passer en revue la réponse du serveur pour obtenir les détails de l’erreur

Pour obtenir une prise en charge supplémentaire, reportez-vous à la documentation principale des serveurs de test PlayReady .

  • Last updated on