Αναφορά API

Τεκμηρίωση API συστατικών καλλυντικών

Πλήρης αναφορά API για τα endpoints ανάλυσης INCI, βαθμολόγησης ασφάλειας, ανίχνευσης αλλεργιογόνων και συμβατότητας δέρματος.

Πιστοποίηση για το API καλλυντικών

Όλα τα αιτήματα στο INCI API απαιτούν κλειδί API που αποστέλλεται μέσω της κεφαλίδας X-API-Key. Λάβετε το δωρεάν κλειδί API από τον Πίνακα ελέγχου.

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913" \
  -H "X-API-Key: sk_live_your_api_key"

Δήλωση δεδομένων

Important Disclaimer

The ingredient safety data, scores, and ratings provided by INCI API are for informational and educational purposes only. This information is compiled from public databases and scientific literature, and may contain errors, omissions, or outdated information. INCI API does not guarantee the accuracy, completeness, or reliability of any data presented.

This service does not provide medical, dermatological, or health advice. Safety scores and ratings are algorithmic assessments based on available data and should not be used as a substitute for professional medical advice, diagnosis, or treatment. Always consult a qualified healthcare professional or dermatologist before making decisions about cosmetic products, especially regarding pregnancy safety, allergies, or skin conditions.

INCI API assumes no liability for any decisions made based on the information provided.

Όλες οι αποκρίσεις του API περιλαμβάνουν δεδομένα συστατικών συγκεντρωμένα από δημόσιες πηγές, όπως EU CosIng, αναφορές CIR και δημοσιευμένη επιστημονική βιβλιογραφία. Η ακρίβεια δεν είναι εγγυημένη. Οι βαθμολογίες ασφάλειας είναι αλγοριθμικές εκτιμήσεις βάσει διαθέσιμων δεδομένων, όχι κλινικές αξιολογήσεις. Οι χρήστες οφείλουν να επαληθεύουν ανεξάρτητα όλες τις πληροφορίες συστατικών. Δείτε τους Όρους Χρήσης και τη Σύμβαση Άδειας API για τους πλήρεις όρους.

Endpoints API ανάλυσης INCI

GET/v1/products/:barcodeFree+

Αναζητήστε προϊόν ομορφιάς με γραμμωτό κωδικό. Επιστρέφει πληροφορίες προϊόντος, μάρκα, λίστα INCI και εικόνες.

Αίτημα

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913" \
  -H "X-API-Key: sk_live_your_api_key"

Απάντηση

json

{
  "success": true,
  "data": {
    "barcode": "3337875597913",
    "name": "La Roche-Posay Toleriane Double Repair",
    "brand": "La Roche-Posay",
    "category": ["Skincare", "Moisturizer"],
    "imageUrls": ["https://cdn.inciapi.com/..."],
    "inciList": [
      "Aqua", "Glycerin", "Dimethicone",
      "Niacinamide", "Ceramide NP"
    ],
    "vertical": "cosmetics",
    "qualityScore": 92
  }
}

GET/v1/products/:barcode/safetyStarter+

Λάβετε πλήρη ανάλυση ασφάλειας προϊόντος. Περιλαμβάνει συνολική βαθμολογία και αξιολογήσεις ανά συστατικό.

Αίτημα

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/safety" \
  -H "X-API-Key: sk_live_your_api_key"

Απάντηση

json

{
  "success": true,
  "data": {
    "overallSafetyScore": 92,
    "cleanBeautyScore": 88,
    "ingredients": [
      {
        "inciName": "Aqua",
        "safetyRating": 1,
        "functions": ["Solvent"],
        "isAllergen": false,
        "isPregnancySafe": true
      },
      {
        "inciName": "Niacinamide",
        "safetyRating": 1,
        "functions": ["Antioxidant", "Brightening"],
        "isAllergen": false,
        "isPregnancySafe": true
      },
      {
        "inciName": "Phenoxyethanol",
        "safetyRating": 4,
        "functions": ["Preservative"],
        "isAllergen": false,
        "isPregnancySafe": true
      }
    ]
  }
}

GET/v1/products/:barcode/allergensStarter+

Λάβετε προειδοποιήσεις αλλεργιογόνων για ένα προϊόν. Ελέγχει 80 υποχρεωτικά αλλεργιογόνα ΕΕ, ευαισθητοποιητές επαφής και αλλεργιογόνα συντηρητικών.

Αίτημα

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/allergens" \
  -H "X-API-Key: sk_live_your_api_key"

Απάντηση

json

{
  "success": true,
  "data": {
    "allergenWarnings": [
      {
        "inciName": "Linalool",
        "allergenType": "EU Fragrance Allergen",
        "severity": "moderate",
        "description": "Common fragrance allergen, mandatory labeling in EU"
      },
      {
        "inciName": "Citronellol",
        "allergenType": "EU Fragrance Allergen",
        "severity": "low",
        "description": "Fragrance component, potential sensitizer"
      }
    ],
    "totalAllergens": 2,
    "hasEuAllergens": true,
    "hasContactSensitizers": false
  }
}

GET/v1/products/:barcode/compatibility?skinType=sensitiveΣύντομα+

Ελέγξτε τη συμβατότητα με τύπο δέρματος. Υποστηριζόμενοι τύποι: λιπαρό, ξηρό, ευαίσθητο, μικτό, με τάση ακμής, κανονικό.

Αίτημα

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/compatibility?skinType=sensitive" \
  -H "X-API-Key: sk_live_your_api_key"

Απάντηση

json

{
  "success": true,
  "data": {
    "skinType": "sensitive",
    "compatible": true,
    "score": 95,
    "concerns": [],
    "recommendations": [
      "Product is fragrance-free",
      "Contains ceramides (skin barrier support)",
      "Contains niacinamide (anti-inflammatory)"
    ],
    "allSkinTypes": [
      { "skinType": "sensitive", "compatible": true, "score": 95 },
      { "skinType": "dry", "compatible": true, "score": 90 },
      { "skinType": "oily", "compatible": true, "score": 82 },
      { "skinType": "combination", "compatible": true, "score": 88 },
      { "skinType": "acne-prone", "compatible": true, "score": 78 },
      { "skinType": "normal", "compatible": true, "score": 96 }
    ]
  }
}

GET/v1/products/:barcode/pregnancyΣύντομα+

Ελέγξτε την ασφάλεια στην εγκυμοσύνη. Επισημαίνει ρετινοειδή, σαλικυλικό οξύ (BHA), υδροκινόνη και άλλα μη ασφαλή στην εγκυμοσύνη συστατικά.

Αίτημα

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/pregnancy" \
  -H "X-API-Key: sk_live_your_api_key"

Απάντηση

json

{
  "success": true,
  "data": {
    "pregnancySafe": true,
    "warnings": [],
    "flaggedIngredients": [],
    "safeAlternatives": [],
    "note": "No pregnancy-unsafe ingredients detected"
  }
}

POST/v1/analyzeΣύντομα+

Αναλύστε καθαρή λίστα INCI χωρίς γραμμωτό κωδικό. Στείλτε ονόματα συστατικών και λάβετε πλήρη ανάλυση ασφάλειας.

Αίτημα

bash

curl -X POST "https://api.inciapi.com/v1/analyze" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "inci": [
      "Aqua", "Glycerin", "Niacinamide",
      "Cetearyl Alcohol", "Phenoxyethanol",
      "Retinol", "Linalool"
    ]
  }'

Απάντηση

json

{
  "success": true,
  "data": {
    "overallSafetyScore": 78,
    "cleanBeautyScore": 72,
    "ingredients": [
      { "inciName": "Aqua", "safetyRating": 1, "isAllergen": false, "isPregnancySafe": true },
      { "inciName": "Glycerin", "safetyRating": 1, "isAllergen": false, "isPregnancySafe": true },
      { "inciName": "Niacinamide", "safetyRating": 1, "isAllergen": false, "isPregnancySafe": true },
      { "inciName": "Retinol", "safetyRating": 7, "isAllergen": false, "isPregnancySafe": false },
      { "inciName": "Linalool", "safetyRating": 5, "isAllergen": true, "isPregnancySafe": true }
    ],
    "allergenWarnings": [
      { "inciName": "Linalool", "allergenType": "EU Fragrance Allergen", "severity": "moderate" }
    ],
    "pregnancySafe": false,
    "pregnancyWarnings": ["Retinol: Vitamin A derivative, avoid during pregnancy"]
  }
}

GET/v1/ingredients/:inciNameFree+

Λάβετε λεπτομερείς πληροφορίες για ένα συγκεκριμένο συστατικό βάσει του ονόματος INCI.

Αίτημα

bash

curl -X GET "https://api.inciapi.com/v1/ingredients/Niacinamide" \
  -H "X-API-Key: sk_live_your_api_key"

Απάντηση

json

{
  "success": true,
  "data": {
    "inciName": "Niacinamide",
    "commonName": "Vitamin B3",
    "casNumber": "98-92-0",
    "safetyRating": 1,
    "functions": ["Antioxidant", "Brightening", "Anti-inflammatory"],
    "isAllergen": false,
    "isPregnancySafe": true,
    "comedogenicity": 0,
    "suitableSkinTypes": ["oily", "dry", "sensitive", "combination", "acne-prone", "normal"],
    "euStatus": "approved",
    "description": "Well-researched skincare ingredient. Helps with hyperpigmentation, fine lines, and skin barrier function."
  }
}

GET/v1/ingredients/search?q=retinolFree+

Αναζητήστε συστατικά κατά όνομα ή λειτουργία. Επιστρέφει συστατικά που ταιριάζουν με δεδομένα ασφάλειας.

Αίτημα

bash

curl -X GET "https://api.inciapi.com/v1/ingredients/search?q=retinol&limit=5" \
  -H "X-API-Key: sk_live_your_api_key"

Απάντηση

json

{
  "success": true,
  "data": {
    "ingredients": [
      {
        "inciName": "Retinol",
        "safetyRating": 7,
        "functions": ["Anti-Aging", "Cell Turnover"],
        "isAllergen": false,
        "isPregnancySafe": false
      },
      {
        "inciName": "Retinyl Palmitate",
        "safetyRating": 5,
        "functions": ["Anti-Aging", "Antioxidant"],
        "isAllergen": false,
        "isPregnancySafe": false
      }
    ],
    "total": 2,
    "page": 1,
    "pageSize": 5
  }
}

POST/v1/products/submitFree+

Υποβάλετε ένα προϊόν ομορφιάς που λείπει με τη λίστα INCI του. Τα συνεισφερόμενα προϊόντα γίνονται διαθέσιμα μετά από έλεγχο.

Αίτημα

bash

curl -X POST "https://api.inciapi.com/v1/products/submit" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "barcode": "1234567890123",
    "name": "My Beauty Serum",
    "brand": "Indie Beauty",
    "inciList": ["Aqua", "Hyaluronic Acid", "Niacinamide"]
  }'

Απάντηση

json

{
  "success": true,
  "data": {
    "submissionId": "sub_abc123",
    "status": "pending_review",
    "message": "Product submitted successfully. Will be available after moderation."
  }
}

Όρια αιτημάτων του API καλλυντικών

Τα όρια αιτημάτων του API ανάλυσης συστατικών εξαρτώνται από το επίπεδο της συνδρομής σας. Τα όρια επιστρέφονται στις κεφαλίδες απάντησης.

Επίπεδο	Όριο	Επαναφορά
Free	100 αιτήματα/ημέρα	Καθημερινά τα μεσάνυχτα UTC
Starter	5.000 αιτήματα/μήνα	Μηνιαία την ημερομηνία χρέωσης

Κεφαλίδες απάντησης:

http

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4831
X-RateLimit-Reset: 1711929600

Κωδικοί σφαλμάτων INCI API

Κωδικός	Σημασία	Ενέργεια
`400`	Λανθασμένο αίτημα	Ελέγξτε τις παραμέτρους και τη μορφή σώματος του αιτήματος
`401`	Μη εξουσιοδοτημένο	Ελέγξτε το κλειδί API στην κεφαλίδα X-API-Key
`403`	Απαγορευμένο	Το endpoint απαιτεί ανώτερο σχέδιο
`404`	Δεν βρέθηκε	Το προϊόν ή το συστατικό δεν είναι στη βάση μας
`429`	Υπέρβαση ορίου αιτημάτων	Περιμένετε τα δευτερόλεπτα του Retry-After και δοκιμάστε ξανά
`500`	Εσωτερικό σφάλμα διακομιστή	Δοκιμάστε αργότερα· επικοινωνήστε με την υποστήριξη αν επιμείνει

Μορφή απάντησης σφάλματος:

json

{
  "success": false,
  "error": {
    "code": 404,
    "message": "Product not found for barcode: 1234567890123"
  }
}