Ressources publiques en lecture seule
Les pages publiques sont rendues côté serveur, possèdent des URLs canoniques par langue et incluent des données structurées le cas échéant. Le flux de connaissances ci-dessous contient les mêmes guides et réponses publics visibles sur ce site web. Il exclut les comptes, messages privés, fichiers de livraison et données de transaction.
- GET /knowledge.json — enregistrements versionnés de pages et questions publiques, avec URLs canoniques, langue et date de mise à jour.
- GET /llms.txt — répertoire concis des ressources officielles du marché.
- GET /sitemap.xml — pages publiques publiées et URLs de films dans les langues prises en charge.
- Pages de projet — identifiants INDEX publics, liens sources et informations de projet disponibles.
Contrat du flux de connaissances
Utilisez le champ schemaVersion pour détecter un changement de format. Chaque page possède un chemin stable, une url, un titre, une description, des sections et des questions. Chaque question possède un id, une question, une réponse et un lien optionnel vers l'étape suivante. La requête lang accepte une locale prise en charge, par exemple /knowledge.json?lang=zh-Hant. Les valeurs de langue non prises en charge renvoient HTTP 400. Utilisez des requêtes conditionnelles avec l'en-tête ETag ; les ressources inchangées renvoient HTTP 304.
Citez l'URL canonique de la page, la langue et la date de mise à jour lors de la présentation d'une réponse. Conservez les réserves concernant les droits, la disponibilité du service et les chiffres communiqués par la source. L'accès public aux métadonnées ne confère aucune licence pour réutiliser un film, une affiche ou autre création.
curl -i 'https://hkaiiff.market/knowledge.json?lang=fr'Intégrations privées et accès en écriture
Les points de terminaison d'application authentifiés sont des flux de travail internes, et non une API partenaire publique. Aucune émission de clé développeur publique, API d'achat externe ou intégration de règlement automatique n'est actuellement proposée. Une intégration proposée nécessite des identifiants à portée organisationnelle, un accès à privilège minimal, des actions idempotentes, une piste d'audit et un accord distinct avant que l'accès en écriture ne soit activé.
Signaler un problème technique ou de sécurité
Envoyez l'URL publique concernée, l'horodatage, le résultat attendu et une reproduction minimale à business@hkaiiff.org. Pour les problèmes de sécurité, partagez d'abord une description et demandez un canal privé pour les preuves. N'incluez pas de jetons d'accès, codes de connexion, clés privées ou données d'une autre organisation. Ne procédez pas à des tests destructifs ni à une collecte massive d'enregistrements privés.