Developers · API v1

Broadcast Map API

Three HTTPS calls let installer apps declare the venues that offer Auracast™ broadcasts, let networked transmitters say a venue is broadcasting right now, and let any app read the map. Free to use, open specification, no personal data.

REST + JSON
Free
Reads without a key
Data under CC BY 4.0

Quick start

Every call goes to https://aurapulse.org/api/v1/, sends and returns JSON (UTF-8), and works over HTTPS only. Send a User-Agent header naming your app or device and its version (for example ExampleApp/4.2), so that an error can be traced back to its source.

Reading needs no key. Try it now, from a terminal:

curl "https://aurapulse.org/api/v1/venues?lat=46.58&lng=0.34&radius_km=25"

Or right here

The answer will show here.

The API itself always answers in English, whatever the language of this page.

Call	Method and path	Who calls it	Key
Declare a venue	`POST /venues`	Installer and configuration apps, when a transmitter is set up	Partner
Remove a venue	`DELETE /venues/{id}`	The partner that declared it	Partner
List my venues	`GET /partner/venues`	A partner checking its declarations	Partner
Report live	`POST /venues/{id}/live`	Networked transmitters, a partner’s cloud	Venue or partner
Read nearby venues	`GET /venues?lat=&lng=&radius_km=`	Any app or website	None
Read one venue	`GET /venues/{id}`	Any app or website	None

A declared venue shows on the map once a moderator has checked it. A venue that reported live in the last 10 minutes shows as Live, with a green dot, on the map and in every read.

Keys

Keys go in the Authorization: Bearer <key> header. They are free and do not expire, but a key that sends wrong data can be revoked. A key that may have leaked is replaced on request: the old one stops working the same day.

Key	Looks like	Given to	Allows
Partner key	`apk_live_` + 32 characters	One per company, on request	Declaring, removing and listing that partner’s venues; reporting them live from the partner’s cloud
Venue key	`avk_` + 32 characters	Returned when a venue is declared; also given by the map team for a venue already on the map	Reporting that one venue as live
Test key	`apk_test_` + 32 characters	Anyone who asks	Every partner call, on test data that never reaches the map

A venue key only lets a device say “this venue is live”: it cannot change the venue’s name, address or streams. A transmitter can store it without risk to the listing.

To get a key, write to contact@aurapulse.org with your company name, the products concerned and the name to show as the source on the map. A test key is usually sent the same day.

Declare a venue

POST /venues with a partner key, when a transmitter is installed or its broadcast settings change. Calling it again with the same external_id updates the venue instead of creating a second one.

curl -X POST "https://aurapulse.org/api/v1/venues" \
  -H "Authorization: Bearer apk_live_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: ExampleApp/4.2" \
  -d @venue.json

{
  "external_id": "site-48213",
  "name": "Example Cinema",
  "address": "1 Example Street, 00000 Exampletown, France",
  "country": "FR",
  "lat": 46.5802,
  "lng": 0.3404,
  "type": "screen",
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "label": "Screen 1", "access": "open", "languages": ["fr"] },
    { "name": "EXAMPLE_SCREEN_2", "label": "Screen 2, English version", "access": "password", "languages": ["en"] }
  ],
  "public": true
}

external_id, name, country, streams and public are required, plus either address or lat + lng. Every field is described in The venue object.
public must be true: the map only lists places open to the public. A home, an office or a private event is refused.
Never send the broadcast password (Broadcast Code): access only says whether there is one.

Answer 201 Created (or 200 OK for an update):

{
  "id": "example-cinema-exampletown",
  "status": "pending",
  "venue_key": "avk_...",
  "map_url": "https://aurapulse.org/map/#example-cinema-exampletown"
}

status is pending until a moderator publishes the venue, then published. venue_key is returned only when a declaration is first created: store it in the transmitter if it can report live.

A venue already on the map

Recommended: before declaring, read the venues within 200 m (GET /venues?lat=…&lng=…&radius_km=0.2) and ask the installer whether the place is one of them. If it is, send that venue’s id as join_venue_id. Without it, the map matches the declaration itself, in this order:

Same partner and same external_id: the same venue, updated.
A venue within 150 m that already has one of the declared Broadcast Names: the same venue. The answer gives its existing id.
A venue within 150 m with a similar name but none of the same Broadcast Names: kept pending and flagged to the moderator as a possible duplicate.
Nothing close: a new venue, pending.

When a declaration joins a venue, its level goes up to declared, but a venue level (confirmed by the venue itself) is kept, and so are the fields the map team corrected by hand. Two venues in one building (a cinema and a shop in the same mall) stay apart as long as their Broadcast Names differ.

Remove a venue

DELETE /venues/{id} with the partner key that declared it, for example when a transmitter is uninstalled. The venue stops being Live at once and leaves the map once a moderator confirms. Answer 202 Accepted:

{ "id": "example-cinema-exampletown", "status": "removal_requested" }

GET /partner/venues lists every venue declared with your key, with its external_id and status, 100 per page (next gives the next page). It is the way to check a declaration without waiting for it on the map.

Report live

POST /venues/{id}/live with that venue’s key (or the partner key that declared it, for a partner’s own cloud), every 5 minutes while the transmitter broadcasts. The venue shows as Live for 10 minutes after the last report, so one missed report changes nothing.

{
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "access": "open" },
    { "name": "EXAMPLE_SCREEN_2", "access": "password" }
  ],
  "device": { "maker": "Example Audio", "model": "TX-200", "firmware": "2.3.1" }
}

streams lists what is on air now. An empty list means the transmitter is on but silent: the venue is not shown as Live.
Only Broadcast Names declared for the venue count; others are ignored and listed back in ignored.
device is optional and only used to show the source (“Live via Example Audio TX-200”).
Add a random delay of 0 to 60 seconds to the first report after power-on, so that many transmitters restarting together after a power cut do not all call at once.
Only what is online can report. A transmitter with no network keeps its place on the map but is never shown as Live.

Answer 200 OK:

{
  "live_until": "2026-10-19T21:10:00Z",
  "next_report_in": 300,
  "ignored": []
}

next_report_in is in seconds and must be followed: it lets the map slow every device down without a firmware update. A device that reports more often is answered 429.

Read venues

No key needed. Answers can be called from any web page (CORS is open) and may be cached for 60 seconds.

GET /venues?lat=46.58&lng=0.34&radius_km=25 returns the published venues within radius_km (0.1 to 100, default 25), nearest first, 50 per page:

{
  "venues": [
    {
      "id": "example-cinema-exampletown",
      "name": "Example Cinema",
      "city": "Exampletown",
      "lat": 46.5802,
      "lng": 0.3404,
      "distance_km": 0.4,
      "type": "screen",
      "streams": [{ "name": "EXAMPLE_SCREEN_1", "access": "open", "languages": ["fr"] }],
      "level": "declared",
      "live": { "status": "live", "since": "2026-10-19T19:02:00Z", "last_seen": "2026-10-19T21:00:00Z" }
    }
  ],
  "next": null
}

live=only keeps only the venues that are live now. type=screen,worship filters by type.
next is the URL of the next page, or null.
GET /venues/{id} returns one venue, or 404.

The venue object

Field	Type	Rules
`id`	string	Set by the map from the name and city. Never changes.
`external_id`	string	Your own id for the site, 1 to 64 characters. Only returned to you.
`join_venue_id`	string	Sent only when declaring: the `id` of an existing venue the installer chose. See A venue already on the map.
`name`	string	Name of the place as the public knows it, 2 to 80 characters.
`address`	string	Full postal address, up to 200 characters.
`city`	string	Filled from the address if missing.
`country`	string	ISO 3166-1 alpha-2 code: `FR`, `GB`, `US`…
`lat`, `lng`	number	WGS 84, 5 decimals or more. Found from the address if missing (OpenStreetMap).
`type`	string	One of `screen`, `public`, `museum`, `worship`, `transport`, `education`, `hearing`, `sport`, `health`, `retail`, `other`. `screen` is a cinema, theatre or concert hall; `public` a town hall, library or courthouse; `hearing` hearing care. More types may be added: show an unknown type as `other`.
`type_detail`	string	Optional, up to 40 characters, free words for the place (`Stadium`, `Hospital`).
`streams`	array	1 to 16 items.
`streams[].name`	string	The Broadcast Name exactly as broadcast, 1 to 32 characters.
`streams[].label`	string	Optional, up to 40 characters: what the stream is for (`Screen 1`, `English version`).
`streams[].access`	string	`open`, `password` or `unknown`. The password itself is never sent.
`streams[].languages`	array	Optional ISO 639-1 codes of the audio (`fr`, `en`).
`public`	boolean	Must be `true` when declaring. Not returned.
`level`	string	Returned only: `documented` (found in a public source), `reported` (sent by a visitor through the map’s form), `declared` (sent by a partner through this API), `venue` (confirmed by the venue itself).
`source`	object	Returned only: the partner’s name, or the press article.
`live`	object	Returned only: `status` (`live` or `off`), `since` and `last_seen` (ISO 8601, UTC).

When the map team moves a venue to a more precise type, a later declaration with other does not undo it.

Errors and limits

Every error has the same shape, so a device can log it as it is:

{ "error": { "code": "invalid_field", "field": "streams[1].name", "message": "Broadcast Name is longer than 32 characters." } }

HTTP	code	When
400	`invalid_json`, `invalid_field`, `missing_field`	The body cannot be read, or a field breaks its rules
401	`missing_key`, `unknown_key`	No key, or a key the map does not know
403	`revoked_key`, `not_your_venue`, `not_public`	Key revoked, venue declared by another partner, or `public` is not `true`
404	`not_found`	No venue with that id, or an unknown address
409	`external_id_conflict`	This `external_id` is already used for a different place
429	`too_many_requests`	Over a limit below; the `Retry-After` header says when to try again
500, 503	`server_error`, `maintenance`	Our side; retry after `Retry-After`, or 5 minutes

Call	Limit
Declare or remove	500 per day per partner key
Report live	1 per `next_report_in` per venue (300 seconds today)
Read	60 per minute per IP address

Testing

A test key (apk_test_…) works on every partner call, with the same checks and the same answers, plus "test": true. Test declarations never reach the moderators or the public map, and are erased after 24 hours. Check them with GET /partner/venues. Test live reports use the venue keys returned by test declarations.

Rules

No personal data. The API takes and gives places and broadcasts only: no installer names, no e-mail addresses, no device serial numbers. IP addresses are used for rate limits and kept 7 days at most. Details in the privacy policy.

Public places only. Declared venues are checked by a moderator before they appear.

Right to removal. Any venue can ask to be taken off the map at contact@aurapulse.org, even one declared by a partner; it is removed within 7 days and is not declared again through the API.

Passwords stay private. The map shows that a stream is protected, never its password.

Reusing the data. Everything the read calls return is under CC BY 4.0: free to show in any app or site, with the credit “Data: AuraPulse broadcast map” and a link to aurapulse.org/map.

No guarantee. The API is free and runs on a small host, with no promise of availability. Clients must keep working when it does not answer: a missed declaration can be sent again, a missed live report only delays the green dot.

Versioning. v1 only grows: new optional fields, new values and new calls, never a removed or renamed field. A breaking change goes to v2, announced 12 months ahead, and v1 keeps running during that time.

Open specification. This page is published under CC BY 4.0: anyone may implement it, including another map.

Trademarks. Auracast™ is a trademark of Bluetooth SIG, Inc.; AuraPulse is an independent project, not affiliated with or endorsed by Bluetooth SIG. Partner names are shown on the map only with their agreement.

Not in v1

Planned as optional fields, so that v1 integrations keep working: broadcast schedules (“Saturdays during shows”), a link that opens an open stream directly from an app, and automatic publication for partners whose declarations have proved reliable. Ideas and questions are welcome at contact@aurapulse.org.

Version 1 · updated 19 October 2026 · https://aurapulse.org/api/v1/

Développeurs · API v1

API de la carte des diffusions

Trois appels HTTPS permettent aux applications d’installation de déclarer les lieux qui proposent des diffusions Auracast™, aux émetteurs connectés de dire qu’un lieu diffuse en ce moment, et à n’importe quelle application de lire la carte. Gratuite, spécification ouverte, aucune donnée personnelle.

REST + JSON
Gratuite
Lecture sans clé
Données sous CC BY 4.0

Démarrage rapide

Chaque appel va à https://aurapulse.org/api/v1/, envoie et renvoie du JSON (UTF-8), et fonctionne seulement en HTTPS. Envoyez un en-tête User-Agent avec le nom et la version de votre application ou de votre appareil (par exemple ExampleApp/4.2), pour qu’une erreur puisse être retrouvée.

La lecture ne demande pas de clé. Essayez tout de suite, depuis un terminal :

curl "https://aurapulse.org/api/v1/venues?lat=46.58&lng=0.34&radius_km=25"

Ou directement ici

La réponse s’affichera ici.

L’API elle-même répond toujours en anglais, quelle que soit la langue de cette page.

Appel	Méthode et chemin	Qui l’appelle	Clé
Déclarer un lieu	`POST /venues`	Applications d’installation et de réglage, quand un émetteur est installé	Partenaire
Retirer un lieu	`DELETE /venues/{id}`	Le partenaire qui l’a déclaré	Partenaire
Lister mes lieux	`GET /partner/venues`	Un partenaire qui vérifie ses déclarations	Partenaire
Signaler en direct	`POST /venues/{id}/live`	Émetteurs connectés, cloud d’un partenaire	Lieu ou partenaire
Lire les lieux proches	`GET /venues?lat=&lng=&radius_km=`	Toute application ou tout site	Aucune
Lire un lieu	`GET /venues/{id}`	Toute application ou tout site	Aucune

Un lieu déclaré apparaît sur la carte après vérification par un modérateur. Un lieu qui a signalé une diffusion dans les 10 dernières minutes apparaît En direct, avec un point vert, sur la carte et dans chaque lecture.

Clés

Les clés vont dans l’en-tête Authorization: Bearer <key>. Elles sont gratuites et n’expirent pas, mais une clé qui envoie des données fausses peut être coupée. Une clé qui a pu fuiter est remplacée sur demande : l’ancienne cesse de marcher le jour même.

Clé	Forme	Donnée à	Permet
Clé partenaire	`apk_live_` + 32 caractères	Une par entreprise, sur demande	Déclarer, retirer et lister les lieux de ce partenaire ; les signaler en direct depuis le cloud du partenaire
Clé de lieu	`avk_` + 32 caractères	Renvoyée quand un lieu est déclaré ; donnée aussi par l’équipe de la carte pour un lieu déjà présent	Signaler ce seul lieu en direct
Clé de test	`apk_test_` + 32 caractères	Toute personne qui la demande	Tous les appels partenaire, sur des données de test qui n’arrivent jamais sur la carte

Une clé de lieu permet seulement à un appareil de dire « ce lieu diffuse » : elle ne peut changer ni le nom, ni l’adresse, ni les flux du lieu. Un émetteur peut la garder sans risque pour la fiche.

Pour obtenir une clé, écrivez à contact@aurapulse.org avec le nom de votre entreprise, les produits concernés et le nom à afficher comme source sur la carte. Une clé de test est en général envoyée le jour même.

Déclarer un lieu

POST /venues avec une clé partenaire, quand un émetteur est installé ou que ses réglages de diffusion changent. Un nouvel appel avec le même external_id met le lieu à jour au lieu d’en créer un second.

curl -X POST "https://aurapulse.org/api/v1/venues" \
  -H "Authorization: Bearer apk_live_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: ExampleApp/4.2" \
  -d @venue.json

{
  "external_id": "site-48213",
  "name": "Example Cinema",
  "address": "1 Example Street, 00000 Exampletown, France",
  "country": "FR",
  "lat": 46.5802,
  "lng": 0.3404,
  "type": "screen",
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "label": "Screen 1", "access": "open", "languages": ["fr"] },
    { "name": "EXAMPLE_SCREEN_2", "label": "Screen 2, English version", "access": "password", "languages": ["en"] }
  ],
  "public": true
}

external_id, name, country, streams et public sont obligatoires, plus address ou lat + lng. Chaque champ est décrit dans L’objet lieu.
public doit valoir true : la carte ne liste que des lieux ouverts au public. Un domicile, un bureau ou un événement privé est refusé.
N’envoyez jamais le mot de passe de diffusion (Broadcast Code) : access dit seulement s’il y en a un.

Réponse 201 Created (ou 200 OK pour une mise à jour) :

{
  "id": "example-cinema-exampletown",
  "status": "pending",
  "venue_key": "avk_...",
  "map_url": "https://aurapulse.org/map/#example-cinema-exampletown"
}

status vaut pending jusqu’à ce qu’un modérateur publie le lieu, puis published. venue_key n’est renvoyée qu’à la première déclaration : gardez-la dans l’émetteur s’il peut signaler en direct.

Un lieu déjà sur la carte

Conseillé : avant de déclarer, lisez les lieux dans un rayon de 200 m (GET /venues?lat=…&lng=…&radius_km=0.2) et demandez à l’installateur si le lieu est l’un d’eux. Si oui, envoyez son id dans join_venue_id. Sinon, la carte rapproche elle-même la déclaration, dans cet ordre :

Même partenaire et même external_id : le même lieu, mis à jour.
Un lieu à moins de 150 m qui a déjà un des Broadcast Names déclarés : le même lieu. La réponse donne son id existant.
Un lieu à moins de 150 m au nom proche mais sans Broadcast Name commun : gardé pending et signalé au modérateur comme doublon possible.
Rien à côté : un nouveau lieu, pending.

Quand une déclaration rejoint un lieu, son niveau monte à declared, mais un niveau venue (confirmé par le lieu lui-même) est gardé, tout comme les champs corrigés à la main par l’équipe de la carte. Deux lieux dans un même bâtiment (un cinéma et une boutique dans le même centre commercial) restent séparés tant que leurs Broadcast Names diffèrent.

Retirer un lieu

DELETE /venues/{id} avec la clé partenaire qui l’a déclaré, par exemple quand un émetteur est désinstallé. Le lieu cesse aussitôt d’être En direct et quitte la carte quand un modérateur confirme. Réponse 202 Accepted :

{ "id": "example-cinema-exampletown", "status": "removal_requested" }

GET /partner/venues liste tous les lieux déclarés avec votre clé, avec leur external_id et leur status, 100 par page (next donne la page suivante). C’est le moyen de vérifier une déclaration sans attendre de la voir sur la carte.

Signaler en direct

POST /venues/{id}/live avec la clé de ce lieu (ou la clé partenaire qui l’a déclaré, pour le cloud d’un partenaire), toutes les 5 minutes tant que l’émetteur diffuse. Le lieu reste En direct 10 minutes après le dernier signal : un signal manqué ne change rien.

{
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "access": "open" },
    { "name": "EXAMPLE_SCREEN_2", "access": "password" }
  ],
  "device": { "maker": "Example Audio", "model": "TX-200", "firmware": "2.3.1" }
}

streams liste ce qui est diffusé en ce moment. Une liste vide veut dire que l’émetteur est allumé mais muet : le lieu n’est pas affiché En direct.
Seuls les Broadcast Names déclarés pour ce lieu comptent ; les autres sont ignorés et renvoyés dans ignored.
device est facultatif et sert seulement à afficher la source (« En direct via Example Audio TX-200 »).
Ajoutez un délai au hasard de 0 à 60 secondes avant le premier signal après la mise sous tension, pour que des émetteurs qui redémarrent ensemble après une coupure de courant n’appellent pas tous en même temps.
Seul ce qui est en ligne peut signaler. Un émetteur sans réseau garde sa place sur la carte mais n’est jamais affiché En direct.

Réponse 200 OK :

{
  "live_until": "2026-10-19T21:10:00Z",
  "next_report_in": 300,
  "ignored": []
}

next_report_in est en secondes et doit être respecté : il permet à la carte de ralentir tous les appareils sans mise à jour du firmware. Un appareil qui signale plus souvent reçoit 429.

Lire les lieux

Aucune clé. Les réponses peuvent être appelées depuis n’importe quelle page web (CORS ouvert) et gardées en cache 60 secondes.

GET /venues?lat=46.58&lng=0.34&radius_km=25 renvoie les lieux publiés dans un rayon de radius_km (0,1 à 100, 25 par défaut), du plus proche au plus loin, 50 par page :

{
  "venues": [
    {
      "id": "example-cinema-exampletown",
      "name": "Example Cinema",
      "city": "Exampletown",
      "lat": 46.5802,
      "lng": 0.3404,
      "distance_km": 0.4,
      "type": "screen",
      "streams": [{ "name": "EXAMPLE_SCREEN_1", "access": "open", "languages": ["fr"] }],
      "level": "declared",
      "live": { "status": "live", "since": "2026-10-19T19:02:00Z", "last_seen": "2026-10-19T21:00:00Z" }
    }
  ],
  "next": null
}

live=only garde seulement les lieux en direct. type=screen,worship filtre par type.
next est l’adresse de la page suivante, ou null.
GET /venues/{id} renvoie un lieu, ou 404.

L’objet lieu

Champ	Type	Règles
`id`	string	Fixé par la carte à partir du nom et de la ville. Ne change jamais.
`external_id`	string	Votre propre identifiant du site, 1 à 64 caractères. Renvoyé à vous seul.
`join_venue_id`	string	Envoyé seulement à la déclaration : l’`id` d’un lieu existant choisi par l’installateur. Voir Un lieu déjà sur la carte.
`name`	string	Nom du lieu tel que le public le connaît, 2 à 80 caractères.
`address`	string	Adresse postale complète, 200 caractères au plus.
`city`	string	Déduite de l’adresse si absente.
`country`	string	Code ISO 3166-1 alpha-2 : `FR`, `GB`, `US`…
`lat`, `lng`	number	WGS 84, 5 décimales ou plus. Trouvées à partir de l’adresse si absentes (OpenStreetMap).
`type`	string	Un de `screen`, `public`, `museum`, `worship`, `transport`, `education`, `hearing`, `sport`, `health`, `retail`, `other`. `screen` est un cinéma, un théâtre ou une salle de concert ; `public` une mairie, une bibliothèque ou un tribunal ; `hearing` un centre auditif. D’autres types pourront venir : affichez un type inconnu comme `other`.
`type_detail`	string	Facultatif, 40 caractères au plus, mots libres pour le lieu (`Stadium`, `Hospital`).
`streams`	array	1 à 16 éléments.
`streams[].name`	string	Le Broadcast Name exactement tel qu’il est diffusé, 1 à 32 caractères.
`streams[].label`	string	Facultatif, 40 caractères au plus : à quoi sert le flux (`Screen 1`, `English version`).
`streams[].access`	string	`open`, `password` ou `unknown`. Le mot de passe lui-même n’est jamais envoyé.
`streams[].languages`	array	Codes ISO 639-1 facultatifs de l’audio (`fr`, `en`).
`public`	boolean	Doit valoir `true` à la déclaration. Pas renvoyé.
`level`	string	Renvoyé seulement : `documented` (trouvé dans une source publique), `reported` (envoyé par un visiteur avec le formulaire de la carte), `declared` (envoyé par un partenaire avec cette API), `venue` (confirmé par le lieu lui-même).
`source`	object	Renvoyé seulement : le nom du partenaire, ou l’article de presse.
`live`	object	Renvoyé seulement : `status` (`live` ou `off`), `since` et `last_seen` (ISO 8601, UTC).

Quand l’équipe de la carte range un lieu dans un type plus précis, une déclaration suivante avec other ne l’annule pas.

Erreurs et limites

Toutes les erreurs ont la même forme, pour qu’un appareil puisse les noter telles quelles :

{ "error": { "code": "invalid_field", "field": "streams[1].name", "message": "Broadcast Name is longer than 32 characters." } }

HTTP	code	Quand
400	`invalid_json`, `invalid_field`, `missing_field`	Le corps ne peut pas être lu, ou un champ ne respecte pas ses règles
401	`missing_key`, `unknown_key`	Pas de clé, ou une clé inconnue de la carte
403	`revoked_key`, `not_your_venue`, `not_public`	Clé coupée, lieu déclaré par un autre partenaire, ou `public` ne vaut pas `true`
404	`not_found`	Aucun lieu avec cet id, ou adresse inconnue
409	`external_id_conflict`	Ce `external_id` est déjà utilisé pour un autre endroit
429	`too_many_requests`	Au-delà d’une limite ci-dessous ; l’en-tête `Retry-After` dit quand réessayer
500, 503	`server_error`, `maintenance`	De notre côté ; réessayez après `Retry-After`, ou 5 minutes

Appel	Limite
Déclarer ou retirer	500 par jour et par clé partenaire
Signaler en direct	1 par `next_report_in` et par lieu (300 secondes aujourd’hui)
Lire	60 par minute et par adresse IP

Tests

Une clé de test (apk_test_…) marche sur tous les appels partenaire, avec les mêmes contrôles et les mêmes réponses, plus "test": true. Les déclarations de test n’arrivent jamais aux modérateurs ni sur la carte publique, et sont effacées après 24 heures. Vérifiez-les avec GET /partner/venues. Les signaux en direct de test utilisent les clés de lieu renvoyées par les déclarations de test.

Règles

Aucune donnée personnelle. L’API prend et donne seulement des lieux et des diffusions : pas de nom d’installateur, pas d’adresse e-mail, pas de numéro de série. Les adresses IP servent aux limites d’usage et sont gardées 7 jours au plus. Détails dans la politique de confidentialité.

Lieux publics seulement. Les lieux déclarés sont vérifiés par un modérateur avant d’apparaître.

Droit au retrait. Tout lieu peut demander à quitter la carte à contact@aurapulse.org, même s’il a été déclaré par un partenaire ; il est retiré sous 7 jours et n’est plus déclaré par l’API.

Les mots de passe restent privés. La carte montre qu’un flux est protégé, jamais son mot de passe.

Réutiliser les données. Tout ce que renvoient les appels de lecture est sous CC BY 4.0 : libre d’affichage dans toute application ou tout site, avec la mention « Data: AuraPulse broadcast map » et un lien vers aurapulse.org/map.

Aucune garantie. L’API est gratuite et tourne sur un petit hébergement, sans promesse de disponibilité. Les clients doivent continuer à marcher quand elle ne répond pas : une déclaration manquée peut être renvoyée, un signal en direct manqué retarde seulement le point vert.

Versions. La v1 ne fait que grandir : nouveaux champs facultatifs, nouvelles valeurs, nouveaux appels, jamais un champ retiré ou renommé. Un changement qui casserait une intégration va dans une v2, annoncée 12 mois à l’avance, et la v1 continue de marcher pendant ce temps.

Spécification ouverte. Cette page est publiée sous CC BY 4.0 : chacun peut l’implémenter, y compris une autre carte.

Marques. Auracast™ est une marque de Bluetooth SIG, Inc. ; AuraPulse est un projet indépendant, ni affilié ni approuvé par Bluetooth SIG. Le nom d’un partenaire n’apparaît sur la carte qu’avec son accord.

Pas dans la v1

Prévu sous forme de champs facultatifs, pour que les intégrations v1 continuent de marcher : horaires de diffusion (« le samedi pendant les séances »), un lien qui ouvre un flux libre directement depuis une application, et une publication automatique pour les partenaires dont les déclarations se sont montrées fiables. Idées et questions bienvenues à contact@aurapulse.org.

Version 1 · mise à jour le 19 octobre 2026 · https://aurapulse.org/api/v1/

Desarrolladores · API v1

API del mapa de emisiones

Tres llamadas HTTPS permiten que las apps de instalación declaren los lugares con emisiones Auracast™, que los transmisores conectados indiquen que un lugar está emitiendo ahora mismo, y que cualquier app lea el mapa. Gratuita, especificación abierta, sin datos personales.

REST + JSON
Gratuita
Lectura sin clave
Datos con CC BY 4.0

Inicio rápido

Cada llamada va a https://aurapulse.org/api/v1/, envía y devuelve JSON (UTF-8) y solo funciona por HTTPS. Envíe una cabecera User-Agent con el nombre y la versión de su app o dispositivo (por ejemplo ExampleApp/4.2), para poder rastrear un error hasta su origen.

La lectura no necesita clave. Pruébela ahora desde un terminal:

curl "https://aurapulse.org/api/v1/venues?lat=46.58&lng=0.34&radius_km=25"

O aquí mismo

La respuesta aparecerá aquí.

La API responde siempre en inglés, sea cual sea el idioma de esta página.

Llamada	Método y ruta	Quién la usa	Clave
Declarar un lugar	`POST /venues`	Apps de instalación y configuración, al instalar un transmisor	Socio
Retirar un lugar	`DELETE /venues/{id}`	El socio que lo declaró	Socio
Listar mis lugares	`GET /partner/venues`	Un socio que revisa sus declaraciones	Socio
Informar en directo	`POST /venues/{id}/live`	Transmisores conectados, la nube de un socio	Lugar o socio
Leer lugares cercanos	`GET /venues?lat=&lng=&radius_km=`	Cualquier app o sitio web	Ninguna
Leer un lugar	`GET /venues/{id}`	Cualquier app o sitio web	Ninguna

Un lugar declarado aparece en el mapa cuando un moderador lo ha revisado. Un lugar que ha informado de una emisión en los últimos 10 minutos aparece En directo, con un punto verde, en el mapa y en cada lectura.

Claves

Las claves van en la cabecera Authorization: Bearer <key>. Son gratuitas y no caducan, pero una clave que envía datos erróneos puede revocarse. Una clave que pueda haberse filtrado se sustituye a petición: la antigua deja de funcionar el mismo día.

Clave	Forma	Se da a	Permite
Clave de socio	`apk_live_` + 32 caracteres	Una por empresa, a petición	Declarar, retirar y listar los lugares de ese socio; informarlos en directo desde la nube del socio
Clave de lugar	`avk_` + 32 caracteres	Se devuelve al declarar un lugar; también la da el equipo del mapa para un lugar que ya está en él	Informar en directo de ese único lugar
Clave de prueba	`apk_test_` + 32 caracteres	Cualquiera que la pida	Todas las llamadas de socio, con datos de prueba que nunca llegan al mapa

Una clave de lugar solo permite a un dispositivo decir «este lugar está emitiendo»: no puede cambiar el nombre, la dirección ni los flujos del lugar. Un transmisor puede guardarla sin riesgo para la ficha.

Para obtener una clave, escriba a contact@aurapulse.org con el nombre de su empresa, los productos afectados y el nombre que se mostrará como fuente en el mapa. Una clave de prueba suele enviarse el mismo día.

Declarar un lugar

POST /venues con una clave de socio, cuando se instala un transmisor o cambian sus ajustes de emisión. Llamar de nuevo con el mismo external_id actualiza el lugar en vez de crear otro.

curl -X POST "https://aurapulse.org/api/v1/venues" \
  -H "Authorization: Bearer apk_live_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: ExampleApp/4.2" \
  -d @venue.json

{
  "external_id": "site-48213",
  "name": "Example Cinema",
  "address": "1 Example Street, 00000 Exampletown, France",
  "country": "FR",
  "lat": 46.5802,
  "lng": 0.3404,
  "type": "screen",
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "label": "Screen 1", "access": "open", "languages": ["fr"] },
    { "name": "EXAMPLE_SCREEN_2", "label": "Screen 2, English version", "access": "password", "languages": ["en"] }
  ],
  "public": true
}

external_id, name, country, streams y public son obligatorios, además de address o lat + lng. Cada campo se describe en El objeto lugar.
public debe ser true: el mapa solo recoge lugares abiertos al público. Se rechazan viviendas, oficinas o eventos privados.
Nunca envíe la contraseña de emisión (Broadcast Code): access solo indica si existe.

Respuesta 201 Created (o 200 OK en una actualización):

{
  "id": "example-cinema-exampletown",
  "status": "pending",
  "venue_key": "avk_...",
  "map_url": "https://aurapulse.org/map/#example-cinema-exampletown"
}

status es pending hasta que un moderador publica el lugar, y luego published. venue_key solo se devuelve en la primera declaración: guárdela en el transmisor si puede informar en directo.

Un lugar que ya está en el mapa

Recomendado: antes de declarar, lea los lugares a menos de 200 m (GET /venues?lat=…&lng=…&radius_km=0.2) y pregunte al instalador si el sitio es uno de ellos. Si lo es, envíe su id en join_venue_id. Si no, el mapa asocia la declaración por sí mismo, en este orden:

Mismo socio y mismo external_id: el mismo lugar, actualizado.
Un lugar a menos de 150 m que ya tiene uno de los Broadcast Names declarados: el mismo lugar. La respuesta da su id existente.
Un lugar a menos de 150 m con un nombre parecido pero sin Broadcast Names en común: queda pending y se señala al moderador como posible duplicado.
Nada cerca: un lugar nuevo, pending.

Cuando una declaración se une a un lugar, su nivel sube a declared, pero se mantiene un nivel venue (confirmado por el propio lugar), así como los campos corregidos a mano por el equipo del mapa. Dos lugares en un mismo edificio (un cine y una tienda del mismo centro comercial) siguen separados mientras sus Broadcast Names sean distintos.

Retirar un lugar

DELETE /venues/{id} con la clave de socio que lo declaró, por ejemplo al desinstalar un transmisor. El lugar deja de estar En directo al instante y sale del mapa cuando un moderador lo confirma. Respuesta 202 Accepted:

{ "id": "example-cinema-exampletown", "status": "removal_requested" }

GET /partner/venues lista todos los lugares declarados con su clave, con su external_id y su status, 100 por página (next da la página siguiente). Es la forma de comprobar una declaración sin esperar a verla en el mapa.

Informar en directo

POST /venues/{id}/live con la clave de ese lugar (o la clave de socio que lo declaró, para la nube de un socio), cada 5 minutos mientras el transmisor emite. El lugar aparece En directo durante 10 minutos tras el último aviso, así que un aviso perdido no cambia nada.

{
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "access": "open" },
    { "name": "EXAMPLE_SCREEN_2", "access": "password" }
  ],
  "device": { "maker": "Example Audio", "model": "TX-200", "firmware": "2.3.1" }
}

streams lista lo que se emite ahora. Una lista vacía significa que el transmisor está encendido pero en silencio: el lugar no aparece En directo.
Solo cuentan los Broadcast Names declarados para el lugar; los demás se ignoran y se devuelven en ignored.
device es opcional y solo sirve para mostrar la fuente («En directo vía Example Audio TX-200»).
Añada un retraso aleatorio de 0 a 60 segundos al primer aviso tras el encendido, para que muchos transmisores que se reinician juntos tras un corte de luz no llamen todos a la vez.
Solo lo que está en línea puede informar. Un transmisor sin red conserva su sitio en el mapa pero nunca aparece En directo.

Respuesta 200 OK:

{
  "live_until": "2026-10-19T21:10:00Z",
  "next_report_in": 300,
  "ignored": []
}

next_report_in está en segundos y debe respetarse: permite al mapa ralentizar todos los dispositivos sin actualizar el firmware. Un dispositivo que informa más a menudo recibe 429.

Leer lugares

No hace falta clave. Las respuestas pueden pedirse desde cualquier página web (CORS abierto) y guardarse en caché 60 segundos.

GET /venues?lat=46.58&lng=0.34&radius_km=25 devuelve los lugares publicados dentro de radius_km (0,1 a 100, 25 por defecto), del más cercano al más lejano, 50 por página:

{
  "venues": [
    {
      "id": "example-cinema-exampletown",
      "name": "Example Cinema",
      "city": "Exampletown",
      "lat": 46.5802,
      "lng": 0.3404,
      "distance_km": 0.4,
      "type": "screen",
      "streams": [{ "name": "EXAMPLE_SCREEN_1", "access": "open", "languages": ["fr"] }],
      "level": "declared",
      "live": { "status": "live", "since": "2026-10-19T19:02:00Z", "last_seen": "2026-10-19T21:00:00Z" }
    }
  ],
  "next": null
}

live=only deja solo los lugares en directo. type=screen,worship filtra por tipo.
next es la URL de la página siguiente, o null.
GET /venues/{id} devuelve un lugar, o 404.

El objeto lugar

Campo	Tipo	Reglas
`id`	string	Lo fija el mapa a partir del nombre y la ciudad. Nunca cambia.
`external_id`	string	Su propio identificador del sitio, de 1 a 64 caracteres. Solo se le devuelve a usted.
`join_venue_id`	string	Solo al declarar: el `id` de un lugar existente elegido por el instalador. Ver Un lugar que ya está en el mapa.
`name`	string	Nombre del lugar tal como lo conoce el público, de 2 a 80 caracteres.
`address`	string	Dirección postal completa, hasta 200 caracteres.
`city`	string	Se deduce de la dirección si falta.
`country`	string	Código ISO 3166-1 alfa-2: `FR`, `GB`, `US`…
`lat`, `lng`	number	WGS 84, 5 decimales o más. Se obtienen de la dirección si faltan (OpenStreetMap).
`type`	string	Uno de `screen`, `public`, `museum`, `worship`, `transport`, `education`, `hearing`, `sport`, `health`, `retail`, `other`. `screen` es un cine, teatro o sala de conciertos; `public` un ayuntamiento, biblioteca o juzgado; `hearing` un centro auditivo. Pueden añadirse más tipos: muestre un tipo desconocido como `other`.
`type_detail`	string	Opcional, hasta 40 caracteres, palabras libres sobre el lugar (`Stadium`, `Hospital`).
`streams`	array	De 1 a 16 elementos.
`streams[].name`	string	El Broadcast Name exactamente como se emite, de 1 a 32 caracteres.
`streams[].label`	string	Opcional, hasta 40 caracteres: para qué sirve el flujo (`Screen 1`, `English version`).
`streams[].access`	string	`open`, `password` o `unknown`. La contraseña nunca se envía.
`streams[].languages`	array	Códigos ISO 639-1 opcionales del audio (`fr`, `en`).
`public`	boolean	Debe ser `true` al declarar. No se devuelve.
`level`	string	Solo se devuelve: `documented` (hallado en una fuente pública), `reported` (enviado por un visitante con el formulario del mapa), `declared` (enviado por un socio con esta API), `venue` (confirmado por el propio lugar).
`source`	object	Solo se devuelve: el nombre del socio, o el artículo de prensa.
`live`	object	Solo se devuelve: `status` (`live` u `off`), `since` y `last_seen` (ISO 8601, UTC).

Cuando el equipo del mapa pasa un lugar a un tipo más preciso, una declaración posterior con other no lo deshace.

Errores y límites

Todos los errores tienen la misma forma, para que un dispositivo pueda registrarlos tal cual:

{ "error": { "code": "invalid_field", "field": "streams[1].name", "message": "Broadcast Name is longer than 32 characters." } }

HTTP	code	Cuándo
400	`invalid_json`, `invalid_field`, `missing_field`	No se puede leer el cuerpo, o un campo no cumple sus reglas
401	`missing_key`, `unknown_key`	Sin clave, o una clave que el mapa no conoce
403	`revoked_key`, `not_your_venue`, `not_public`	Clave revocada, lugar declarado por otro socio, o `public` no es `true`
404	`not_found`	Ningún lugar con ese id, o una dirección desconocida
409	`external_id_conflict`	Este `external_id` ya se usa para otro sitio
429	`too_many_requests`	Por encima de un límite de abajo; la cabecera `Retry-After` indica cuándo reintentar
500, 503	`server_error`, `maintenance`	Por nuestra parte; reintente tras `Retry-After`, o 5 minutos

Llamada	Límite
Declarar o retirar	500 al día por clave de socio
Informar en directo	1 por `next_report_in` y por lugar (300 segundos hoy)
Leer	60 por minuto por dirección IP

Pruebas

Una clave de prueba (apk_test_…) funciona en todas las llamadas de socio, con los mismos controles y respuestas, más "test": true. Las declaraciones de prueba nunca llegan a los moderadores ni al mapa público, y se borran tras 24 horas. Compruébelas con GET /partner/venues. Los avisos en directo de prueba usan las claves de lugar devueltas por las declaraciones de prueba.

Reglas

Sin datos personales. La API recibe y da solo lugares y emisiones: ni nombres de instaladores, ni correos electrónicos, ni números de serie. Las direcciones IP se usan para los límites de uso y se guardan 7 días como máximo. Detalles en la política de privacidad.

Solo lugares públicos. Un moderador revisa los lugares declarados antes de que aparezcan.

Derecho de retirada. Cualquier lugar puede pedir salir del mapa en contact@aurapulse.org, aunque lo haya declarado un socio; se retira en 7 días y no vuelve a declararse por la API.

Las contraseñas son privadas. El mapa muestra que un flujo está protegido, nunca su contraseña.

Reutilizar los datos. Todo lo que devuelven las lecturas está bajo CC BY 4.0: libre de mostrar en cualquier app o sitio, con la mención «Data: AuraPulse broadcast map» y un enlace a aurapulse.org/map.

Sin garantía. La API es gratuita y funciona en un alojamiento pequeño, sin promesa de disponibilidad. Los clientes deben seguir funcionando cuando no responde: una declaración perdida puede reenviarse, un aviso en directo perdido solo retrasa el punto verde.

Versiones. La v1 solo crece: nuevos campos opcionales, nuevos valores y nuevas llamadas, nunca un campo quitado o renombrado. Un cambio que rompa una integración irá a una v2, anunciada con 12 meses de antelación, y la v1 seguirá funcionando durante ese tiempo.

Especificación abierta. Esta página se publica bajo CC BY 4.0: cualquiera puede implementarla, incluido otro mapa.

Marcas. Auracast™ es una marca de Bluetooth SIG, Inc.; AuraPulse es un proyecto independiente, no afiliado ni respaldado por Bluetooth SIG. El nombre de un socio solo aparece en el mapa con su acuerdo.

Fuera de la v1

Previsto como campos opcionales, para que las integraciones v1 sigan funcionando: horarios de emisión («los sábados durante las funciones»), un enlace que abra un flujo libre directamente desde una app, y publicación automática para los socios cuyas declaraciones hayan demostrado ser fiables. Ideas y preguntas son bienvenidas en contact@aurapulse.org.

Versión 1 · actualizada el 19 de octubre de 2026 · https://aurapulse.org/api/v1/

Entwickler · API v1

API der Übertragungskarte

Mit drei HTTPS-Aufrufen melden Installations-Apps Orte mit Auracast™-Übertragungen, sagen vernetzte Sender, dass ein Ort gerade sendet, und kann jede App die Karte lesen. Kostenlos, offene Spezifikation, keine personenbezogenen Daten.

REST + JSON
Kostenlos
Lesen ohne Schlüssel
Daten unter CC BY 4.0

Schnellstart

Jeder Aufruf geht an https://aurapulse.org/api/v1/, sendet und liefert JSON (UTF-8) und funktioniert nur über HTTPS. Senden Sie einen User-Agent-Header mit Name und Version Ihrer App oder Ihres Geräts (zum Beispiel ExampleApp/4.2), damit sich ein Fehler zurückverfolgen lässt.

Lesen braucht keinen Schlüssel. Probieren Sie es jetzt im Terminal:

curl "https://aurapulse.org/api/v1/venues?lat=46.58&lng=0.34&radius_km=25"

Oder gleich hier

Die Antwort erscheint hier.

Die API selbst antwortet immer auf Englisch, unabhängig von der Sprache dieser Seite.

Aufruf	Methode und Pfad	Wer ruft ihn auf	Schlüssel
Einen Ort melden	`POST /venues`	Installations- und Konfigurations-Apps, wenn ein Sender eingerichtet wird	Partner
Einen Ort entfernen	`DELETE /venues/{id}`	Der Partner, der ihn gemeldet hat	Partner
Meine Orte auflisten	`GET /partner/venues`	Ein Partner, der seine Meldungen prüft	Partner
Live melden	`POST /venues/{id}/live`	Vernetzte Sender, die Cloud eines Partners	Ort oder Partner
Orte in der Nähe lesen	`GET /venues?lat=&lng=&radius_km=`	Jede App oder Website	Keiner
Einen Ort lesen	`GET /venues/{id}`	Jede App oder Website	Keiner

Ein gemeldeter Ort erscheint auf der Karte, sobald ein Moderator ihn geprüft hat. Ein Ort, der in den letzten 10 Minuten live gemeldet hat, erscheint als Live mit grünem Punkt, auf der Karte und in jeder Abfrage.

Schlüssel

Schlüssel stehen im Header Authorization: Bearer <key>. Sie sind kostenlos und laufen nicht ab, aber ein Schlüssel, der falsche Daten sendet, kann gesperrt werden. Ein möglicherweise bekannt gewordener Schlüssel wird auf Anfrage ersetzt: Der alte funktioniert noch am selben Tag nicht mehr.

Schlüssel	Form	Erhält	Erlaubt
Partnerschlüssel	`apk_live_` + 32 Zeichen	Einer pro Unternehmen, auf Anfrage	Orte dieses Partners melden, entfernen und auflisten; sie aus der Cloud des Partners live melden
Ortsschlüssel	`avk_` + 32 Zeichen	Wird beim Melden eines Ortes geliefert; auch vom Kartenteam für einen Ort, der schon auf der Karte ist	Nur diesen einen Ort live melden
Testschlüssel	`apk_test_` + 32 Zeichen	Alle, die danach fragen	Alle Partneraufrufe, mit Testdaten, die nie auf die Karte gelangen

Mit einem Ortsschlüssel kann ein Gerät nur sagen “dieser Ort sendet”: Name, Adresse und Streams des Ortes kann er nicht ändern. Ein Sender kann ihn ohne Risiko für den Eintrag speichern.

Einen Schlüssel erhalten Sie per E-Mail an contact@aurapulse.org mit Ihrem Firmennamen, den betroffenen Produkten und dem Namen, der auf der Karte als Quelle erscheinen soll. Ein Testschlüssel kommt meist am selben Tag.

Einen Ort melden

POST /venues mit einem Partnerschlüssel, wenn ein Sender installiert wird oder sich seine Sendeeinstellungen ändern. Ein erneuter Aufruf mit derselben external_id aktualisiert den Ort, statt einen zweiten anzulegen.

curl -X POST "https://aurapulse.org/api/v1/venues" \
  -H "Authorization: Bearer apk_live_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: ExampleApp/4.2" \
  -d @venue.json

{
  "external_id": "site-48213",
  "name": "Example Cinema",
  "address": "1 Example Street, 00000 Exampletown, France",
  "country": "FR",
  "lat": 46.5802,
  "lng": 0.3404,
  "type": "screen",
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "label": "Screen 1", "access": "open", "languages": ["fr"] },
    { "name": "EXAMPLE_SCREEN_2", "label": "Screen 2, English version", "access": "password", "languages": ["en"] }
  ],
  "public": true
}

external_id, name, country, streams und public sind Pflicht, dazu address oder lat + lng. Jedes Feld ist unter Das Ort-Objekt beschrieben.
public muss true sein: Die Karte listet nur öffentlich zugängliche Orte. Eine Wohnung, ein Büro oder eine private Veranstaltung wird abgelehnt.
Senden Sie nie das Sendepasswort (Broadcast Code): access sagt nur, ob es eines gibt.

Antwort 201 Created (oder 200 OK bei einer Aktualisierung):

{
  "id": "example-cinema-exampletown",
  "status": "pending",
  "venue_key": "avk_...",
  "map_url": "https://aurapulse.org/map/#example-cinema-exampletown"
}

status ist pending, bis ein Moderator den Ort veröffentlicht, danach published. venue_key wird nur bei der ersten Meldung geliefert: Speichern Sie ihn im Sender, wenn dieser live melden kann.

Ein Ort, der schon auf der Karte ist

Empfohlen: Lesen Sie vor dem Melden die Orte im Umkreis von 200 m (GET /venues?lat=…&lng=…&radius_km=0.2) und fragen Sie den Installateur, ob der Ort einer davon ist. Wenn ja, senden Sie dessen id als join_venue_id. Sonst ordnet die Karte die Meldung selbst zu, in dieser Reihenfolge:

Gleicher Partner und gleiche external_id: derselbe Ort, aktualisiert.
Ein Ort im Umkreis von 150 m, der schon einen der gemeldeten Broadcast Names hat: derselbe Ort. Die Antwort nennt seine bestehende id.
Ein Ort im Umkreis von 150 m mit ähnlichem Namen, aber ohne gemeinsamen Broadcast Name: bleibt pending und wird dem Moderator als mögliche Dublette gezeigt.
Nichts in der Nähe: ein neuer Ort, pending.

Schließt sich eine Meldung einem Ort an, steigt seine Stufe auf declared, eine Stufe venue (vom Ort selbst bestätigt) bleibt aber erhalten, ebenso die vom Kartenteam von Hand korrigierten Felder. Zwei Orte in einem Gebäude (ein Kino und ein Geschäft im selben Einkaufszentrum) bleiben getrennt, solange ihre Broadcast Names verschieden sind.

Einen Ort entfernen

DELETE /venues/{id} mit dem Partnerschlüssel, der ihn gemeldet hat, zum Beispiel wenn ein Sender abgebaut wird. Der Ort ist sofort nicht mehr Live und verschwindet von der Karte, sobald ein Moderator bestätigt. Antwort 202 Accepted:

{ "id": "example-cinema-exampletown", "status": "removal_requested" }

GET /partner/venues listet alle mit Ihrem Schlüssel gemeldeten Orte mit external_id und status, 100 pro Seite (next liefert die nächste Seite). So prüfen Sie eine Meldung, ohne auf die Karte zu warten.

Live melden

POST /venues/{id}/live mit dem Schlüssel dieses Ortes (oder dem Partnerschlüssel, der ihn gemeldet hat, für die Cloud eines Partners), alle 5 Minuten, solange der Sender sendet. Der Ort bleibt 10 Minuten nach der letzten Meldung Live, eine verpasste Meldung ändert also nichts.

{
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "access": "open" },
    { "name": "EXAMPLE_SCREEN_2", "access": "password" }
  ],
  "device": { "maker": "Example Audio", "model": "TX-200", "firmware": "2.3.1" }
}

streams listet, was gerade gesendet wird. Eine leere Liste heißt: Der Sender ist an, aber stumm; der Ort wird nicht als Live gezeigt.
Nur für den Ort gemeldete Broadcast Names zählen; andere werden ignoriert und in ignored zurückgegeben.
device ist optional und dient nur zur Anzeige der Quelle (“Live über Example Audio TX-200”).
Warten Sie vor der ersten Meldung nach dem Einschalten zufällig 0 bis 60 Sekunden, damit viele Sender, die nach einem Stromausfall gleichzeitig starten, nicht alle auf einmal aufrufen.
Nur was online ist, kann melden. Ein Sender ohne Netz behält seinen Platz auf der Karte, wird aber nie als Live gezeigt.

Antwort 200 OK:

{
  "live_until": "2026-10-19T21:10:00Z",
  "next_report_in": 300,
  "ignored": []
}

next_report_in ist in Sekunden angegeben und muss eingehalten werden: So kann die Karte alle Geräte ohne Firmware-Update verlangsamen. Ein Gerät, das öfter meldet, erhält 429.

Orte lesen

Kein Schlüssel nötig. Die Antworten können von jeder Webseite abgerufen werden (CORS offen) und 60 Sekunden zwischengespeichert werden.

GET /venues?lat=46.58&lng=0.34&radius_km=25 liefert die veröffentlichten Orte im Umkreis von radius_km (0,1 bis 100, Standard 25), die nächsten zuerst, 50 pro Seite:

{
  "venues": [
    {
      "id": "example-cinema-exampletown",
      "name": "Example Cinema",
      "city": "Exampletown",
      "lat": 46.5802,
      "lng": 0.3404,
      "distance_km": 0.4,
      "type": "screen",
      "streams": [{ "name": "EXAMPLE_SCREEN_1", "access": "open", "languages": ["fr"] }],
      "level": "declared",
      "live": { "status": "live", "since": "2026-10-19T19:02:00Z", "last_seen": "2026-10-19T21:00:00Z" }
    }
  ],
  "next": null
}

live=only behält nur die Orte, die gerade live sind. type=screen,worship filtert nach Typ.
next ist die URL der nächsten Seite oder null.
GET /venues/{id} liefert einen Ort oder 404.

Das Ort-Objekt

Feld	Typ	Regeln
`id`	string	Von der Karte aus Name und Stadt gebildet. Ändert sich nie.
`external_id`	string	Ihre eigene Kennung des Standorts, 1 bis 64 Zeichen. Wird nur Ihnen zurückgegeben.
`join_venue_id`	string	Nur beim Melden: die `id` eines bestehenden Ortes, den der Installateur gewählt hat. Siehe Ein Ort, der schon auf der Karte ist.
`name`	string	Name des Ortes, wie die Öffentlichkeit ihn kennt, 2 bis 80 Zeichen.
`address`	string	Vollständige Postanschrift, bis 200 Zeichen.
`city`	string	Wird aus der Adresse ergänzt, wenn sie fehlt.
`country`	string	ISO-3166-1-Alpha-2-Code: `FR`, `GB`, `US`…
`lat`, `lng`	number	WGS 84, 5 Nachkommastellen oder mehr. Werden aus der Adresse ermittelt, wenn sie fehlen (OpenStreetMap).
`type`	string	Einer von `screen`, `public`, `museum`, `worship`, `transport`, `education`, `hearing`, `sport`, `health`, `retail`, `other`. `screen` ist ein Kino, Theater oder Konzertsaal; `public` ein Rathaus, eine Bibliothek oder ein Gericht; `hearing` ein Hörakustiker. Weitere Typen können hinzukommen: Zeigen Sie einen unbekannten Typ als `other`.
`type_detail`	string	Optional, bis 40 Zeichen, freie Beschreibung des Ortes (`Stadium`, `Hospital`).
`streams`	array	1 bis 16 Einträge.
`streams[].name`	string	Der Broadcast Name genau wie gesendet, 1 bis 32 Zeichen.
`streams[].label`	string	Optional, bis 40 Zeichen: wofür der Stream ist (`Screen 1`, `English version`).
`streams[].access`	string	`open`, `password` oder `unknown`. Das Passwort selbst wird nie gesendet.
`streams[].languages`	array	Optionale ISO-639-1-Codes des Tons (`fr`, `en`).
`public`	boolean	Muss beim Melden `true` sein. Wird nicht zurückgegeben.
`level`	string	Nur in Antworten: `documented` (aus einer öffentlichen Quelle), `reported` (von einem Besucher über das Kartenformular gesendet), `declared` (von einem Partner über diese API gesendet), `venue` (vom Ort selbst bestätigt).
`source`	object	Nur in Antworten: der Name des Partners oder der Presseartikel.
`live`	object	Nur in Antworten: `status` (`live` oder `off`), `since` und `last_seen` (ISO 8601, UTC).

Wenn das Kartenteam einen Ort einem genaueren Typ zuordnet, macht eine spätere Meldung mit other das nicht rückgängig.

Fehler und Grenzen

Jeder Fehler hat dieselbe Form, damit ein Gerät ihn unverändert protokollieren kann:

{ "error": { "code": "invalid_field", "field": "streams[1].name", "message": "Broadcast Name is longer than 32 characters." } }

HTTP	code	Wann
400	`invalid_json`, `invalid_field`, `missing_field`	Der Inhalt ist nicht lesbar, oder ein Feld verletzt seine Regeln
401	`missing_key`, `unknown_key`	Kein Schlüssel, oder ein Schlüssel, den die Karte nicht kennt
403	`revoked_key`, `not_your_venue`, `not_public`	Schlüssel gesperrt, Ort von einem anderen Partner gemeldet, oder `public` ist nicht `true`
404	`not_found`	Kein Ort mit dieser id, oder unbekannte Adresse
409	`external_id_conflict`	Diese `external_id` wird schon für einen anderen Ort verwendet
429	`too_many_requests`	Über einer Grenze unten; der Header `Retry-After` sagt, wann Sie es erneut versuchen können
500, 503	`server_error`, `maintenance`	Auf unserer Seite; erneut versuchen nach `Retry-After` oder nach 5 Minuten

Aufruf	Grenze
Melden oder entfernen	500 pro Tag und Partnerschlüssel
Live melden	1 pro `next_report_in` und Ort (heute 300 Sekunden)
Lesen	60 pro Minute und IP-Adresse

Testen

Ein Testschlüssel (apk_test_…) funktioniert bei allen Partneraufrufen, mit denselben Prüfungen und Antworten, plus "test": true. Testmeldungen erreichen nie die Moderatoren oder die öffentliche Karte und werden nach 24 Stunden gelöscht. Prüfen Sie sie mit GET /partner/venues. Live-Testmeldungen verwenden die Ortsschlüssel aus den Testmeldungen.

Regeln

Keine personenbezogenen Daten. Die API nimmt und liefert nur Orte und Übertragungen: keine Namen von Installateuren, keine E-Mail-Adressen, keine Seriennummern. IP-Adressen dienen den Nutzungsgrenzen und werden höchstens 7 Tage gespeichert. Details in der Datenschutzerklärung.

Nur öffentliche Orte. Gemeldete Orte werden vor dem Erscheinen von einem Moderator geprüft.

Recht auf Entfernung. Jeder Ort kann unter contact@aurapulse.org verlangen, von der Karte genommen zu werden, auch wenn ein Partner ihn gemeldet hat; er wird innerhalb von 7 Tagen entfernt und nicht erneut über die API gemeldet.

Passwörter bleiben privat. Die Karte zeigt, dass ein Stream geschützt ist, nie sein Passwort.

Daten weiterverwenden. Alles, was die Leseaufrufe liefern, steht unter CC BY 4.0: frei in jeder App oder Website nutzbar, mit dem Hinweis “Data: AuraPulse broadcast map” und einem Link auf aurapulse.org/map.

Keine Garantie. Die API ist kostenlos und läuft auf einem kleinen Hosting, ohne Verfügbarkeitszusage. Clients müssen weiterlaufen, wenn sie nicht antwortet: Eine verpasste Meldung kann erneut gesendet werden, eine verpasste Live-Meldung verzögert nur den grünen Punkt.

Versionen. v1 wächst nur: neue optionale Felder, neue Werte und neue Aufrufe, nie ein entferntes oder umbenanntes Feld. Eine Änderung, die eine Integration brechen würde, kommt in eine v2, 12 Monate vorher angekündigt, und v1 läuft so lange weiter.

Offene Spezifikation. Diese Seite steht unter CC BY 4.0: Jeder darf sie umsetzen, auch eine andere Karte.

Marken. Auracast™ ist eine Marke der Bluetooth SIG, Inc.; AuraPulse ist ein unabhängiges Projekt, nicht mit der Bluetooth SIG verbunden und nicht von ihr unterstützt. Partnernamen erscheinen auf der Karte nur mit deren Zustimmung.

Nicht in v1

Geplant als optionale Felder, damit v1-Integrationen weiterlaufen: Sendezeiten (“samstags während der Vorstellungen”), ein Link, der einen offenen Stream direkt aus einer App öffnet, und automatische Veröffentlichung für Partner, deren Meldungen sich als zuverlässig erwiesen haben. Ideen und Fragen gern an contact@aurapulse.org.

Version 1 · aktualisiert am 19. Oktober 2026 · https://aurapulse.org/api/v1/

Sviluppatori · API v1

API della mappa delle trasmissioni

Tre chiamate HTTPS permettono alle app di installazione di dichiarare i luoghi con trasmissioni Auracast™, ai trasmettitori in rete di dire che un luogo sta trasmettendo adesso, e a qualsiasi app di leggere la mappa. Gratuita, specifica aperta, nessun dato personale.

REST + JSON
Gratuita
Lettura senza chiave
Dati con CC BY 4.0

Avvio rapido

Ogni chiamata va a https://aurapulse.org/api/v1/, invia e restituisce JSON (UTF-8) e funziona solo in HTTPS. Inviate un’intestazione User-Agent con nome e versione della vostra app o del dispositivo (per esempio ExampleApp/4.2), così un errore può essere ricondotto alla sua origine.

La lettura non richiede chiave. Provate subito da un terminale:

curl "https://aurapulse.org/api/v1/venues?lat=46.58&lng=0.34&radius_km=25"

Oppure qui

La risposta apparirà qui.

L’API risponde sempre in inglese, qualunque sia la lingua di questa pagina.

Chiamata	Metodo e percorso	Chi la usa	Chiave
Dichiarare un luogo	`POST /venues`	App di installazione e configurazione, quando si installa un trasmettitore	Partner
Rimuovere un luogo	`DELETE /venues/{id}`	Il partner che lo ha dichiarato	Partner
Elencare i miei luoghi	`GET /partner/venues`	Un partner che controlla le sue dichiarazioni	Partner
Segnalare in diretta	`POST /venues/{id}/live`	Trasmettitori in rete, il cloud di un partner	Luogo o partner
Leggere i luoghi vicini	`GET /venues?lat=&lng=&radius_km=`	Qualsiasi app o sito	Nessuna
Leggere un luogo	`GET /venues/{id}`	Qualsiasi app o sito	Nessuna

Un luogo dichiarato appare sulla mappa dopo il controllo di un moderatore. Un luogo che ha segnalato una trasmissione negli ultimi 10 minuti appare In diretta, con un punto verde, sulla mappa e in ogni lettura.

Chiavi

Le chiavi vanno nell’intestazione Authorization: Bearer <key>. Sono gratuite e non scadono, ma una chiave che invia dati errati può essere revocata. Una chiave che potrebbe essere trapelata viene sostituita su richiesta: la vecchia smette di funzionare lo stesso giorno.

Chiave	Forma	Data a	Permette
Chiave partner	`apk_live_` + 32 caratteri	Una per azienda, su richiesta	Dichiarare, rimuovere ed elencare i luoghi di quel partner; segnalarli in diretta dal cloud del partner
Chiave luogo	`avk_` + 32 caratteri	Restituita quando si dichiara un luogo; data anche dal team della mappa per un luogo già presente	Segnalare in diretta solo quel luogo
Chiave di test	`apk_test_` + 32 caratteri	Chiunque la chieda	Tutte le chiamate partner, su dati di test che non arrivano mai sulla mappa

Una chiave luogo permette a un dispositivo solo di dire «questo luogo sta trasmettendo»: non può cambiare nome, indirizzo o flussi del luogo. Un trasmettitore può conservarla senza rischi per la scheda.

Per avere una chiave, scrivete a contact@aurapulse.org con il nome dell’azienda, i prodotti interessati e il nome da mostrare come fonte sulla mappa. Una chiave di test di solito arriva lo stesso giorno.

Dichiarare un luogo

POST /venues con una chiave partner, quando si installa un trasmettitore o cambiano le sue impostazioni di trasmissione. Una nuova chiamata con lo stesso external_id aggiorna il luogo invece di crearne un secondo.

curl -X POST "https://aurapulse.org/api/v1/venues" \
  -H "Authorization: Bearer apk_live_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: ExampleApp/4.2" \
  -d @venue.json

{
  "external_id": "site-48213",
  "name": "Example Cinema",
  "address": "1 Example Street, 00000 Exampletown, France",
  "country": "FR",
  "lat": 46.5802,
  "lng": 0.3404,
  "type": "screen",
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "label": "Screen 1", "access": "open", "languages": ["fr"] },
    { "name": "EXAMPLE_SCREEN_2", "label": "Screen 2, English version", "access": "password", "languages": ["en"] }
  ],
  "public": true
}

external_id, name, country, streams e public sono obbligatori, più address oppure lat + lng. Ogni campo è descritto in L’oggetto luogo.
public deve essere true: la mappa elenca solo luoghi aperti al pubblico. Un’abitazione, un ufficio o un evento privato vengono rifiutati.
Non inviate mai la password di trasmissione (Broadcast Code): access dice solo se ce n’è una.

Risposta 201 Created (o 200 OK per un aggiornamento):

{
  "id": "example-cinema-exampletown",
  "status": "pending",
  "venue_key": "avk_...",
  "map_url": "https://aurapulse.org/map/#example-cinema-exampletown"
}

status è pending finché un moderatore non pubblica il luogo, poi published. venue_key viene restituita solo alla prima dichiarazione: conservatela nel trasmettitore se può segnalare in diretta.

Un luogo già sulla mappa

Consigliato: prima di dichiarare, leggete i luoghi entro 200 m (GET /venues?lat=…&lng=…&radius_km=0.2) e chiedete all’installatore se il posto è uno di questi. Se sì, inviate il suo id in join_venue_id. Altrimenti la mappa associa da sola la dichiarazione, in quest’ordine:

Stesso partner e stesso external_id: lo stesso luogo, aggiornato.
Un luogo entro 150 m che ha già uno dei Broadcast Names dichiarati: lo stesso luogo. La risposta dà il suo id esistente.
Un luogo entro 150 m con nome simile ma nessun Broadcast Name in comune: resta pending e viene segnalato al moderatore come possibile doppione.
Niente vicino: un nuovo luogo, pending.

Quando una dichiarazione si unisce a un luogo, il suo livello sale a declared, ma un livello venue (confermato dal luogo stesso) viene mantenuto, così come i campi corretti a mano dal team della mappa. Due luoghi nello stesso edificio (un cinema e un negozio nello stesso centro commerciale) restano separati finché i loro Broadcast Names sono diversi.

Rimuovere un luogo

DELETE /venues/{id} con la chiave partner che lo ha dichiarato, per esempio quando si disinstalla un trasmettitore. Il luogo smette subito di essere In diretta e lascia la mappa quando un moderatore conferma. Risposta 202 Accepted:

{ "id": "example-cinema-exampletown", "status": "removal_requested" }

GET /partner/venues elenca tutti i luoghi dichiarati con la vostra chiave, con il loro external_id e status, 100 per pagina (next dà la pagina successiva). È il modo di controllare una dichiarazione senza aspettarla sulla mappa.

Segnalare in diretta

POST /venues/{id}/live con la chiave di quel luogo (o la chiave partner che lo ha dichiarato, per il cloud di un partner), ogni 5 minuti mentre il trasmettitore trasmette. Il luogo resta In diretta per 10 minuti dopo l’ultima segnalazione, quindi una segnalazione persa non cambia nulla.

{
  "streams": [
    { "name": "EXAMPLE_SCREEN_1", "access": "open" },
    { "name": "EXAMPLE_SCREEN_2", "access": "password" }
  ],
  "device": { "maker": "Example Audio", "model": "TX-200", "firmware": "2.3.1" }
}

streams elenca ciò che va in onda adesso. Una lista vuota significa che il trasmettitore è acceso ma muto: il luogo non appare In diretta.
Contano solo i Broadcast Names dichiarati per il luogo; gli altri vengono ignorati e restituiti in ignored.
device è facoltativo e serve solo a mostrare la fonte («In diretta via Example Audio TX-200»).
Aggiungete un ritardo casuale da 0 a 60 secondi alla prima segnalazione dopo l’accensione, così molti trasmettitori che ripartono insieme dopo un’interruzione di corrente non chiamano tutti nello stesso momento.
Solo ciò che è in rete può segnalare. Un trasmettitore senza rete mantiene il suo posto sulla mappa ma non appare mai In diretta.

Risposta 200 OK:

{
  "live_until": "2026-10-19T21:10:00Z",
  "next_report_in": 300,
  "ignored": []
}

next_report_in è in secondi e va rispettato: permette alla mappa di rallentare tutti i dispositivi senza aggiornare il firmware. Un dispositivo che segnala più spesso riceve 429.

Leggere i luoghi

Nessuna chiave. Le risposte possono essere chiamate da qualsiasi pagina web (CORS aperto) e tenute in cache per 60 secondi.

GET /venues?lat=46.58&lng=0.34&radius_km=25 restituisce i luoghi pubblicati entro radius_km (da 0,1 a 100, predefinito 25), dal più vicino, 50 per pagina:

{
  "venues": [
    {
      "id": "example-cinema-exampletown",
      "name": "Example Cinema",
      "city": "Exampletown",
      "lat": 46.5802,
      "lng": 0.3404,
      "distance_km": 0.4,
      "type": "screen",
      "streams": [{ "name": "EXAMPLE_SCREEN_1", "access": "open", "languages": ["fr"] }],
      "level": "declared",
      "live": { "status": "live", "since": "2026-10-19T19:02:00Z", "last_seen": "2026-10-19T21:00:00Z" }
    }
  ],
  "next": null
}

live=only tiene solo i luoghi in diretta. type=screen,worship filtra per tipo.
next è l’URL della pagina successiva, oppure null.
GET /venues/{id} restituisce un luogo, oppure 404.

L’oggetto luogo

Campo	Tipo	Regole
`id`	string	Fissato dalla mappa a partire da nome e città. Non cambia mai.
`external_id`	string	Il vostro identificativo del sito, da 1 a 64 caratteri. Restituito solo a voi.
`join_venue_id`	string	Inviato solo nella dichiarazione: l’`id` di un luogo esistente scelto dall’installatore. Vedi Un luogo già sulla mappa.
`name`	string	Nome del luogo come lo conosce il pubblico, da 2 a 80 caratteri.
`address`	string	Indirizzo postale completo, fino a 200 caratteri.
`city`	string	Ricavata dall’indirizzo se manca.
`country`	string	Codice ISO 3166-1 alfa-2: `FR`, `GB`, `US`…
`lat`, `lng`	number	WGS 84, 5 decimali o più. Ricavate dall’indirizzo se mancano (OpenStreetMap).
`type`	string	Uno tra `screen`, `public`, `museum`, `worship`, `transport`, `education`, `hearing`, `sport`, `health`, `retail`, `other`. `screen` è un cinema, un teatro o una sala da concerto; `public` un municipio, una biblioteca o un tribunale; `hearing` un centro acustico. Potranno aggiungersi altri tipi: mostrate un tipo sconosciuto come `other`.
`type_detail`	string	Facoltativo, fino a 40 caratteri, parole libere per il luogo (`Stadium`, `Hospital`).
`streams`	array	Da 1 a 16 elementi.
`streams[].name`	string	Il Broadcast Name esattamente come trasmesso, da 1 a 32 caratteri.
`streams[].label`	string	Facoltativo, fino a 40 caratteri: a cosa serve il flusso (`Screen 1`, `English version`).
`streams[].access`	string	`open`, `password` o `unknown`. La password non viene mai inviata.
`streams[].languages`	array	Codici ISO 639-1 facoltativi dell’audio (`fr`, `en`).
`public`	boolean	Deve essere `true` nella dichiarazione. Non restituito.
`level`	string	Solo in risposta: `documented` (trovato in una fonte pubblica), `reported` (inviato da un visitatore con il modulo della mappa), `declared` (inviato da un partner con questa API), `venue` (confermato dal luogo stesso).
`source`	object	Solo in risposta: il nome del partner, o l’articolo di stampa.
`live`	object	Solo in risposta: `status` (`live` o `off`), `since` e `last_seen` (ISO 8601, UTC).

Quando il team della mappa sposta un luogo in un tipo più preciso, una dichiarazione successiva con other non lo annulla.

Errori e limiti

Ogni errore ha la stessa forma, così un dispositivo può registrarlo così com’è:

{ "error": { "code": "invalid_field", "field": "streams[1].name", "message": "Broadcast Name is longer than 32 characters." } }

HTTP	code	Quando
400	`invalid_json`, `invalid_field`, `missing_field`	Il corpo non è leggibile, o un campo non rispetta le sue regole
401	`missing_key`, `unknown_key`	Nessuna chiave, o una chiave che la mappa non conosce
403	`revoked_key`, `not_your_venue`, `not_public`	Chiave revocata, luogo dichiarato da un altro partner, o `public` non è `true`
404	`not_found`	Nessun luogo con questo id, o indirizzo sconosciuto
409	`external_id_conflict`	Questo `external_id` è già usato per un altro posto
429	`too_many_requests`	Oltre un limite qui sotto; l’intestazione `Retry-After` dice quando riprovare
500, 503	`server_error`, `maintenance`	Da parte nostra; riprovate dopo `Retry-After`, o dopo 5 minuti

Chiamata	Limite
Dichiarare o rimuovere	500 al giorno per chiave partner
Segnalare in diretta	1 per `next_report_in` e per luogo (oggi 300 secondi)
Leggere	60 al minuto per indirizzo IP

Test

Una chiave di test (apk_test_…) funziona su tutte le chiamate partner, con gli stessi controlli e le stesse risposte, più "test": true. Le dichiarazioni di test non arrivano mai ai moderatori né alla mappa pubblica, e vengono cancellate dopo 24 ore. Controllatele con GET /partner/venues. Le segnalazioni in diretta di test usano le chiavi luogo restituite dalle dichiarazioni di test.

Regole

Nessun dato personale. L’API riceve e restituisce solo luoghi e trasmissioni: niente nomi di installatori, indirizzi e-mail o numeri di serie. Gli indirizzi IP servono ai limiti di uso e sono conservati al massimo 7 giorni. Dettagli nell’informativa sulla privacy.

Solo luoghi pubblici. I luoghi dichiarati sono controllati da un moderatore prima di apparire.

Diritto di rimozione. Qualsiasi luogo può chiedere di essere tolto dalla mappa a contact@aurapulse.org, anche se dichiarato da un partner; viene rimosso entro 7 giorni e non viene più dichiarato tramite l’API.

Le password restano private. La mappa mostra che un flusso è protetto, mai la sua password.

Riutilizzare i dati. Tutto ciò che restituiscono le letture è sotto CC BY 4.0: libero da mostrare in qualsiasi app o sito, con la dicitura «Data: AuraPulse broadcast map» e un link a aurapulse.org/map.

Nessuna garanzia. L’API è gratuita e gira su un piccolo hosting, senza promessa di disponibilità. I client devono continuare a funzionare quando non risponde: una dichiarazione persa può essere reinviata, una segnalazione in diretta persa ritarda solo il punto verde.

Versioni. La v1 cresce soltanto: nuovi campi facoltativi, nuovi valori e nuove chiamate, mai un campo tolto o rinominato. Un cambiamento che romperebbe un’integrazione andrà in una v2, annunciata 12 mesi prima, e la v1 continuerà a funzionare nel frattempo.

Specifica aperta. Questa pagina è pubblicata sotto CC BY 4.0: chiunque può implementarla, anche un’altra mappa.

Marchi. Auracast™ è un marchio di Bluetooth SIG, Inc.; AuraPulse è un progetto indipendente, non affiliato né approvato da Bluetooth SIG. Il nome di un partner appare sulla mappa solo con il suo consenso.

Non nella v1

Previsto come campi facoltativi, così le integrazioni v1 continuano a funzionare: orari di trasmissione («il sabato durante gli spettacoli»), un link che apre un flusso libero direttamente da un’app, e la pubblicazione automatica per i partner le cui dichiarazioni si sono dimostrate affidabili. Idee e domande sono benvenute a contact@aurapulse.org.

Versione 1 · aggiornata il 19 ottobre 2026 · https://aurapulse.org/api/v1/