Developpeur

Retour

SPOCK offre une API permettant d'accéder en temps réel aux informations de Campagnes, Projets, StabTraj, Lancements, Recups et Propulseurs.

Connectez-vous et sélectionnez une campagne pour afficher ses informations d'authentification. Les informations des StabTraj sont disponibles en leurs pieds de page.

`GET` Requête API en lecture

Les requêtes en lecture doivent être effectuées sur la page api par GET. Les paramètres à transmettre sont les suivants :

object : type d'objet demandé string
campaign¹ : numéro d'identification interne de la campagne mère integer
id² : numéro d'identification interne de l'objet integer
key²: clé servant de jeton d'authentification, propre à la campagne ou au stabtraj public string (22)

¹ non requis et ignoré si id est fourni
² non requis si object = motor

Exemple :

GET planete-sciences.org/espace/spock/api.html?object=campaign&id=42&key=0123456789abcdefABCDEF

Voici les objets et leurs propriétés accessibles en lecture :

Une campagne en particulier :

GET /api.html?object=campaign&id={campaign_id}&key={campaign_key}

id : numéro d'identification interne unique integer
name : nom string
year : année integer (4)
owner_id : numéro d'identification interne unique du propriétaire integer
owner_name : nom du propriétaire string
rocketry : true si mode rocketry (pages altimètres et arbitrage) boolean
shuttle : true si mode navette (page navette) boolean
motors : tableau des numéros d'identification interne uniques des propulseurs proposés array(integer)
launchpads : tableau des noms des rampes array(string)
projects : tableau des projets array(Project::id => object Project)

Exemple:

Un projet en particulier :

GET /api.html?object=project&id={project_id}&key={campaign_key}

Tous les projet d'une campagne :

GET /api.html?object=project&campaign={campaign_id}&key={campaign_key}

id : numéro d'identification interne unique integer
campaign : numéro d'identification interne unique de la campagne parent integer
source_id : numéro d'identification unique dans l'environnement source integer
source_name : nom de l'environnement source string
- poolzor : Poolzor espace
- rocketry : SCAE Rocketry Challenge
- cspace : SCAE C'Space
- cansat_lycee : SCAE CanSat lycéen
- interne : projet créé dans SPOCK
type : type integer
- 0 : Microfusée
- 1 : Minifusée
- 2 : Rocketry Challenge
- 3 : Fusée expérimentale
- 4 : CanSat
- 5 : Ballon
registration : matricule string
name : nom string
club : nom du club string
phone : numéro de téléphone string
vehicle : true si le projet est véhiculé boolean
time_clubtent : temps de chronologie estimé en tente club, en minutes integer
time_launchpad : temps de chronologie estimé en rampe, en minutes integer
stabtraj : tableau des stabtrajs array(StabTraj::sheet => object StabTraj)
launches : tableau des lancements array(Launch::id => object Launch)
rso : tableau des incidents pyro array(RSO::id => object RSO)

Exemple:

Un StabTraj en particulier :

GET /api.html?object=stabtraj&id={stabtraj_id}&key={campaign_key}

Un StabTraj public en particulier :

GET /api.html?object=stabtraj&id={stabtraj_id}&key={stabtraj_key}

Tous les StabTraj d'une campagne :

GET /api.html?object=stabtraj&campaign={campaign_id}&key={campaign_key}

id : numéro d'identification interne unique integer
project : numéro d'identification interne unique du projet parent integer
sheet : numéro de feuille integer
Forme_ogive : forme de l'ogive integer
- 0 : Parabolique
- 1 : Ogivale
- 2 : Conique
Long_ogive : longueur de l'ogive en mm integer
D_og : diamètre à la base de l'ogive en mm integer
D_ref : diamètre de référence en mm integer
Nb_trans : nombre de transitions integer
l_j|r|s¹ : longueur de la transition j|r|s en mm integer
D1_j|r|s¹ : diamètre avant la transition j|r|s en mm integer
D2_j|r|s¹ : diamètre après la transition j|r|s en mm integer
X_j|r|s¹ : position de la transition j|r|s en mm integer
m_ail|can² : emplenture des ailerons (canards) en mm integer
n_ail|can² : saumon des ailerons (canards) en mm integer
p_ail|can² : flèche des ailerons (canards) en mm integer
E_ail|can² : envergure des ailerons (canards) en mm integer
ep_ail|can² : epaisseur des ailerons (canards) en mm integer
Q_ail|can² : nombre d'ailerons (canards) en mm integer
X_ail|can² : position des ailerons (canards) en mm integer
D_ail|can² : diamètre aux ailerons (canards) en mm integer
propu : numéro d'identification interne unique du propulseur integer
propu_name : nom complet du propulseur string
propu_cat : categorie du propulseur integer
- 0 : Micro
- 1 : Minif
- 2 : MinifEx
- 3 : FusEx
- 4 : CanSat
dep_moteur : choix du délai du propulseur integer
dep_reglage : réglage du délai par forage integer
propu_insert : propulseur integer
- 0 : mesures sans Propulseur
- 1 : mesures avec Propulseur vide
- 2 : mesures avec Propulseur plein
XpropuRef : position du propulseur en mm integer
MasseSans : masse en kg float
XcgSans : position du centre de masse en mm integer
Long_tot : longueur totale en mm integer
Cx : cx float
L_rampe : longueur de la rampe en mm float
Beta_rampe : inclinaison de la rampe en ° integer
Type_rampe : type de rampe integer
- 0 : Non défini
- 1 : Rail
- 2 : Cage
T_ini³ : temps initial en s float
V_ini³ : vitesse initiale en m/s integer
Z_ini³ : altitude initiale en m integer
X_ini³ : position initiale en m integer
prop_ini³ : Δt allumage du propulseur après T_ini en s float
F_para|satellite|satellite2⁴ : type de parachute integer
- 0 : Disque
- 1 : Croix
- 2 : Autre
Re_para|satellite|satellite2⁴ : rayon extérieur du parachute OU surface de référence si F_ = autre float
Ri_para|satellite|satellite2⁴ : rayon intérieur du parachute en mm integer
Cx_para|satellite|satellite2⁴ : cx du parachute float
m_satellite|satellite2⁴ : masse du satellite en kg float
t_satellite|satellite2^{4 5} : temps de largage du satellite en s float
couleur_fusee⁶ : couleur principale de la fusée string
couleur_para⁶ : couleur principale des parachutes string
autonomie⁶ : autonomie du séquenceur, en minutes integer
telem⁶ : informations concernant la télémétrie string
flag⁶ : true si une dérogation au cahier des charges est nécéssaire boolean
note⁶ : notes de contrôle string
time : timestamp de la dernière ouverture integer

¹ disponibles en fonction de Nb_trans
² _can indisponibles si Q_can = 0
³ indisponible si toutes les conditions initiales sont nulles
⁴ _satellite(2) indisponibles si t_satellite(2) = 0
⁵ si t_satellite = 0, alors t_satellite est fixé à la durée du dépotage propulseur
⁶ indisponible si sheet > 0

Exemple:

Un lancement en particulier :

GET /api.html?object=launch&id={launch_id}&key={campaign_key}

Tous les lancements d'une campagne :

GET /api.html?object=launch&campaign={campaign_id}&key={campaign_key}

id : numéro d'identification interne unique integer
project : numéro d'identification interne unique du projet parent integer
arrived : timestamp d'arrivée à l'accueil integer
altimeter : numéro d'altimètre - 42 par défaut si Campaign::rocketry = false integer
safety_checks_progress : avancée des contrôles, sur 100 integer
safety_checks_approved : timestamp de validation des contrôles integer
validator_id : numéro d'identification interne unique du responsable de la qualification integer
validator_name : nom du responsable de la qualification string
ready : heure HH:mm à laquelle le projet sera prêt à partir en ZAS string
embarked : true si le projet a quitté la base vie boolean
zas : timestamp d'arrivée en ZAS integer
launchpad : numéro d'ordre de la rampe integer
launchpad_name : nom correspondant dans la campagne cf Campaign::launchpads string
launched : timestamp du lancement integer
result¹ : résultat du lancement integer
- 0 : Non lancé
- 1 : Nominal
- 2 : Disqualifié
- 3 : Balistique
- 4 : Dest. en vol
- 5 : Perdu
motors² : tableau des numéros d'identification interne uniques des propulseurs utilisés array(integer)
recovered : true si récupéré boolean
location : localisation object Location
note : note associée string

¹ "Disqualifié" disponible si Project::type = 1 (Rocketry).
² vide avant lancement, le détail des moteurs étant alors disponible via le stabtraj.

Exemple:

Un incident Sauvegarde en particulier :

GET /api.html?object=rso&id={rso_id}&key={campaign_key}

Tous les incidents Sauvegarde d'une campagne :

GET /api.html?object=rso&campaign={campaign_id}&key={campaign_key}

id : numéro d'identification interne unique integer
project : numéro d'identification interne unique du projet parent integer
ignition : timestamp de la mise à feu integer
motor : numéro d'identification interne unique du propulseur concerné integer
report : rapport d'incident string

Exemple:

Un moteur en particulier :

GET /api.html?object=motor&id={motor_id}

Tous les moteurs :

GET /api.html?object=motor

id : numéro d'identification interne unique integer
category : categorie integer
- 0 : Micro
- 1 : Minif
- 2 : MinifEx
- 3 : FusEx
- 4 : CanSat
name_full : nom complet intégrant les informations de délai string
name : nom string
manufacturer : fabricant string
length : longueur integer
diameter : diamètre integer
weight_total : masse initiale float
weight_burnout : masse après combustion float
delays : délais disponibles array(integer)
delay_settings : réglages de délai disponibles array(integer)
burntime : durée de combustion à 95% en s float
itot : impulsion totale en N.s float
imoy : impulsion moyenne en N float
imax : impulsion maximale en N float
isp : impulsion spécifique en s float
thrust : table de poussee object JSON

Exemple:

Une localisation en particulier :

GET /api.html?object=location&id={location_id}&key={campaign_key}

id : numéro d'identification interne unique integer
launch : numéro d'identification interne unique du lancement parent integer
latitude : latitude GNSS float
longitude : longitude GNSS float
error : marge d'erreur GNSS, en mètres float
time : timestamp de création integer

Exemple:

L'API renvoi l'objet demandé et ses enfants au format JSON. En cas d'erreur, un object Error est retourné à la place. Voici une représentation des liens parent - enfant entre les différents objets :

object Campaign

array(Project::id => object Project)
- array(StabTraj::sheet => object StabTraj)
- array(Launch::id => object Launch)
  - object Location
- array(RSO::id => object RSO)

`PUT` Requête API en écriture

Les requêtes en écriture doivent être effectuées sur la page api par PUT. Les paramètres à transmettre au format JSON dans le corps de la requête sont les suivants :

object : type d'objet demandé string
id : numéro d'identification interne de l'objet integer
key : clé servant de jeton d'authentification, propre à la campagne ou au stabtraj publicstring (22)
data : propriétés à modifier de l'objet JSON key/value pairs

Exemple :

        PUT
        planete-sciences.org/espace/spock/api.html

Voici les objets et leurs propriétés modifiables via l'API, ainsi que les conditions d'accès en écriture :

Tous les éléments sont modifiables sans conditions.

type
name
club
phone
vehicle
time_clubtent
time_launchpad

Tous les éléments sont modifiables tant que le stabtraj n'est pas lié à un projet qualifié.

Forme_ogive
Long_ogive
D_og
D_ref
Nb_trans
l_j
D1j
D2j
X_j
l_r
D1r
D2r
X_r
l_s
D1s
D2s
X_s
m_ail
n_ail
p_ail
E_ail
ep_ail
Q_ail
X_ail
D_ail
m_can
n_can
p_can
E_can
ep_can
Q_can
X_can
D_can
propu
dep_moteur
dep_reglage
propu_insert
XpropuRef
MasseSans
XcgSans
Long_tot
Cx
L_rampe
Beta_rampe
Type_rampe
T_ini
V_ini
Z_ini
X_ini
prop_ini
F_para
Re_para
Ri_para
Cx_para
m_satellite
t_satellite
F_satellite
Re_satellite
Ri_satellite
Cx_satellite
m_satellite2
t_satellite2
F_satellite2
Re_satellite2
Ri_satellite2
Cx_satellite2
couleur_fusee
couleur_para
autonomie

altimeter : modifiable si launchpad = 0 et Campaign::rocketry = true.
ready : modifiable sans conditions.
embarked : modifiable si safety_checks_approved > 0 et zas = 0.
zas : modifiable si embarked = true et launchpad = 0.
launchpad : modifiable si zas > 0 et result = 0.
recovered : modifiable si result > 0 et Campaign::rocketry = false.

L'API renvoi l'objet complet demandé et ses enfants au format JSON de la même façon que pour une requête en lecture. En cas d'erreur, un object Error est retourné à la place.

Erreur dans la requête

En cas d'erreur dans la requete, la réponse est un object Error.

error_code : code d'erreur string
- 400 bad_request : paramètres obligatoires manquants
- 401 unauthorized : l'id de campagne ou la clé d'API fournie est incorrecte
- 403 forbidden : accès temporairement bloqué suite à un trop grand nombre de tentatives ratées
- 404 not_found : l'objet demandé n'a pas été trouvé
- 405 method_not_allowed : l'objet n'accepte pas le type de requête reçu
- 409 conflict : l'objet a expressement rejeté la requête qu'il ne peut accepter en raison de son état
error_label : description de l'erreur string

Filtrer la réponse

Les caractéristiques de object Launch permettent de filtrer coté client chaque lancement par sa position.

	`arrived`	`altimeter`	`safety_checks_progress`	`safety_checks_approved`	`embarked`	`zas`	`launchpad`	`result`	`recovered`
Attendu aux altimètres		-	-	-	-	-	-	-	-
Attendu aux contrôles			-	-	-	-	-	-	-
En cours de qualification				-	-	-	-	-	-
Qualifié					-	-	-	-	-
En route vers la ZAS						-	-	-	-
En ZAS							-	-	-
En rampe								-	-
Lancé									-
Récupéré / Clos

SPOCK

Suivi Projets Organisation et Contrôles rocKet

Developpeur

GET Requête API en lecture

object Campaign

object Project

object StabTraj

object Launch

object RSO

object Motor

object Location

PUT Requête API en écriture

object Project

object StabTraj

object Launch

Erreur dans la requête

object Error

Filtrer la réponse

`GET` Requête API en lecture

`PUT` Requête API en écriture