Erreurs

Les erreurs utilisent le format RFC 9457 problem details avec le type de contenu application/problem+json et un code stable, exploitable par programme.

{
  "type": "https://meetingize.com/docs/api/errors#insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "This endpoint requires the scope 'read:transcripts'.",
  "instance": "/api/v1/meetings/1b9e.../transcript",
  "code": "insufficient_scope",
  "request_id": "req_5f0c..."
}

Les erreurs de validation ajoutent errors: [{"field": "...", "message": "..."}].

Codes d’erreur

HTTP	code	Que faire
400	invalid_request, validation_error, invalid_cursor	corrigez la requête (voir errors)
401	missing_credentials, invalid_api_key, invalid_token, api_key_revoked, api_key_expired	vérifiez l’identifiant
402	insufficient_balance, spend_cap_reached	ajoutez des crédits, activez le paiement à l’usage ou relevez le plafond (facturation)
403	insufficient_scope, api_disabled	utilisez un identifiant avec le bon scope
404	not_found	l’objet n’existe pas ou appartient à un autre compte
405	method_not_allowed
409	transcript_not_ready, summary_not_ready	réessayez plus tard ou attendez le webhook
409	idempotency_key_in_use	la première requête avec cette clé est encore en cours
413	file_too_large	les fichiers sont limités à 2 Go
415	unsupported_media_type	envoyez du JSON ou du multipart comme documenté
422	idempotency_key_reused, invalid_audio, unprocessable
429	rate_limited, parallel_processing_limit	attendez (Retry-After) et réessayez, voir limites
500	internal_error	réessayez avec backoff, contactez le support avec le request_id

Limites de débit et quotas

Les limites de débit par offre et le quota de traitement en parallèle sont décrits sur la page limites.

Conseils de nouvelle tentative

• Réessayez les 429 et 5xx avec un backoff exponentiel (par exemple 1 s, 2 s, 4 s… jusqu’à 1 minute), en respectant Retry-After.
• Envoyez toujours un Idempotency-Key sur POST pour que les nouvelles tentatives soient sûres.
• Ne réessayez pas les autres 4xx sans modifier la requête.