Documentazione API

Integra IndexTensor nelle tue applicazioni con la nostra API REST semplice.

Autenticazione

Tutte le richieste API richiedono autenticazione con token Bearer. Includi il tuo token API nell'intestazione Authorization:

Authorization: Bearer YOUR_API_TOKEN

Accedi per ottenere il tuo token API.

Endpoint

POST /api/links

Invia link per l'indicizzazione. I link possono essere forniti come stringa separata da punto e virgola o come array.

Corpo della richiesta

// Option 1: Semicolon-separated string
{
  "links": "https://example.com/page1;https://example.com/page2"
}

// Option 2: Array of links
{
  "links": [
    "https://example.com/page1",
    "https://example.com/page2"
  ]
}

Risposta di successo (200)

{
  "status": 200,
  "msg": "Task created successfully",
  "data": {
    "units_used": 4,
    "task_id": "1721392204",
    "links_count": 4
  }
}

Codici di errore

Codice Descrizione
400 Dati non validi (JSON malformato, URL non validi)
401 Intestazione Authorization mancante o malformata
403 Token API non valido
404 Endpoint non trovato
405 Saldo insufficiente
429 Limite di richieste superato
500 Errore interno del server

Formato risposta di errore

{
  "status": 400,
  "message": "Task wasn't created: Invalid data provided"
}

Limiti di richiesta e vincoli

  • Link max. per richiesta: 20,000
  • Lunghezza max. URL: 2,000 characters
  • Protocolli supportati: http:// and https://
  • Costo: 1 unità per link
  • Limite richieste: 60 richieste al minuto

Esempi di codice

curl -X POST https://indextensor.com/api/links \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"links": ["https://example.com/page1", "https://example.com/page2"]}'