Für Partner-Apps

Deine Nutzer posten ihren Fortschritt auf Bemelio, mit einem Visual in deinen Farben.

Ein Button in deiner App öffnet Bemelio mit einem fertigen Beitrag, signiert „via“ deiner App. Ein Link genügt: kein SDK, kein Schlüssel.

Zugang anfragen

Kostenloser Zugang. Das Mitglied bestätigt seinen Beitrag immer selbst.

Bemelio-Story einer Tagesserie, signiert via deiner App — Screenshots der Bemelio-App. In der Mitte eine Lesesitzung, geteilt aus VREAD.

Bemelio-Story eines Laufs, signiert via deiner App — Screenshots der Bemelio-App. In der Mitte eine Lesesitzung, geteilt aus VREAD.

So funktioniert's

1
Ein Button in deiner App
Nach einem Training, einer Lesesitzung oder einem Lauf öffnet „Auf Bemelio teilen“ einen Link mit der Aktivität.
2
Das Mitglied bestätigt auf Bemelio
Der Beitrag ist fertig, im passenden Ziel. Es prüft ihn, kann den Text ändern und postet ihn selbst.
3
Die Story macht deine App bekannt
Mit einem Tipp teilt es sie als Story, in deinen Farben, mit deinem Logo und „via“ deiner App: Seine Freunde entdecken sie.

Was deine App tut: einen Link öffnen

Kein SDK, kein Austausch von Server zu Server. Die Aktivität steckt im Parameter d, einem JSON in base64url.

https://bemelio.com/partage?app=slug&outil=outil&d=base64url(JSON)

Bau deinen Link

App-Kennung appBemelio gibt sie dir bei der Aktivierung.Tool outilBuchtitel visuel.titreAktuelle Seite visuel.pageSeiten des Buchs visuel.total

Dein Link

https://bemelio.com/partage?app=deine-app&outil=lecture&d=eyJ0aXRyZSI6IkRlciBGcmVtZGUiLCJ2aXN1ZWwiOnsidGl0cmUiOiJEZXIgRnJlbWRlIiwicGFnZSI6MTQ4LCJ0b3RhbCI6MTg2fX0

JSON ansehen

{
  "titre": "Der Fremde",
  "visuel": {
    "titre": "Der Fremde",
    "page": 148,
    "total": 186
  }
}

Scanne den Code, um den Link auf deinem Handy auszuprobieren.

Solange deine App nicht aktiviert ist, öffnet der Link Bemelio mit einer freundlichen Fehlermeldung, und nichts wird gepostet.

Der Button, in wenigen Zeilen

Die Beispiele nutzen den Link, den du gerade gebaut hast.

func shareOnBemelio() {
  let data: [String: Any] = [
    "titre": "Der Fremde",
    "visuel": ["titre": "Der Fremde", "page": 148, "total": 186],
  ]
  guard let json = try? JSONSerialization.data(withJSONObject: data) else { return }
  let d = json.base64EncodedString()
    .replacingOccurrences(of: "+", with: "-")
    .replacingOccurrences(of: "/", with: "_")
    .replacingOccurrences(of: "=", with: "")
  if let url = URL(string: "https://bemelio.com/partage?app=deine-app&outil=lecture&d=\(d)") {
    UIApplication.shared.open(url)
  }
}

Alle Tools ansehen

Felder von d

`titre`	`string(48)`	Der Kartentitel, in einer Zeile.
`texte`	`string(500)`	Die vorgeschlagene Nachricht, die das Mitglied ändern kann.
`visuel`	`{ }`	Pflicht: die Zahlen, die das Visual des Tools zeichnen.
`stats`	`[3]`	Optional: Lass Bemelio sie berechnen, in der Sprache des Mitglieds.

Tools und Felder von visuel

Tool	Felder	Kerndaten
Lesen `lecture`	`titre string(80) · auteur string(60) · page, total 0-20000 · jour 0-5000 · semaine [7] · serie 0-3650 · finDans 0-999 · fini bool · note 0-5 · lus [24] string(60) · cible 0-365`	`titre \| cible \| lus`
Laufen `course`	`km 0-1000 · duree 0-360000 (s) · dplus 0-20000 · trace [[lat, lon], ...] (100)`	`km + duree`
Serie `serie`	`mois 0-11 · annee · coches [31] 1-31 · aujourdhui 0-31 · serie, record, prochain 0-100000`	`serie`
Radfahren `velo`	`km 0-2000 · semaines [8] · objectif · dplus 0-20000 · vitesse 0-200`	`km`
Wanderung `rando`	`km 0-500 · dplus, dmoins 0-20000 · altMax 0-9000 · saisonDplus`	`km`
Schwimmen `natation`	`m 0-100000 · longueurs 0-4000 · bassin 0-100 · allure string(8) · semaines [8]`	`m`
Meditation `meditation` Yoga `yoga`	`min 0-1440 · jours [7] · objectif`	`min`
Sprachen `langue`	`code string(3) · niveau, cible A1-C2 · min · mots 0-1000000 · serie`	`min \| mots`
Musik `musique`	`min · jours [7] · bpm, cibleBpm 0-400`	`min`
Zeichnen `dessin` Fotografie `photo` Timer `chrono`	`min 0-100000 · jours [7] · unite string(14)`	`min`
Schreiben `ecriture`	`mots 0-1000000 · jours [14] · objectif · manuscrit 0-100`	`mots`
Kochen `cuisine`	`recettes 0-1000 · cuisines [12] string(3) · niveau 0-4 · pct 0-100`	`recettes \| cuisines`
Lernen `etudes`	`min · jours [7] · pct 0-100 · examDans 0-999 · matieres [5] 0-1`	`min \| pct`
Sparen `epargne`	`pct 0-100 · mois 0-600 · versements` Niemals ein Betrag	`pct`
Gewohnheiten `habitudes`	`jours [84] 0-1 · faites, prevues 0-100 · serie`	`prevues`
Klettern `escalade`	`voies [24] { cote, res: onsight \| flash \| sent \| project \| failed } · max`	`voies[0]`
Jobsuche `emploi`	`envoyees, reponses, entretiens, offres 0-10000`	`envoyees`
Community `audience`	`points [16] · palier · plateforme string(20)`	`points (2+)`

Zahlen sind positiv und werden auf ihre Grenzen begrenzt. Unbekannte Felder werden ignoriert. Ein Visual ohne Kerndaten führt zur Ablehnung des Links. Der ganze Link hat höchstens 6000 Zeichen.

Die Regeln

Das Mitglied bestätigt immer. Ein Link postet nie etwas von selbst.
Bei Finanzen keine Beträge: nur Prozente. Immer die echten Zahlen des Mitglieds, ohne Gesundheitsdaten.
Der Zugang ist kostenlos.
Deine App muss von Bemelio aktiviert werden. Du bekommst deine Kennung, deine Farbe und deine Tools.

Bereit, deinen Button anzuschließen?

Sag uns, welche App und welche Tools. Wir aktivieren deine Kennung und deine Farben.

Zugang anfragen