Référence API v1
Résoudre des identifiants Orbit
Résoudre jusqu’à 100 UUID Orbit et interpréter leurs quatre états de cycle de vie.
POST /v1/interests/resolve
Content-Type: application/json
{"ids":["<orbit-uuid>"]}Le corps contient uniquement ids, un tableau de 0 à 100 UUID canoniques avec tirets. La casse d’entrée est ignorée et les UUID sortants utilisent des minuscules. Les doublons sont supprimés en conservant leur première position ; la réponse contient exactement un résultat par UUID unique, dans cet ordre.
États de résolution
status | Signification | Données retournées |
|---|---|---|
resolved | L’UUID demandé est directement publié. | interest, avec son UUID canonique, son libellé et sa catégorie. |
replaced | L’UUID demandé a été fusionné. | replacedBy et l’interest canonique directement publié. |
unavailable | L’UUID a été publié mais n’est plus redistribuable. | Tombstone sans libellé ni catégorie. |
not_found | L’UUID est inconnu ou n’a jamais été publié. | Aucun détail interne. |
Un UUID Orbit n’est jamais recyclé. Une correction de libellé ou de catégorie conserve l’UUID. Une fusion redirige en un seul saut vers un intérêt directement publié.
Exemple
curl "${ORBIT_BASE_URL}/v1/interests/resolve" \
--request POST \
--header "Authorization: Bearer ${ORBIT_API_KEY}" \
--header "content-type: application/json" \
--data '{"ids":["00000000-0000-0000-0000-000000000000"]}'{
"data": [
{
"requestedId": "00000000-0000-0000-0000-000000000000",
"status": "not_found"
}
],
"meta": {
"apiVersion": "v1",
"inputCount": 1,
"uniqueCount": 1
}
}Cette route ne modifie aucune donnée : son POST peut être réessayé sans effet de bord. Elle renvoie 200 même lorsqu’un ou plusieurs UUID ont le statut not_found ou unavailable.