Autentisering
Varje API-förfrågan bär en API-nyckel. En nyckel tillhör en organisation och kan bara läsa den organisationens profiler för regelefterlevnad.
Skapa en nyckel
- Öppna Inställningar → API-nycklar på plattformen och skapa en nyckel. Ge den ett namn för eget bruk.
- Välj behörighet: lämna ”Tillåt att den här nyckeln skickar in produkter till Inkorgen” omarkerad för en skrivskyddad nyckel, markera den för en
read_write-nyckel. - Om din organisation har två eller flera profiler för regelefterlevnad kan du binda nyckeln till en av dem.
- Kopiera nyckeln. Den börjar med
cfa_live_och visas bara en gång: Conphora kan inte visa den igen. Om du tappar bort den, återkalla den och skapa en ny.
Nyckellistan visar varje nyckels första tecken, namn, behörighet, profilbindning, när den skapades och när den senast användes. Att återkalla en nyckel gäller omedelbart; nyckeln får då 401 revoked_api_key. Du kan byta namn på en nyckel, men inte ändra dess behörighet eller bindning, skapa i stället en ny nyckel.
Skicka nyckeln
Skicka nyckeln i headern x-api-key. Authorization: Bearer <key> accepteras också; om båda skickas gäller x-api-key.
x-api-key: cfa_live_…
# or
Authorization: Bearer cfa_live_… Använd nyckeln bara på din server, aldrig i JavaScript i webbutiken eller webbläsaren. Webbläsare som anropar API:et direkt stöds inte.
Behörigheter
| Nyckelns behörighet | Betydelse |
|---|---|
read | GET /api/v1/products och GET /api/v1/fields. Standard. |
read_write | Allt som read kan anropa, plus POST /api/v1/intake. |
Behörigheten fastställs när nyckeln skapas.
Profilbindning
- En nyckel som är bunden till en profil får bara ange den profilen. Varje annat
profileIdger403 profile_not_allowed. - En obunden nyckel får ange vilken profil som helst i sin organisation. En profil som inte finns, eller som tillhör en annan organisation, ger
404 profile_not_found.
Var du hittar ditt profil-id
Varje slutpunkt behöver ett profileId: id:t för en profil för regelefterlevnad på plattformen. Inställningar → API-nycklar visar ett exempel på förfrågan som redan innehåller det. GET /api/v1/fields returnerar profilens id och namn, så att du kan kontrollera att du har rätt profil.
GET/api/v1/products
Slå upp produkter
Slå upp 1 till 100 produkter med din egen identifierare, med namn eller med streckkod, och få deras status för regelefterlevnad, Risk Score, nästa åtgärd och kundpaket. Det finns ingen slutpunkt som listar ett helt sortiment; använd produktflödet för det.
Nyckelns behörighet: readAbonnemang: varje abonnemang
Frågeparametrar
| Parameter | Typ | Obligatorisk | Standard | Betydelse |
|---|---|---|---|---|
profileId | string | ja | Den profil för regelefterlevnad som ska sökas i. Den måste tillhöra nyckelns organisation och stämma med nyckelns bindning om nyckeln är bunden. | |
values | string (comma-separated or repeated) | ja | De värden som ska slås upp. values=A,B,C och values=A&values=B fungerar båda; använd den upprepade formen när ett värde innehåller ett kommatecken. Värden trimmas, tomma värden tas bort och exakta dubbletter tas bort och räknas. Högst 100 efter att dubbletter har tagits bort. | |
value | string | alias | Accepteras som alias för values och slås ihop med det. | |
field | identifier | name | gtin | nej | identifier | Vad värdena är: identifier = din egen produktidentifierare (den kolumn som din import mappade som identifierare, till exempel ”SKU”), name = produktnamnet, gtin = en EAN-, UPC- eller GTIN-streckkod. Skiftlägesokänsligt. Inga andra namn accepteras. |
includeArchived | true | nej | false | Ta med arkiverade produkter. Utan den utelämnas arkiverade träffar, och ett not_found-resultat anger archivedMatchCount när arkiverade produkter matchade. |
Så fungerar matchningen
identifier: först en exakt matchning, sedan toleranta varianter, inledande nollor i värden som bara består av siffror ignoreras (”0012345” hittar ”12345”), därefter skiljetecken, därefter skiftläge. Värden som bara består av siffror och är längre än 15 siffror avvisas somvalue_precision_unsupported. Ett värde får vara högst 512 tecken.gtin: streckkoden normaliseras till den 14-siffriga GS1-formen och matchas exakt. 8, 12, 13 och 14 siffror samt skiljetecken går bra; allt annat blirnot_a_gtin.name: först det exakta namnet, sedan en sökning som bortser från skiftläge och skiljetecken.- När mer än en produkt matchar blir resultatet
ambiguousmed kandidaterna. API:et gissar aldrig: fråga igen med en kandidatsidentifier. - Med
field=identifierkommer ett värde som ännu inte är en produkt men väntar i Inkorgen tillbaka somstaged.
Svar
Svaret har results (ett per distinkt värde, i förfrågans ordning), summary och meta. Ett värde som inte hittas, är tvetydigt eller är ogiltigt är inget HTTP-fel: det kommer tillbaka inuti 200 som ett eget resultat.
Resultat per status
status | Fält | Betydelse |
|---|---|---|
found | value, matchedVia, product | Exakt en produkt matchade. |
not_found | value, archivedMatchCount (only when > 0) | Ingen träff. |
staged | value, inbox { status: pending | dismissed, receivedAt } | Väntar i Inkorgen, ännu inte bevakad, så det finns inget överensstämmelsetillstånd än. |
ambiguous | value, matches [{ id, identifier, name }] | Flera produkter matchade. |
ambiguous_truncated | value | Sökningen nådde sin gräns för kandidater. Snäva in värdet eller använd identifier. Kan inte inträffa med field=gtin. |
invalid_value | value, reason: empty_value | value_too_long | value_precision_unsupported | not_a_gtin | Värdet kan inte slås upp. |
matchedVia talar om hur en found-produkt matchade: identifier_exact, identifier_numeric_zerostrip, identifier_numeric_roundtrip, identifier_alnum, identifier_normalized, name_exact, name_normalized, gtin_exact, gtin_canonical.
summary räknar resultaten: requested, found, notFound, staged, ambiguous, invalid, duplicatesDropped. ambiguous omfattar ambiguous_truncated; duplicatesDropped visas bara när värden har tagits bort.
meta innehåller resolvedField (det fält som användes), identifierField (vad din import kallade identifierarkolumnen, för information) och apiVersion.
Produktobjektet
Varje nyckel finns alltid med, i den här ordningen. Kolumnerna i ditt importerade kalkylblad returneras aldrig av API:et.
| Fält | Typ | Betydelse |
|---|---|---|
id | string | Conphoras stabila produkt-id. Inte ett uppslagsvärde. |
profileId | string | Profilen för regelefterlevnad. |
identifier | string | Din produktidentifierare. |
identifierField | string | null | Din imports namn på identifierarkolumnen. |
gtin | string | null | Streckkoden som 14 siffror, utfylld med nollor; null när importen inte hade någon giltig streckkod. |
name | string | Produktnamnet. |
imageUrl | string | null | Bild-URL:en från din import. |
hsCode | string | null | HS-koden / varukoden. |
archived | boolean | true för en arkiverad produkt. |
status.classification | in_progress | awaiting_clarification | completed | failed | null | Var klassificeringen står; null när den inte har börjat. |
status.compliance | not_checked | compliant | requires_compliance | Överensstämmelsetillståndet. Aldrig null: not_checked när produkten aldrig har utvärderats. |
compliance.lastCheckedAt | number (ms epoch) | null | När produkten senast utvärderades. |
compliance.summary.matchedCount | number | Hur många krav som gäller. |
compliance.summary.fulfilledCount | number | Hur många av dem som är uppfyllda. |
compliance.progress | { compliance, attributes, documents }: { filled, total } | Par av ifyllt / totalt för krav, produktdata och dokument; {0, 0} när det inte finns några. |
compliance.matchedRegulations[] | { id, shortName, fullTitle | null, eurLexUrl | null } | De förordningar som gäller. |
compliance.missingRequirements[] | { key, kind, regulation, requirementId, domain | null, label, deferred } | De öppna kraven. kind är doc, attr, symbol eller checkpoint. deferred = markerat ”Jag har inte de här uppgifterna ännu”; räknas ändå som saknat. |
riskScore | integer 0–100 | null | Conphora Risk Score: en prioritering, inte en dom. Null tills produkten har poängsatts. |
riskBand | low | watch | high | critical | null | Poängens nivå. Null när det inte finns någon poäng. |
nextAction | object | null | Det enda nästa som ska göras. Null när det inte finns någon poäng eller inget att göra. |
nextAction.kind | string (see the list below) | Vad som ska göras. |
nextAction.who | you | supplier | Vems tur det är. |
nextAction.href | string (relative platform path) | En relativ sökväg på plattformen som öppnar åtgärden. Öppna den på plattformens värd. |
nextAction.after | number | Risk Score när åtgärden är gjord. |
customerPack | object | null | Kundpaketet med alla tio poster och deras status, din arbetsvy, densamma som på produktsidan. Ifyllt i självbetjäningsabonnemanget; null i gratiskontrollen, och null när profilen ännu inte har några företagsuppgifter. |
customerPack.ready | integer 0–10 | Hur många av de tio posterna som är klara. |
customerPack.total | 10 | Alltid 10. |
customerPack.items | object: item id → ready | missing | waiting | not-needed | Varje posts status, i paketets ordning. not-needed = ingen del av posten gäller produkten. |
customerPack.url | string | null | Hela länken till produktens publika kundpaketssida: produktens egen stående länk (samma som exporten och flödet bär). null när det inte finns någon, och i gratiskontrollen. |
customerPack.path | string | null | Samma länk som en sökväg, /p/<token>, på dokumentvärden. |
createdAt | number (ms epoch) | När produkten skapades i Conphora. |
updatedAt | number (ms epoch) | När produkten senast ändrades. |
Risk Score, nivå och nästa åtgärd
riskScore, riskBand och nextAction är desamma i varje abonnemang. Poängen anger vilka produkter som ska åtgärdas först; den kallar aldrig en produkt överensstämmande eller icke-överensstämmande. En känd bristande överensstämmelse placerar produkten i critical oavsett poäng.
riskBand | Poäng | Betydelse |
|---|---|---|
low | 0-24 | Bevakas, inget att göra |
watch | 25-49 | Något är på väg |
high | 50-74 | Åtgärda den här månaden |
critical | 75-100 | Agera nu |
nextAction.kind är en av en fast uppsättning: clearNonCompliance, reEvaluate, uploadDocument, confirmRequirement, fillProductData, askSupplier, issueDeclaration, runProcedure, registerProduct, assembleTechnicalFile, renewDocument, reconfirmRuleChange, meetKeyDate, submitReport, chaseSupplier, reviewSupplierAnswer.
Poster i kundpaketet
Nycklarna i customerPack.items, i paketets ordning. Varje status är ready, missing, waiting eller not-needed. identity, contact, declaration, standards-tests, safety-information, instructions, substances, packaging-epr, technical-file, recall-contact.
API:et behåller alla tio statusar. Den publika paketsida som din kund öppnar visar din kund två grupper: identity, contact, declaration, safety-information och instructions från start, räknade som ”n av 5 klara för listning”; standards-tests, substances, packaging-epr och recall-contact på begäran, var och en med en knapp som frågar dig; technical-file finns inte på sidan.
Exempel på förfrågan
curl "https://documents.conphora.com/api/v1/products?profileId=jd7f3k2m9q8x4w1v6t5r0n3b2c&field=identifier&values=NB-1042,NB-2210,NB-9999" \
-H "x-api-key: cfa_live_…" Exempel på svar
{
"results": [
{
"value": "NB-1042",
"status": "found",
"matchedVia": "identifier_exact",
"product": {
"id": "k57bq2x9w3m8r1t6v4c0n5p7ds",
"profileId": "jd7f3k2m9q8x4w1v6t5r0n3b2c",
"identifier": "NB-1042",
"identifierField": "SKU",
"gtin": "05790000123452",
"name": "Birch stacking rings, 7 pieces",
"imageUrl": null,
"hsCode": "9503.00",
"archived": false,
"status": {
"classification": "completed",
"compliance": "requires_compliance"
},
"compliance": {
"lastCheckedAt": 1793260800000,
"summary": {
"matchedCount": 14,
"fulfilledCount": 9
},
"progress": {
"compliance": {
"filled": 9,
"total": 14
},
"attributes": {
"filled": 6,
"total": 8
},
"documents": {
"filled": 3,
"total": 5
}
},
"matchedRegulations": [
{
"id": "toy-safety",
"shortName": "TSR",
"fullTitle": "Toy Safety Regulation",
"eurLexUrl": null
},
{
"id": "gpsr",
"shortName": "GPSR",
"fullTitle": "General Product Safety Regulation",
"eurLexUrl": null
}
],
"missingRequirements": [
{
"key": "doc:TSR:eu-declaration-of-conformity",
"kind": "doc",
"regulation": "TSR",
"requirementId": "eu-declaration-of-conformity",
"domain": "documentation",
"label": "EU declaration of conformity",
"deferred": false
}
]
},
"riskScore": 58,
"riskBand": "high",
"nextAction": {
"kind": "issueDeclaration",
"who": "you",
"href": "/nordbirk/products/k57bq2x9w3m8r1t6v4c0n5p7ds?step=declaration",
"after": 41
},
"customerPack": {
"ready": 6,
"total": 10,
"items": {
"identity": "ready",
"contact": "ready",
"declaration": "missing",
"standards-tests": "ready",
"safety-information": "ready",
"instructions": "waiting",
"substances": "ready",
"packaging-epr": "missing",
"technical-file": "ready",
"recall-contact": "missing"
},
"url": null,
"path": null
},
"createdAt": 1790582400000,
"updatedAt": 1793260800000
}
},
{
"value": "NB-2210",
"status": "staged",
"inbox": {
"status": "pending",
"receivedAt": 1793174400000
}
},
{
"value": "NB-9999",
"status": "not_found"
}
],
"summary": {
"requested": 3,
"found": 1,
"notFound": 1,
"staged": 1,
"ambiguous": 0,
"invalid": 0
},
"meta": {
"resolvedField": "identifier",
"identifierField": "SKU",
"apiVersion": "2026-09-10"
}
} Fel
400 missing_parameter, 400 too_many_values, 400 unknown_field, 400 invalid_profile_id, 401 missing_api_key, 401 invalid_api_key, 401 revoked_api_key, 403 profile_not_allowed, 404 profile_not_found, 413 response_too_large, 429 rate_limited — Fel
GET/api/v1/fields
Ta reda på fält
Visar vilka `field`-värden som uppslaget accepterar och vad profilens import kallar sin identifierarkolumn. Valfri nyckelbehörighet; samma profilregler som ovan.
Nyckelns behörighet: readAbonnemang: varje abonnemang
Frågeparametrar
| Parameter | Typ | Obligatorisk | Betydelse |
|---|---|---|---|
profileId | string | ja | Profilen för regelefterlevnad. |
Svar
| Fält | Typ | Betydelse |
|---|---|---|
profile.id | string | Profil-id:t. |
profile.name | string | Profilens namn. |
identifierField | string | null | Vad den senaste importen kallar identifierarkolumnen. |
supportedFields | string[] | Alltid ["identifier", "name", "gtin"]. |
meta.apiVersion | string | API-versionen. |
Exempel på förfrågan
curl "https://documents.conphora.com/api/v1/fields?profileId=jd7f3k2m9q8x4w1v6t5r0n3b2c" \
-H "x-api-key: cfa_live_…" Exempel på svar
{
"profile": {
"id": "jd7f3k2m9q8x4w1v6t5r0n3b2c",
"name": "Nordbirk ApS"
},
"identifierField": "SKU",
"supportedFields": [
"identifier",
"name",
"gtin"
],
"meta": {
"apiVersion": "2026-09-10"
}
} Fel
400 missing_parameter, 400 invalid_profile_id, 401 missing_api_key, 401 invalid_api_key, 401 revoked_api_key, 403 profile_not_allowed, 404 profile_not_found, 429 rate_limited — Fel
POST/api/v1/intake
Skicka in produkter
Skicka in upp till 100 produkter per förfrågan till en profils Inkorg. Nya identifierare väntar i Inkorgen tills någon i ditt team flyttar dem till bevakning; en produkt vars identifierare matchar en befintlig produkt uppdaterar den produkten på plats. Själva inskickningen debiteras inte, och att skicka samma produkt igen ändrar ingenting.
Nyckelns behörighet: read_writeAbonnemang: självbetjäningsabonnemang
Kräver en nyckel med behörigheten read_write (annars 403 insufficient_scope) och självbetjäningsabonnemanget (annars 403 membership_required). Innehållet är JSON, högst 1 MB.
Förfrågans innehåll
| Fält | Typ | Obligatorisk | Betydelse |
|---|---|---|---|
profileId | string | ja | Den profil för regelefterlevnad som ska ta emot produkterna. |
products | array (1–100) | ja | Produkterna. En senare dubblett av ett uniqueId tas bort (den första gäller) och räknas. |
products[].uniqueId | string | number | ja | Din produktidentifierare, högst 512 tecken efter trimning. |
products[].name | string | ja | Produktnamnet (högst 10 000 tecken). |
products[].description | string | ja | Produktbeskrivningen. Conphoras klassificering behöver den. |
products[].gtin | string | number | nej | Streckkoden. När den finns måste den vara en giltig GTIN, annars avvisas raden med not_a_gtin. |
products[].imageUrl | string | nej | En bild-URL. |
products[].attributes | object of string | number | boolean | null | nej | Alla andra kolumner, som ett platt objekt. Högst 300 nycklar på högst 200 tecken; långa strängar kortas till 10 000 tecken; nästlade värden avvisas. En nyckel som heter som ett toppnivåfält skrivs över av toppnivåvärdet. |
products[].hints | object: category → attribute keys | nej | Talar om för klassificeringen vilka attribut som beskriver vad. Varje nyckel måste finnas i attributes och får förekomma i endast en kategori. |
Tipskategorier: productDescription, material, productCategory, packaging, supplierInfo, other.
En profils Inkorg rymmer högst 50 000 väntande rader; en inskickning utöver det ger 429 intake_full.
Svar
results kommer i förfrågans ordning, ett per produkt: uniqueId, status, samt intakeId, productId eller errors där de är aktuella.
Resultat per status
status | Betydelse |
|---|---|
staged | Ny: väntar nu i Inkorgen (intakeId). |
refreshed | Väntade redan; innehållet uppdaterades. |
resurfaced | Hade avfärdats från Inkorgen och kom tillbaka som väntande eftersom innehållet ändrades. |
unchanged | Redan känd, och ingenting ändrades. |
updated | Matchade en aktiv produkt, som uppdaterades (productId). |
updated_idle | Matchade en arkiverad produkt, som uppdaterades på plats och förblir arkiverad. |
invalid | Raden avvisades: errors listar { field, reason }. |
Orsaker till invalid: required, invalid_type, too_long, not_a_gtin, too_many_attributes, unknown_category, reserved_key, unknown_attribute, assigned_twice.
summary räknar resultaten: received, staged, refreshed, unchanged, updated, updatedIdle, archivedSkipped, invalid, duplicatesDropped. received räknar produkter efter att dubbletter har tagits bort; refreshed omfattar resurfaced; archivedSkipped är alltid 0 och finns kvar för äldre klienter.
Om en förfrågan misslyckas halvvägs med 500 intake_failed sparades produkterna före index completed och results listar dem; skicka resten igen.
Exempel på förfrågan
curl -X POST "https://documents.conphora.com/api/v1/intake" \
-H "x-api-key: cfa_live_…" \
-H "Content-Type: application/json" \
-d '{
"profileId": "jd7f3k2m9q8x4w1v6t5r0n3b2c",
"products": [
{
"uniqueId": "NB-3001",
"name": "Oak pull-along duck",
"description": "Wooden pull toy for children from 12 months, water-based paint.",
"gtin": "5790000123469",
"attributes": {
"Material": "Oak, water-based paint",
"Age": "12m+"
},
"hints": {
"material": [
"Material"
]
}
},
{
"uniqueId": "NB-3002",
"name": "Felt play mat"
}
]
}' Exempel på svar
{
"results": [
{
"uniqueId": "NB-3001",
"status": "staged",
"intakeId": "m12x7c4v9b2n8q5w3e6r1t0y4u"
},
{
"uniqueId": "NB-3002",
"status": "invalid",
"errors": [
{
"field": "description",
"reason": "required"
}
]
}
],
"summary": {
"received": 2,
"staged": 1,
"refreshed": 0,
"unchanged": 0,
"updated": 0,
"updatedIdle": 0,
"archivedSkipped": 0,
"invalid": 1
},
"meta": {
"apiVersion": "2026-09-10"
}
} Fel
400 missing_parameter, 400 invalid_profile_id, 400 invalid_json, 400 invalid_payload, 400 too_many_products, 401 missing_api_key, 401 invalid_api_key, 401 revoked_api_key, 403 insufficient_scope, 403 profile_not_allowed, 403 membership_required, 404 profile_not_found, 413 payload_too_large, 429 rate_limited, 429 intake_full, 500 intake_failed, 503 rate_limiter_unavailable — Fel
GET/feed/{token}
Produktflöde
Ett produktflöde är en fast URL som alltid levererar de senaste uppgifterna för en profils aktiva produkter, som JSON, CSV eller Excel. Det behöver ingen API-nyckel: token i URL:en är behörigheten, så den som har URL:en kan läsa flödet tills du återkallar det.
Skapa och återkalla en flödeslänk
- Öppna Tabeller på plattformen, välj ”Flöde” i verktygsfältet och skapa en länk. Länken tar de kolumner som är synliga i tabellen i det ögonblicket; du kan ändra dess kolumner och ge den en etikett senare.
- Varje länk har kopieringsknappar för CSV, XLSX och JSON.
- Att återkalla en länk gäller omedelbart: nästa förfrågan får
404.
Flödeslänkar finns i varje abonnemang. De två kolumnerna för kundpaket är ifyllda endast i självbetjäningsabonnemanget.
Frågeparametrar
| Parameter | Betydelse |
|---|---|
format | Utdataformatet: json (standard), csv eller xlsx. |
shared | Behåll bara de produkter som har en öppen delningslänk för kundpaket med den här etiketten (din kunds namn, skiftlägesokänsligt), och peka varje rads ”Customer pack URL” mot den delningen i stället för produktens stående länk. Det ger en kund ett kundpaket på sortimentsnivå. Tomt i gratiskontrollen, som inte har några delningslänkar. |
Format
format | Betydelse |
|---|---|
json | En array av objekt, en nyckel per kolumnnamn. Strukturerade kolumner är arrayer och objekt, datum är ISO 8601, saknade värden är null. |
csv | UTF-8 med en rubrikrad med kolumnnamn, kommaseparerad. Celler med flera värden sammanfogas med radbrytningar. |
xlsx | Ett blad med samma celler som CSV-filen. |
Kolumner
En länk levererar de kolumner som valts för den, i den här ordningen: först dina egna importerade kolumner under sina egna namn (identifierare, namn, därefter resten), till skillnad från API:et innehåller flödet dina importerade data, därefter Conphoras kolumner:
| Kolumn | Betydelse |
|---|---|
EAN / GTIN | Den 14-siffriga streckkoden. |
Commodity Code | HS-koden. |
Matched Regulations | Kortnamnen på de förordningar som gäller. |
Markets | Marknaderna, med landskod och namn. |
EN Standards | De rekommenderade standarderna (visas på plattformen som ”Recommended Standards”; flödet behåller det här namnet). |
Tested for | Vad dina dokument visar att produkten har provats för. |
Attributes | Produktdata, etikett, värde och enhet. |
Attributes on Product | De attribut som anges på produkten. |
Attributes on Packaging | De attribut som anges på förpackningen. |
Attributes in Documentation | De attribut som anges i dokumentationen. |
Attributes in Online Listing | De attribut som anges i onlineannonsen. |
Document Links | En post per dokument: titel, typ, områden för regelefterlevnad och en länk till dokumentet. |
Customer pack | ”6 av 10 klara” och status för var och en av de tio posterna (flödet behåller alla tio; paketsidan visar fem från start och fyra på begäran) (i JSON: { ready, total, items }). Tomt, eller null i JSON, i gratiskontrollen. |
Customer pack URL | Länken till produktens kundpaketssida: produktens egen stående länk, eller den delning som tillhör shared-kunden när du filtrerar. Tomt i gratiskontrollen. |
Created | När produkten skapades. |
Updated | När produkten senast ändrades. |
Flödet har ingen kolumn för status för regelefterlevnad, Risk Score eller nästa åtgärd; de finns i API:et. Flödet har inget versionsnummer: dess kolumnnamn är dess kontrakt, och dina importerade kolumnnamn följer dina importer.
Exempel på förfrågan
curl "https://documents.conphora.com/feed/<your-feed-token>?format=json" Exempel på svar
[
{
"SKU": "NB-1042",
"Product name": "Birch stacking rings, 7 pieces",
"Colour": "Natural",
"EAN / GTIN": "05790000123452",
"Commodity Code": "9503.00",
"Matched Regulations": [
"TSR",
"GPSR"
],
"Markets": [
{
"countryCode": "DK",
"name": "Denmark"
},
{
"countryCode": "SE",
"name": "Sweden"
}
],
"Customer pack": {
"ready": 6,
"total": 10,
"items": {
"identity": "ready",
"contact": "ready",
"declaration": "missing",
"standards-tests": "ready",
"safety-information": "ready",
"instructions": "waiting",
"substances": "ready",
"packaging-epr": "missing",
"technical-file": "ready",
"recall-contact": "missing"
}
},
"Customer pack URL": null,
"Created": "2026-09-29T08:00:00.000Z",
"Updated": "2026-10-29T08:00:00.000Z"
}
] Flödesfel är oformaterad text, inte JSON: 404 när länken är ogiltig eller återkallad, 413 när exporten skulle bli för stor (CSV är det mest kompakta formatet).
Hastighetsgränser
Läsning och skrivning har separata gränser, var och en räknad per API-nyckel och per organisation (alla nycklar tillsammans). En förfrågan måste klara båda. Siffrorna är dagens värden, satta för att stoppa skenande skript, inte för att strypa normal användning.
| Anrop | Räknas per | Frekvens | Burst |
|---|---|---|---|
GET /api/v1/products, GET /api/v1/fields | API-nyckel | 600 / minut | 120 |
GET /api/v1/products, GET /api/v1/fields | organisation | 3,000 / minut | 500 |
POST /api/v1/intake | API-nyckel | 120 / minut | 30 |
POST /api/v1/intake | organisation | 600 / minut | 100 |
Över gränsen svarar API:et med 429 och felet rate_limited, ett fält retryAfterMs och en header Retry-After i sekunder (minst 1). Vänta så länge innan du försöker igen.
HTTP/1.1 429 Too Many Requests
Retry-After: 2
{
"error": "rate_limited",
"message": "Too many requests. Slow down and retry.",
"retryAfterMs": 1800
} Fel
Varje fel från en `/api/v1`-slutpunkt är JSON med formen `{ "error": "<code>", "message": "<text>" }`, ibland med extra fält, skickat med HTTP-statusen. Styr logiken efter `error`, aldrig efter `message`. En felaktig metod eller en okänd sökväg tillhör inte de här slutpunkterna och svarar inte i den här formen.
| Status | error | När | Extra fält | Slutpunkter |
|---|---|---|---|---|
| 400 | missing_parameter | Inget profileId, inga värden, eller ingen products / en tom array. | alla | |
| 400 | too_many_values | Fler än 100 distinkta värden. | maxValues | GET /api/v1/products |
| 400 | unknown_field | field är inte identifier, name eller gtin. | supportedFields | GET /api/v1/products |
| 400 | invalid_profile_id | profileId är inte ett välformat id. | alla | |
| 400 | invalid_json | Innehållet är inte JSON. | POST /api/v1/intake | |
| 400 | invalid_payload | Innehållet är inte ett objekt, eller products är inte en array. | POST /api/v1/intake | |
| 400 | too_many_products | Fler än 100 produkter. | maxProducts | POST /api/v1/intake |
| 401 | missing_api_key | Ingen nyckel skickades. | alla | |
| 401 | invalid_api_key | Nyckeln är okänd. | alla | |
| 401 | revoked_api_key | Nyckeln har återkallats. | alla | |
| 403 | insufficient_scope | En read-nyckel anropade inskickningen. | POST /api/v1/intake | |
| 403 | profile_not_allowed | Nyckeln är bunden till en annan profil. | alla | |
| 403 | membership_required | Organisationen har inget aktivt självbetjäningsabonnemang. | POST /api/v1/intake | |
| 404 | profile_not_found | Profilen finns inte eller tillhör en annan organisation. | alla | |
| 413 | response_too_large | Resultatet skulle bli större än cirka 18 MB. Be om färre värden. | GET /api/v1/products | |
| 413 | payload_too_large | Innehållet är större än 1 MB. | maxBodyBytes | POST /api/v1/intake |
| 429 | rate_limited | En hastighetsgräns nåddes. | retryAfterMs + Retry-After header | alla |
| 429 | intake_full | Profilens Inkorg skulle passera 50 000 väntande rader. | POST /api/v1/intake | |
| 500 | intake_failed | Förfrågan misslyckades halvvägs; produkterna före index completed sparades. | completed, results | POST /api/v1/intake |
| 503 | rate_limiter_unavailable | Skrivning är tillfälligt otillgänglig. Försök igen efter headern Retry-After. | Retry-After header | POST /api/v1/intake |
Versionshantering
- Versionen finns i sökvägen (
/api/v1) och i varje svarsinnehåll sommeta.apiVersion. - Fält kan läggas till när som helst. Bygg klienter som ignorerar fält de inte känner till.
- En ändring som bryter kompatibiliteten ändrar versionen.
meta.apiVersion: "2026-09-10"