Integratori și dezvoltatori

O cerere reală, răspunsul ei real

Nicio captură desenată: iată un apel către un endpoint public al API-ului, fără cheie și fără cont, și JSON-LD-ul pe care îl returnează. Copiați comanda și veți obține același răspuns.

curl -s https://veratrace.eu/api/dfc/companies/000000001-vitrine-producteur

{
  "@context": [
    "http://www.datafoodconsortium.org/ontologies/context.json",
    {
      "vrt": "https://veratrace.eu/ontology#",
      "skos": "http://www.w3.org/2004/02/skos/core#",
      "dfc-f": "http://w3id.org/dfc/taxonomies/facets.rdf#"
    }
  ],
  "@graph": [
    {
      "@id": "https://veratrace.eu/dfc/enterprises/000000001-vitrine-producteur",
      "@type": "dfc-b:Enterprise",
      "dfc-b:name": "LES JARDINS DE LA VALLEE CLAIRE (exemple)",
      "dfc-b:hasDescription": "Exploitation maraîchère conduite en agriculture biologique depuis 2011, sur 14 hectares répartis entre plein champ et abris froids. Une quarantaine d'espèces cultivées sur l'année, dont les cœurs de gamme melon, tomate de plein champ et courges d'hiver. Livraison en circuits courts (magasins de producteurs, cuisines centrales) et vente au carreau du marché de gros.",
      "dfc-b:hasAddress": {
        "@id": "https://veratrace.eu/dfc/enterprises/000000001-vitrine-producteur/address",
        "@type": "dfc-b:Address",
        "dfc-b:hasCity": "Cavaillon",
        "dfc-b:hasPostalCode": "84300",
        "dfc-b:hasCountry": "France",
        "dfc-b:region": "Provence-Alpes-Côte d'Azur"
      },
      "vrt:siret": "00000000100016",
      "vrt:legalForm": "Autre personne morale de droit privé",
      "dfc-b:hasCertification": [
        {
          "@id": "https://veratrace.eu/dfc/vocabulary/certification/ab",
          "@type": "skos:Concept",
          "skos:prefLabel": "AB — Agriculture biologique — certifié par un organisme agréé",
          "vrt:officialFacet": false,
          "vrt:certifiedBy": "Ecocert"
        },
        {
          "@id": "http://w3id.org/dfc/taxonomies/facets.rdf#HEV",
          "@type": "skos:Concept",
          "skos:prefLabel": "HVE — Haute valeur environnementale, niveau 3",
          "vrt:officialFacet": true
        }
      ]
    }
  ]
}

Întreprinderea interogată este o fișă exemplu din director: fictivă, cu un SIREN din intervalul 000, pe care INSEE nu îl atribuie. Cererea și răspunsul, în schimb, sunt reale — export DFC (Data Food Consortium) al unei fișe.

Acest răspuns este produs de același cod ca endpointul, iar un test îl validează față de schema OpenAPI publicată: dacă ar înceta să se conformeze, integrarea noastră continuă ar eșua.

Consola pentru dezvoltatori — chei și coteReferința API-ului