# Felo API-instelling

Stel Felo-eindpunten in Data API in voor zoeken, webinhoud, X-gegevens en presentaties, met gebruik van platformsaldo.

Felo is een van de providers in [Data API](https://openapi.felo.ai/nl/docs/data-api), met webzoeken, weblezen, X-gegevens, zoekgebaseerde antwoorden en presentaties. Vind elk Felo-eindpunt naast andere providers in de relevante Data API-categorie.

Deze eindpunten gebruiken **platformsaldo** en het voorvoegsel `/api/v1/data`. Deze gids legt authenticatie uit, je eerste verzoek en waar je de factureringsregels vindt.

Om Felo Pro-credits te gebruiken, zie de [bestaande Felo API's](https://openapi.felo.ai/nl/docs/api-reference/felo-apis.md). Platformsaldo en Pro-credits zijn gescheiden.

## Doe je eerste verzoek

1. Maak een sleutel aan in [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Controleer of vul je **platformsaldo** aan in [Console → Billing](https://openapi.felo.ai/console/billing).
3. Stel de sleutel in op je server of in je lokale shell:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

Stuur `Authorization: Bearer $FELO_API_KEY`. `X-API-Key` wordt ook geaccepteerd; kies één authenticatiemethode. JSON-verzoeken hebben `Content-Type: application/json` nodig.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is retrieval augmented generation?","count":3}'
```

HTTP 200 retourneert een `resources`-array met paginatitels, links en snippets, plus `total`. Het genereert geen gesprekantwoord; gebruik daarvoor [Chat](https://openapi.felo.ai/nl/docs/data-api/guides/felo-chat.md).

## Verken de API's

| Gids | Bewerkingen | Wat je ontvangt | Factureringseenheid |
|---|---|---|---|
| [Web zoeken](https://openapi.felo.ai/nl/docs/data-api/guides/felo-web-search.md) | Zoek het web | Paginatitels, links en snippets | Verzoek |
| [Weblezen](https://openapi.felo.ai/nl/docs/data-api/guides/felo-web-read.md) | Lees een URL | Markdown, tekst, HTML of schermafbeelding | Verzoek |
| [X-gegevens](https://openapi.felo.ai/nl/docs/data-api/guides/felo-x-data.md) | Profielen, gebruikerszoekopdracht, gebruikersberichten, berichtzoekopdracht, antwoorden | Gestructureerde gebruikers en berichten, met paginering waar ondersteund | Teruggegeven resultaat |
| [Zoekgegronde Chat](https://openapi.felo.ai/nl/docs/data-api/guides/felo-chat.md) | Beantwoord een vraag | Antwoord en webbronnen | Verzoek |
| [PPT](https://openapi.felo.ai/nl/docs/data-api/guides/felo-ppt.md) | Aanmaken, status, resultaten, export, exportstatus, verwijderen | Generatietaak en downloadbare PPTX | Gegenereerde pagina; export apart gefactureerd |
| [Facturering en fouten](https://openapi.felo.ai/nl/docs/data-api/guides/felo-billing.md) | Gedeelde integratiebegeleiding | Prijzen, afhandeling van saldo en regels voor herhalen | — |

Er zijn **14 kernbewerkingen** in deze gidsen. Als PPT-aanmaak een `stream_key` retourneert, legt de [PPT-gids](https://openapi.felo.ai/nl/docs/data-api/guides/felo-ppt.md#generatiegebeurtenissen-lezen-met-sse) ook uit hoe je generatiegebeurtenissen met SSE leest. Status- en resultaatquery's, exportstatusquery's en verwijderen brengen geen nieuwe kosten met zich mee.

## Voordat je een bestaande integratie verplaatst

Gebruik de gids voor het exacte eindpunt dat je aanroept. `/v2` vervangen door `/api/v1/data` is geen volledige migratie:

- Weblezen gebruikt `/web/read`, met één uitvoerformaat per verzoek.
- Chat retourneert `status: "ok"`; het ondersteunt alleen niet-streamende JSON.
- PPT-resultaten gebruiken **POST** `/tasks/{task_id}/historical`.
- PPT-aanmaak retourneert identificatiegegevens op de JSON-root. Sla zowel `task_id` als `ppt_business_id` op.
- Gegenereerde PPT's verlopen na zeven dagen. Exporteer en sla je bestand op vóór het verloopt.

Er is hier geen native OpenAPI-equivalent gedocumenteerd voor elke `/v2`-workflow, zoals LiveDoc CRUD, Mindmap of SuperAgent. Blijf hun [Felo API's-gidsen](https://openapi.felo.ai/nl/docs/api-reference/felo-apis.md) en Pro-creditfacturering gebruiken.

## Contract en huidige prijzen

- [Gepubliceerde OpenAPI-schema](https://openapi.felo.ai/api/v1/data/openapi.json) — velddefinities en reactieschema's.
- [OpenAPI YAML-schema](https://openapi.felo.ai/api/v1/data/openapi.yaml) — voor tools die YAML accepteren.
- [Huidige prijzen](https://openapi.felo.ai/api/v1/data/prices) — operatie-ID's, factureringseenheden en huidige tarieven.

Deze resources zijn openbaar en kunnen zonder sleutel worden gelezen. Zie [Facturering en fouten](https://openapi.felo.ai/nl/docs/data-api/guides/felo-billing.md) voordat je automatische herhalingen toevoegt.