Obtenir le rapport d’un sujet d’audit
curl --request GET \
--url https://www.qwairy.co/api/v1/pitch-audits/{auditId}/reports/{subjectId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/pitch-audits/{auditId}/reports/{subjectId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/pitch-audits/{auditId}/reports/{subjectId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Audits de prospection
Obtenir le rapport d’un sujet d’audit
Lisez la vue d’un concurrent ou d’un co-concurrent dérivée d’un audit de prospection.
GET
https://www.qwairy.co
/
api
/
v1
/
pitch-audits
/
{auditId}
/
reports
/
{subjectId}
Obtenir le rapport d’un sujet d’audit
curl --request GET \
--url https://www.qwairy.co/api/v1/pitch-audits/{auditId}/reports/{subjectId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/pitch-audits/{auditId}/reports/{subjectId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/pitch-audits/{auditId}/reports/{subjectId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Le rapport d’un sujet réorganise les données du même audit de prospection autour d’un concurrent ou d’un co-concurrent détecté. Il ne crée pas de second audit et ne régénère aucune donnée.
Pour inclure les réponses :
La réponse utilise le même schéma de rapport que Obtenir un audit de prospection. Son
string
requis
Jeton d’API bearer. Exemple :
Bearer qw-api-xxxParamètres de chemin
string
requis
Identifiant de l’audit de prospection parent.
string
requis
Valeur renvoyée par
competitors[].subjectId, availableSubjects[].id ou coCompetitors[].subjectId.Paramètres de requête
boolean
défaut:"false"
Inclut le texte complet des réponses IA. Par défaut, seule la synthèse limitée du rapport est renvoyée.
boolean
défaut:"false"
Ajoute la synthèse de scores complète à tous les co-concurrents du sujet sélectionné.
Exemple de requête
curl "https://www.qwairy.co/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8/reports/orbit.example" \
-H "Authorization: Bearer qw-api-your-token-here"
curl "https://www.qwairy.co/api/v1/pitch-audits/8a218180-6dd7-43c7-a481-f6a1cc72dfd8/reports/orbit.example?includeAnswers=true" \
-H "Authorization: Bearer qw-api-your-token-here"
reportSubject identifie le concurrent sélectionné, et ses lignes coCompetitors renvoient vers d’autres sujets résolubles. Suivez le reportUrl de la ligne du prospect d’origine pour revenir au rapport de base.
Erreurs
| Statut | Code | Description |
|---|---|---|
| 400 | INVALID_PARAMETER | Paramètre de requête ou de sujet invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | PITCH_AUDIT_NOT_FOUND | Audit ou sujet demandé inaccessible |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez Retry-After |

