Använd Clevera REST API

Cleveras REST API låter dina egna skript och tjänster göra det som en agent kan göra via MCP: läsa ditt bibliotek, begära videor och artiklar, exportera videor, arbeta på dokumentationssajter och följa jobb. Den här artikeln täcker bas-URL, autentisering, begäranflödet för betalt arbete, fel och hastighetsbegränsningar.

Grunderna#

Kontrollera en token med GET /docs/me:

curl -H "Authorization: Bearer $CLEVERA_TOKEN" \
     -H "Accept: application/json" \
     https://app.clevera.ai/api/v1/docs/me

Svaret anger vem token agerar som: token-namn och utgångsdatum, personen och dennes nuvarande roll, arbetsytan, sajterna i omfattningen och de behörigheter som fungerar just nu (token-behörigheterna begränsade till personens nuvarande roll). Anropa detta först när ett anrop nekas.

Slutpunkter#

Varje slutpunkt kräver den visade behörigheten. Att anropa en utan den returnerar 403 forbidden_ability. Se Agentbehörigheter.

Bibliotek och material#

Videor och artiklar#

Jobb och krediter#

Dokumentationssajter#

Mer om agenter och dokumentationssajter: Anslut AI-agenter till dina dokumentationssajter.

Begär betalt arbete#

Arbete som kostar krediter kräver alltid en offert först, sedan start:

1. Begär offert. POST /videos/quotes (eller /clips/quotes) med vad du vill ha. Svaret innehåller en quote_id och kreditintervallet. En offert är giltig i 15 minuter och kan användas en gång.
2. Testkör valfritt. Skicka starten med "dry_run": true för att se om det skulle starta, kräva godkännande eller blockeras. Ingenting skrivs.
3. Starta. POST /videos med quote_id och en Idempotency-Key-header. Svaret är 202 med ett jobb.
4. Följ. GET /jobs/{job}/wait tills jobbets status ändras, eller lyssna efter webhooks.

curl -X POST https://app.clevera.ai/api/v1/videos/quotes \
  -H "Authorization: Bearer $CLEVERA_TOKEN" -H "Content-Type: application/json" \
  -d '{"type": "how_to", "recording_id": "<recording id>", "language": "en-US"}'

curl -X POST https://app.clevera.ai/api/v1/videos \
  -H "Authorization: Bearer $CLEVERA_TOKEN" -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f6c1a2e-8d4b-4f7a-9c1e-2b5d7e9f0a13" \
  -d '{"quote_id": "<quote id>"}'

Jobbstatusar:

Huruvida en start körs direkt eller väntar på en person beror på token-utgiftstak och inställningen Godkänn automatiskt nedan. Se Kontrollera agentutgifter och godkännanden.

Försök igen och idempotens#

Skicka en Idempotency-Key-header (en ny UUID per åtgärd) vid varje skapande och start. Om nätverket bryts och du försöker igen med samma nyckel och body, får du det första svaret tillbaka istället för en ny video. Nycklar sparas i 24 timmar.

Fel#

Varje fel har samma form, med ett meddelande som anger vad du ska göra härnäst:

{
  "error": {
    "code": "forbidden_ability",
    "message": "This token lacks the videos:create ability. Ask the workspace member who owns it for a token that has it.",
    "details": { "ability": "videos:create" }
  },
  "request_id": "req_example"
}

Inkludera request_id när du kontaktar supporten.

Varje meddelande, med lösningen: Åtgärda agent- och API-fel.

Hastighetsbegränsningar#

Ett 429-svar har en Retry-After-header och retry_after (sekunder) i bodyn. Vänta så länge innan du försöker igen. Läsningar, offerter och statuskontroller kostar inga krediter.

Relaterat#