Das ist die API Dokumentation für die Brief-Edition der Familie Engels. Für den Quellcode besuchen Sie bitte die entsprechende Dokumentation auf GitHub.

Engels Archive API Documentation

Letters

[GET] /api/v1/letters

Get a list of all letters.

Example Response

{
  "success": true,
  "code": 200,
  "data": {
    "letter": [
      {
        "number": "067",
        "version": "0.2.01",
        "editor": "Jana Wernick",
        "name": "fe067.xml",
        "date": "1813-05-31",
        "#text": "Johann Caspar Engels sen., Barmen, an Friedrich Engels sen., Frankfurt am Main, 31. Mai 1813, Montag (Brief)",
        "sent": {
          "person": {
            "ref": "#pers.partic.engels-johann-caspar-II"
          },
          "place": {
            "ref": "#place.wuppertal-barmen"
          }
        },
        "received": {
          "person": {
            "ref": "#pers.partic.engels-friedrich-senior"
          },
          "place": {
            "ref": "#place.frankfurt"
          }
        },
        "mentioned": {
          "persons": {
            "person": [
              {
                "ref": "#pers.partic.engels-johann-caspar-II"
              },
              {
                "ref": "#pers.partic.engels-friedrich-senior"
              },
              {
                "ref": "#pers.partic.eckhardt-johann-friedrich-sen"
              },
              {
                "ref": "#pers.partic.osberghaus"
              },
              {
                "ref": "#pers.partic.wieler"
              },
              {
                "ref": "#pers.partic.friedrichs"
              },
              {
                "ref": "#pers.partic.gebauer"
              },
              {
                "ref": "#pers.partic.engels-benjamin"
              }
            ]
          },
          "places": {
            "place": [
              {
                "ref": "#place.wuppertal-barmen"
              },
              {
                "ref": "#place.wetzlar"
              },
              {
                "ref": "#place.frankfurt"
              },
              {
                "ref": "#place.baenderath"
              },
              {
                "ref": "#place.frankfurt-oder"
              }
            ]
          },
          "organisations": {
            "place": {
              "ref": "#org.lange-gottlob"
            }
          }
        }
      },
      [...]
    ]
  }
}

[GET] /api/v1/letters/014

Get the details of a single letter.

Example Response

{
  "success": true,
  "code": 200,
  "data": {
    "engels:doctype": "letter",
    "xml:id": "fe.002",
    "#text": [
      [...]
    ],
    "teiHeader": {
      [...]
    },
    "text": {
      [...]
    }
  },
  "html": "<?xml version=\"1.0\"?>\n<letter>\n                <br xmlns=\"http://www.w3.org/1999/xhtml\"/>\n                \n                    <div xmlns=\"http://www.w3.org/1999/xhtml\" class=\"tei_p\" data-wd=\"transform: rotate(270deg);\">\n        <span class=\"wd ed\">[Schreibrichtung: transform: rotate(270deg);]</span>\n                        An HerrnHerrn <span class=\"tei_persName\">\n            <a href=\"https://familie-engels-briefe.uni-wuppertal.de:8443/regPers#pers.partic.engels-johann-caspar-II\" target=\"_blank\">Caspar Engels</a>[...]"
}

Register

We provide the register xml files as JSON strings, because they are converted in the frontend with the help of the xml-js library, which can convert xml to json in compact or non-compact mode.

[GET] /api/v1/persons

Get a list of all persons.

Example Response

"<?xml version=\"1.0\"?>\n<persons>\n    <person xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"pers.partic.klein-jakobine\" n=\"unified\">\n                        <idno type=\"GND\"/>\n                        <persName type=\"reg\">\n                            <surname>Klein</surname>\n                            <forename>Jacobine</forename>\n                        </persName>\n                        <persName type=\"full\">\n                            <surname>Klein</surname>\n                            <forename>Anna</forename>\n                            <forename>Margareta</forename>\n                            <forename>Johanna</forename>\n                            <forename>Jacobine</forename>\n                        </persName>\n                        <sex value=\"F\"/>\n                        <birth>\n                            <date when=\"1753\"/>\n                        </birth>\n                        <death>\n                            <date when=\"1795\"/>\n                        </death>\n                        <note type=\"relation\">Schwester von <persName ref=\"#pers.partic.hoffmann-clara\">Clara Hoffmann</persName>, geb. Klein, in Düsseldorf. Betrieb mit ihrer älteren Schwester Charlotte Klein in Düsseldorf ein Mädchenpensionat. Die Collenbuschianerin war befreundet mit <persName ref=\"#pers.partic.siebel-henriette\">Henriette Siebel</persName>.</note>\n..."

[GET] /api/v1/places

Get a list of all places.

Example Response

"<?xml version=\"1.0\"?>\n<places>\n    <place xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"place.barmen\" n=\"unified\">\n                        <placeName>Barmen</placeName>\n                        <idno type=\"TGN\">1004044</idno>\n                        <idno type=\"GND\">4069145-7</idno>\n                        <note type=\"backlinks\"> fe.e1.255, fe.e1.257, fe.e1.258, fe.e1.276,\n                            fe.e1.277, fe.e2.255, fe.e2.258, fe002, fe003, fe004, fe005, fe006,\n                            fe007, fe008, fe009, fe010, fe011, fe012, fe013, fe014, fe015, fe016,\n                            fe017, fe018, fe019, fe020, fe021, fe022, fe023, fe024, fe025, fe026,\n                            fe027, fe028, fe029, fe030, fe031, fe032, fe033, fe034, fe035, fe036,\n                            fe037, fe038, fe039, fe040, fe041, fe042, fe043a, fe043b, fe044, fe045,\n                            fe046, fe047, fe048, fe049, fe050, fe051, fe052, fe053, fe054, fe055,\n                            fe056, fe057, fe058, fe059, fe060, fe061, fe062, fe063, fe064, fe065,\n                            fe066, fe067, fe068, fe069, fe070, fe071, fe072, fe073, fe074, fe075,\n                            fe076, fe077, fe078, fe079, fe080, fe081, fe082, fe083, fe084, fe086,\n                            fe087, fe088, fe089, fe090, fe091, fe092, fe093, fe094, fe095, fe096,\n                            fe097, fe098, fe099, fe100, fe101, fe102, fe103, fe104, fe105, fe106,\n                            fe107, fe108, fe109, fe110, fe111, fe112, fe113, fe114, fe115, fe116,\n                            fe117, fe118, fe119, fe120, fe123, fe124, fe125, fe126, fe127, fe129,\n                            fe130, fe131, fe132, fe133, fe134, fe135, fe136, fe137, fe138, fe140,\n                            fe141, fe142, fe144, fe145, fe146, fe148, fe149, fe150, fe151, fe152,\n                            fe153, fe154, fe156, fe157, fe158, fe159, fe160, fe161, fe162, fe163,\n                            fe164, fe165, fe167, fe168, fe169, fe170, fe171, fe172, fe173, fe174,\n                            fe175, fe176, fe177, fe178, fe179, fe180, fe181, fe182, fe183, fe184,\n                            fe185, fe186, fe187, fe188, fe189, fe190, fe191, fe192, fe193, fe194,\n                            fe195, fe196, fe197, fe198, fe199, fe200, fe201, fe202, fe203, fe204,\n                            fe205, fe206, fe207, fe208, fe209, fe210, fe211, fe212, fe213, fe214,\n                            fe215, fe216, fe217, fe218, fe219, fe220, fe221, fe222, fe223, fe224,\n                            fe225, fe226, fe227, fe228, fe229, fe231, fe232, fe233, fe234, fe235,\n                            fe235a, fe236, fe237, fe238, fe239, fe240, fe241, fe242, fe243, fe244,\n                            fe245, fe246, fe247, fe248, fe249, fe250, fe251, fe252, fe253, fe254,\n                            fe255, fe256, fe257, fe258, fe259, fe260, fe261, fe262, fe263, fe264,\n                            fe265, fe266, fe267, fe268, fe269, fe270, fe271, fe272, fe273, fe274,\n                            fe275, fe276, fe277, fe278, fe279, fe280, fe281, fe282, fe283, fe284,\n                            fe285, fe286, fe287, fe288, fe289, fe290, fe291, fe292, fe293, fe294,\n                            fe295, fe296, fe297, fe298, fe299, fe300, fe301, fe302, fe303, fe304,\n                            fe305, fe306, fe307, fe308, fe309, fe310, fe311, fe312, fe313, fe314,\n                            fe315, fe316, fe317, fe318, fe319, fe320, fe321, fe322, fe323, fe324,\n                            fe325, fe326, fe327, fe328, fe329, fe330, fe331, fe332, fe333, fe334,\n                            fe335, fe336, fe337, fe338, fe339, fe340, fe342 </note>\n                    </place>\n    <place xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"place.oberbarmen\" n=\"unified\">\n                        <placeName>Oberbarmen</placeName>\n                        <idno type=\"TGN\"/>\n                        <idno type=\"GND\"/>\n                        <note type=\"backlinks\"> fe042 </note>\n                    </place>\n    <place xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"place.elberfeld\" n=\"unified\">\n                        <placeName>Elberfeld</placeName>\n                        <idno type=\"TGN\">7004943</idno>\n                        <idno type=\"GND\">4070734-9</idno>\n                        <note type=\"backlinks\"> fe019, fe022, fe025, fe027, fe029, fe032, fe034,\n                            fe038, fe039, fe040, fe041, fe042, fe043b, fe045, fe047, fe059, fe061,\n                            fe064, fe070, fe071, fe076, fe092, fe093, fe094, fe095, fe096, fe097,\n                            fe098, fe099, fe106, fe128, fe137, fe138, fe145, fe148, fe149, fe154,\n                            fe155, fe162, fe167, fe176, fe178, fe180, fe197, fe204, fe213, fe215,\n                            fe216, fe219, fe226, fe228, fe229, fe232, fe233, fe238, fe245, fe246,\n                            fe249, fe251, fe253, fe255, fe267, fe272, fe274, fe276, fe280, fe283,\n                            fe288, fe296, fe297, fe306, fe307, fe310, fe318, fe321, fe336 </note>\n                    </place>..."

[GET] /api/v1/organisations

Get a list of all organisations.

Example Response

"<?xml version=\"1.0\"?>\n<organisations>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.lange-gebrueder\" n=\"unified\">\n                        <orgName>Gebrüder Lange</orgName>\n                        <!--<persName ref=\"#pers.partic.SN2-FN2\"\n                            type=\"FUNKTION\"/>-->\n                        <note type=\"description\">\n                            <p>Firma in <placeName ref=\"#place.freyberg\">Freyberg</placeName>\n            </p>\n                        </note>\n                        <note type=\"backlinks\"> fe137, fe163 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.kaulisch\" n=\"unified\">\n                        <orgName>Kaulisch</orgName>\n                        <note type=\"description\">\n                            <p>Neukunde der Familie in <placeName ref=\"#place.bunzlau\"/>Bunzlau</p>\n                        </note>\n                        <note type=\"backlinks\"> fe137, fe163 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.lange-gottlob\" n=\"unified\">\n                        <orgName>Gottlob Lange</orgName>\n                        <!--<persName ref=\"#pers.partic.SN2-FN2\"\n                            type=\"FUNKTION\"/>-->\n                        <note type=\"description\">\n                            <p>Firma</p>\n                        </note>\n                        <note type=\"backlinks\"> fe067 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.caspar-engels-soehne\" n=\"unified\">\n                        <orgName>Caspar Engels Söhne</orgName>\n                        <persName type=\"FUNKTION\" ref=\"#pers.partic.engels-johann-caspar-III\"/>\n                        <note type=\"KLASSIFIZIERUNG_DER_ANMERKUNG\">\n                            <p>N. N.</p>\n                        </note>\n                        <note type=\"backlinks\"> fe035, fe092, fe093, fe094, fe095, fe096, fe097, fe098, fe099,\n                            fe100, fe101, fe104, fe124, fe137, fe168, fe191, fe211, fe230, fe253, fe255, fe279,\n                            fe285, fe287, fe295, fe296, fe297 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.partic.keuchen-gebr\" n=\"unified\">\n                        <orgName>Gebrüder Keuchen</orgName>\n                        <note type=\"description\">\n                            <p>\"Gebrüder Keuchen\", Firma der Barmer Kaufmanns- und Industriellenfamilie Keuchen.</p>\n                        </note>\n                        <note type=\"backlinks\"> fe094, fe095, fe096, fe097, fe098, fe099, fe160 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.a.siebel\" n=\"unified\">\n                        <orgName>A. Siebel</orgName>\n                        <persName type=\"Handelspartner\" ref=\"#pers.partic.schreiber-friedrich\"/>\n                        <note type=\"description\">\n            <p>Bleicherei</p>\n        </note>\n                        <note type=\"backlinks\"> fe112, fe124, fe137, fe221 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.schencks-sohn\" n=\"unified\">\n                        <orgName>Schencks Sohn</orgName>\n                        <note type=\"backlinks\"> fe123, fe124 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.kampermann-wemhoener\" n=\"unified\">\n                        <orgName>Kampermann & Wemhöner</orgName>\n                        <note type=\"description\">Seidenhandlung und Firma für Kommissionsgeschäfte im Barmer \"Bruch\"</note>\n                        <note type=\"backlinks\"> fe061, fe062 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.wieler-gerhard-sohn\" n=\"unified\">\n                        <orgName>Gerhard Wieler & Sohn</orgName>\n                        <note type=\"backlinks\"> fe067, fe123, fe124 </note>\n                    </org>\n    <org xmlns=\"http://www.tei-c.org/ns/1.0\" xml:id=\"org.hauffe\" n=\"unified\">\n                        <orgName type=\"reg\">\n                            <surname>Hauffe</surname>\n                        </orgName>\n..."

[GET] /api/v1/bibliography

Get the bibliography.

Example Response

"<?xml version=\"1.0\"?>\n<bibl>\n    <bibl xmlns=\"http:\/\/www.tei-c.org\/ns\/1.0\" xml:id=\"bibl.adelung.1811\">\n                  <title type=\"main\">Grammatisch-kritisches Wörterbuch der hochdeutschen Mundart<\/title>. \n                  <title type=\"sub\">Mit beständiger Vergleichung der übrigen Mundarten, besonders aber der oberdeutschen<\/title>. Hrsg. von <editor>\n                     <forename>Johann<\/forename>\n                     <forename>Christoph<\/forename>\n                     <surname>Adelung<\/surname>\n                  <\/editor>, <editor>\n                     <forename>Dietrich<\/forename>\n                     <forename>Wilhelm<\/forename>\n                     <surname>Soltau<\/surname>\n                  <\/editor>, <editor>\n                     <forename>Franz<\/forename>\n                     <forename>Xaver<\/forename..."

Facsimile

The list of facsimiles is decoded in TEI/facsimile/graphic/@url

The public URL for each document is https://api.familie-engels-briefe.de/facsimile/@url, where @url is the same attribute as in the xml file.

Example error response

{
  "success": false,
  "code": 500,
  "error": "Error description"
}