API
API
Märk och detektera filer med Markedfiles API. Finns på planerna Business och Enterprise.
API-nycklar
Ägaren av en Business- eller Enterprise-arbetsyta skapar och återkallar nycklar i arbetsytans inställningar. En nyckel visas en enda gång. Markedfile sparar ett SHA-256-hash, ett kort prefix och namnet. Hemligheten sparas inte.
En nyckel hör till precis en arbetsyta. Den fungerar bara där, med den arbetsytans plangränser. Personliga arbetsytor har inga nycklar. En medlem som inte är ägare kan varken skapa eller återkalla dem.
Om arbetsytan förlorar den aktiva Business- eller Enterprise-planen slutar alla nycklar att fungera omedelbart, också under de 30 dagar då befintliga filer fortfarande kan detekteras i appen. När du kommer tillbaka till Business eller Enterprise fungerar de nycklar som inte har återkallats igen.
Autentisering
Skicka hemligheten i headern Authorization som en Bearer-token. De här rutterna använder inte en sessionscookie. En webbläsare på en annan webbplats nekas.
Revision
Skapa, återkalla, märk och detektera skriver en revisionsrad som arbetsytans ägare kan läsa. Raden innehåller inte filen.
Fjärr-MCP
Fjärr-MCP kräver en aktiv Business- eller Enterprise-plan på arbetsytan du beviljar.
Klistra in anslutningsadressen i en klient som talar MCP över Streamable HTTP. Markedfile loggar in dig med samma konto, inklusive SSO och en autentiserare, och frågar vilken arbetsyta appen får använda. https://markedfile.com/api/mcp
Klienten registrerar sig själv, använder PKCE och får en kortlivad åtkomsttoken för den arbetsytan. Återkalla anslutningen bredvid API-nycklarna. Det finns ingen fil-CLI.
Claude
- På claude.ai öppnar du Inställningar, sedan Connectors, och lägger till en egen anslutning. I Claude Desktop öppnar du Inställningar, sedan Connectors, och lägger till en egen anslutning.
- Klistra in anslutningsadressen. Låt klienten slutföra inloggningen i webbläsaren.
- Logga in på Markedfile, med SSO eller autentiserare om kontot använder det, och välj arbetsytan.
Cursor
- Öppna Cursor-inställningarna, sedan MCP, och lägg till en server.
- Välj Streamable HTTP och klistra in anslutningsadressen.
- Slutför inloggningen i webbläsaren och välj arbetsytan. Cursor sparar förnyelsetoken lokalt.
VS Code
- Kör MCP: Add Server från kommandopaletten i VS Code, eller lägg till en HTTP-server i mcp.json.
- Sätt typen till http och URL:en till anslutningsadressen.
- Slutför inloggningen i webbläsaren och välj arbetsytan.
ChatGPT
- Öppna Inställningar och sedan Connectors i ChatGPT. Utvecklarläge kan också lägga till en egen anslutning eller app.
- Lägg till anslutningsadressen och starta inloggningen.
- Logga in på Markedfile och välj arbetsytan. Märkning och identifiering fungerar bara så länge arbetsytan är Business eller Enterprise.
Grok Bot
- Be i Grok Bot din bot i chatten att lägga till en anslutning med URL:en https://markedfile.com/api/mcp.
- Godkänn ditt Markedfile-konto på OAuth-skärmen som öppnas.
Ändpunkter
POST/api/v1/mark
Märker en fil och returnerar den märkta kopian. Brödtexten är multipart/form-data.
Autentisering
Authorization: Bearer mf_…Skicka den här headern. Det finns ingen sessionscookie. curl och andra serverklienter accepteras. En webbläsare på en annan webbplats nekas.
Parametrar
| Namn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| file | file | Ja | Filen som ska märkas. Business accepterar upp till 100 MB, 500 PDF-sidor och video upp till 10 minutter. För Enterprise är filstorlek, PDF-sidor, videolängd och storlek på videofilen Anpassat. Uppladdningsstorlek, videolängd och antal PDF-sidor följer arbetsytans plan. |
| identifier | string | Ja | 1 till 32 tecken, utan styrtecken. Det är etiketten du ser om den här kopian detekteras senare. Den skrivs inte in i filen som läsbar text. |
Förfrågan
curl -X POST https://markedfile.com/api/v1/mark \
-H "Authorization: Bearer mf_…" \
-F "file=@contract.pdf" \
-F "identifier=northwind"Svar
{
"file": "JVBERi0xLjQK…",
"mime": "application/pdf",
"name": "contract.pdf",
"kind": "pdf",
"layers": [
{
"name": "Metadata",
"detail": "Authenticated workspace reference; the identifier stays on the server",
"screenshot": "No",
"crop": "No",
"reencode": "No"
}
],
"remaining": 1
}file är de märkta byten i base64. mime, name och kind beskriver nedladdningen. layers visar de lager som användes. När planen inte har ett tak för aktiva filer är remaining antalet aktiva filer efter den här markeringen. När den har ett tak är remaining hur många nya markeringar som återstår. Business och Enterprise har inget tak för aktiva filer. Att radera en fil avslutar detekteringen.
Fel
Texten i fältet error i JSON-svaret är på engelska.
| Status | Beskrivning |
|---|---|
| 400 | Filen är tom, eller så är identifieraren tom, längre än 32 tecken eller innehåller ett styrtecken. |
| 401 | Nyckeln saknas, är återkallad eller är okänd. JSON-svaret innehåller "code": "api-key". |
| 403 | Arbetsytan har inte längre en aktiv Business- eller Enterprise-plan (svaret innehåller "code": "enterprise"), eller så skickade webbläsaren en cross-site- eller same-site-förfrågan. |
| 413 | Filen är över planens uppladdningsgräns, eller så har PDF:en fler sidor än planen tillåter. |
| 422 | Filen kunde inte bearbetas. |
| 503 | Servern är upptagen, eller så är märkning pausad för underhåll. |
| 429 | Den här nyckeln har märkt mer än 40 filer under den pågående minuten. |
Anropsgräns
40 förfrågningar per minut för den här nyckeln. Räknaren ligger i produktdatabasen och gäller fortfarande efter en omstart.
POST/api/v1/detect
Kontrollerar en fil i den här nyckelns arbetsyta. Brödtexten är multipart/form-data.
Autentisering
Authorization: Bearer mf_…Skicka den här headern. Det finns ingen sessionscookie. curl och andra serverklienter accepteras. En webbläsare på en annan webbplats nekas.
Parametrar
| Namn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| file | file | Ja | Filen som ska kontrolleras. Matchningen söks bara i den här nyckelns arbetsyta. En fil som märkts i en annan arbetsyta känns inte igen. En aktiv Business- eller Enterprise-arbetsyta kan också kontrollera en videofil. En skärmbild av en bildruta kontrolleras som en bild. |
Förfrågan
curl -X POST https://markedfile.com/api/v1/detect \
-H "Authorization: Bearer mf_…" \
-F "file=@leaked.pdf"Svar
{
"id": "northwind",
"confidence": 0.95,
"layers": [
{
"name": "Metadata",
"hit": true,
"detail": "Authenticated metadata matched this workspace",
"screenshot": "No",
"crop": "No",
"reencode": "No"
}
],
"notes": [
"Confidence is 99% for an exact file or when an authenticated mark agrees with another mark. A visual match alone stays lower, and weak bit agreement stays far from a high score."
]
}id är den identifierare du angav när kopian märktes, eller null när den här arbetsytan inte har en matchning. confidence är 99 % för en exakt fil, eller när en autentiserad markering stämmer överens med en annan markering. En matchning som bara är visuell ligger lägre. layers visar lagren, och hit är true för dem som stämde. notes beskriver vad kontrollen gjorde. En raderad fil känns inte igen.
Fel
Texten i fältet error i JSON-svaret är på engelska.
| Status | Beskrivning |
|---|---|
| 400 | Filen är tom. |
| 401 | Nyckeln saknas, är återkallad eller är okänd. JSON-svaret innehåller "code": "api-key". |
| 403 | Arbetsytan har inte längre en aktiv Business- eller Enterprise-plan (svaret innehåller "code": "enterprise"), eller så skickade webbläsaren en cross-site- eller same-site-förfrågan. |
| 413 | Filen är över planens uppladdningsgräns, eller så har PDF:en fler sidor än planen tillåter. |
| 422 | Filen kunde inte bearbetas. |
| 503 | Servern är upptagen, eller så är märkning pausad för underhåll. |
| 429 | Den här nyckeln har gjort mer än 80 detekteringar under den pågående minuten. |
Anropsgräns
80 förfrågningar per minut för den här nyckeln. Räknaren ligger i produktdatabasen och gäller fortfarande efter en omstart.