nicolette.app
// documentation

API Nicolette.

Disponible sur le plan Pro+. Génère ta clé dans le dashboard, puis authentifie-toi avec un header Authorization.

authentification

Authentification

Génère ta clé dans le dashboard puis envoie l'en-tête Authorization: Bearer nico_… à chaque requête.

convertir un fichier

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

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

Limites de débit

1000 req/h sur Pro+. Hard cap de 50 jobs concurrents.

erreurs

Erreurs

Toutes les réponses non-2xx renvoient { "error": string }. Codes courants :

  • 401 — clé API absente ou invalide
  • 402 — la fonctionnalité demande une upgrade de plan
  • 429 — rate-limit dépassé