Gå til indhold

pseudonymize.io API

Velkommen til pseudonymize.io-dokumentationen. Læg denne API i vejen for dine følsomme data, før de når eksterne systemer (såsom LLM'er, analysevarehuse eller tredjeparts supportværktøjer).

Hurtigstart

Send en anmodning til Text API om at pseudonymisere prosa.

curl -X POST https://api.pseudonymize.io/text \
  -H "Authorization: Bearer ps_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Alice Rossi disputed invoice INV-204 from [email protected]",
    "policy": "default"
  }'

Svar:

{
  "text": "PERSON_01 disputed invoice INV-204 from EMAIL_01",
  "entities": [
    { "type": "PERSON", "original": "Alice Rossi", "pseudonym": "PERSON_01" },
    { "type": "EMAIL", "original": "[email protected]", "pseudonym": "EMAIL_01" }
  ]
}

Godkendelse

Alle API-anmodninger skal inkludere din API-nøgle i "Autorisation"-headeren.

Authorization: Bearer ps_live_...

API-nøgler genereres i formatet ps_live_.... For din sikkerhed vises den komplette hemmelige nøgle kun én gang ved oprettelsen. pseudonymize.io gemmer aldrig API-nøgler i klartekst - kun en ikke-reversibel kryptografisk hash (SHA-256) og et kort identifikationspræfiks (ps_live_XXXX) bevares.

Du kan administrere dine API-nøgler i Dashboard.

Tekst API

POST https://api.pseudonymize.io/text (også tilgængelig via POST https://api.pseudonymize.io/v1/text og /api/v1/text)

Erstatter identifikatorer inde i prosa uden at udjævne teksten omkring dem.

Anmodningstekst

  • tekst (streng, påkrævet): Den tekst, der skal behandles.
  • "politik" (streng, valgfri): Den politik, der skal bruges. Standard er "standard".
  • "detect" (array, valgfrit): Specifikke enhedstyper, der skal detekteres.
{
  "text": "Call me at +39 333 1234567.",
  "detect": ["PHONE"]
}

Structured Data API

POST /api/v1/data

Pseudonymiser identifikatorfelter, mens rækker og skemaer holdes brugbare.

Anmodningstekst

  • nyttelast (objekt | array, påkrævet): JSON-strukturen, der skal behandles (kan også videregives som data).
  • "politik" (streng, valgfri): Den politik, der skal bruges. Standard er "standard".
  • "detect" (array, valgfrit): Specifikke enhedstyper, der skal detekteres.
{
  "payload": {
    "user": {
      "name": "Mario Rossi",
      "email": "[email protected]"
    }
  },
  "detect": ["PERSON", "EMAIL"]
}

Fakturering og kreditreservation

Pseudonymize.io opererer på en gennemsigtig pay-as-you-go-model:

  • 1 € pr. million målte tokens. Hver vellykket forespørgsel rundes op til blokke på 1.000 tokens (1 kredit), med et minimumsgebyr på 0,001 €.
  • reservation før flyvning: Kreditter er atomisk reserveret ved gateway-grænsen, før nyttelast når kernemotoren. Hvis en konto har utilstrækkelige kreditter, returnerer API'en '402 Payment Required' med det samme uden at videresende kundedata.
  • Automatisk refusionsgaranti: Hvis et opstrøms kernebehandlingsopkald mislykkes eller timeout, refunderes reserverede kreditter øjeblikkeligt fuldt ud.

Pseudonymer og deterministisk identitet

Pseudonymize.io bruger deterministisk identitetsbevarelse inden for en enkelt anmodning. Hvis "Alice" optræder tre gange i det samme dokument, bliver hun "PERSON_01" alle tre gange. Dette giver LLM'er mulighed for at forstå, at det er den samme person uden at vide hvem det er.

Fejl og begrænsninger

Vi bruger standard HTTP-statuskoder.

  • 200 OK: Vellykket behandling.
  • 400 Bad Request: Ugyldigt eller manglende nyttelastformat eller struktureret datadybde på mere end 32 niveauer.
  • 401 Uautoriseret: Manglende, ugyldig eller inaktiv API-nøgle.
  • 402 Betaling påkrævet: Utilstrækkelige kreditter tilbage. Blokeret ved gateway-grænsen.
  • 413 nyttelast for stor: Anmodningstekst overstiger 10 MB, eller det samlede antal strukturerede elementer overstiger 50.000 nøgler.
  • 429 Too Many Requests: Hastighedsgrænsen er overskredet (60 req/min pr. API-nøgle, 120 req/min pr. konto og IP). 'Retry-After'-overskriften angiver, hvornår du skal prøve igen.
  • 502 Bad Gateway: Kernemotor kan ikke nås eller backend-behandlingsfejl. Kreditter refunderes automatisk.
  • 504 Gateway Timeout: Kernemotor reagerede ikke inden for 30 sekunder. Kreditter refunderes automatisk.

Understøttede enheder

  • PERSON (navne)
  • ORGANISATION (virksomhedsnavne)
  • EMAIL (mailadresser)
  • PHONE (telefonnumre)
  • "LOCATION" (byer, adresser)
  • 'IP' (IPv4 og IPv6)
  • "IBAN" (bankkonti)
  • "KORT" (kredit-/betalingskort)

Sikkerhed

  • Gateway-faktureringstabeller og strukturerede anmodningsmetrikker udelukker API-anmodnings- og svarorganer. Konto-, autentificerings-, brugs-, reservations- og betalingsmetadata opbevares separat; Sletning af konto sletter ikke alle poster eller sikkerhedskopier.
  • Succesfulde svar med en Idempotency-Key bevares i proceshukommelsen i et genafspilningsvindue på fem minutter. Enhedsoplysninger kan indeholde originale identifikatorer. Motor, proxy, swap, crash-dump og backup-kontroller kræver separat verifikation; nul diskpersistens er ikke garanteret i hele behandlingskæden.
  • Se privatlivspolitikken og sikkerhedssiden for håndterings- og sletningsgrænser.