Authentification
Génère ta clé dans le dashboard puis envoie l'en-tête Authorization: Bearer nico_… à chaque requête.
Convertir un fichier
POST https://nicolette.app/api/v1/convert
Authorization: Bearer nico_xxx
Content-Type: application/json
{
"source_url": "https://example.com/photo.heic",
"from": "heic",
"to": "jpg",
"options": { "quality": 90 }
}Retourne un job id. Poll /api/v1/convert/:id jusqu'à ce que status soit READY.
Télécharger depuis un réseau social
POST https://nicolette.app/api/v1/social
Authorization: Bearer nico_xxx
Content-Type: application/json
{
"url": "https://www.youtube.com/watch?v=...",
"format": "mp4-1080",
"audio_only": false
}Limites de débit
1000 req/h sur Pro+. Hard cap de 50 jobs concurrents.
Erreurs
Toutes les réponses non-2xx renvoient { "error": string }. Codes courants :
401— clé API absente ou invalide402— la fonctionnalité demande une upgrade de plan429— rate-limit dépassé