Se positionner
Positionner une entreprise sur une demande, et obtenir les coordonnées du client.
Le positionnement passe par le quota de l'abonnement de l'entreprise, ou à défaut débite price_credits Krédits de son solde, exactement comme depuis l'application Kelkun. Le corps ne prend que organization_id.
curl -X POST "https://api.kelkun.app/partner/constructions/<id de la demande>/positions" \
-H "x-api-key: <votre clé>" \
-H "Content-Type: application/json" \
-d '{"organization_id": "<organization_id>"}'Notre réponse
Un 200, avec la demande complète, coordonnées du client comprises :
{
"status": "positioned",
"construction": { "...": "la demande complète" }
}L'appel est sûr à rejouer. Une entreprise déjà positionnée reçoit "status": "already_positioned" avec la même demande, sans second débit.
Les refus
| HTTP | error | Cas |
|---|---|---|
| 409 | CONSTRUCTION_CLOSED | Demande annulée, clôturée ou archivée |
| 409 | CONSTRUCTION_FULL | Plus aucune place |
| 409 | ACCESS_DELAY_PENDING | Pas encore : réessayer après accessible_at |
| 409 | POSITIONING_REFUSED | Autre refus, expliqué dans message (Krédits insuffisants par exemple) |
Les autres erreurs sont communes à toutes les routes : voir Erreurs.
Référence
Authentification
x-api-key La clé d'API que Kelkun vous a transmise.
Dans: header
Paramètres de chemin
Identifiant de la demande, reçu dans le webhook.
uuidCorps de la requête
application/json
Types TypeScript
Le type à reprendre dans votre code TypeScript.
Corps de la réponse
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/partner/constructions/497f6eca-6276-4993-bfeb-53cbbbba6f08/positions" \ -H "Content-Type: application/json" \ -d '{ "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6" }'{ "status": "positioned", "construction": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "reference": "K7Q2M", "title": "Recherche de fuite sous dalle", "description": "string", "status": "PUBLISHED", "skills": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "Recherche de fuite" } ], "city": { "name": "Agen", "zip": "47000", "department": "Lot-et-Garonne" }, "location": { "latitude": 44.2, "longitude": 0.62 }, "is_location_exact": true, "desired_delay_months": 0, "quotes_requested": 3, "positioned_count": 0, "seats_left": 3, "price_credits": 5, "published_at": "2019-08-24T14:15:22Z", "photos": [ { "url": "string", "thumbnail_url": "string", "mime_type": "image/jpeg" } ], "is_positioned": true, "customer": { "first_name": "Marie", "last_name": "D.", "phone": "string", "email": "string" }, "address": { "street": "string", "zip": "string", "city": "string" }, "access_information": "string" }}