פריט תיקון

פריט תיקון #

מעדכן סט ספציפי של תכונות של פריט תיקייה. זה משתמש בפורמט ה-Patch JSON לכל שינוי.

PATCH /v1.0/contactdirectoryies/{DIRECTORY_ID}/items/{DIRECTORY_ITEM_ID}

דוגמה #

בקשה זו תוסיף שדה טלפון חדש לפריט תיקייה קיים.

בקשה #

 
תיקון <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123> HTTP/1.1
סוג תוכן: application/json
קבלה-חיובים: נכון
הרשאה: נושא {TOKEN}
קשר: לשמור בחיים
{ 
    "path": "/fields/phone2", 
    "op": "add", 
    "ערך": "+44YYYYYYYYYY" 
}

תגובה #

 
HTTP/1.1 201 נוצר
סוג תוכן: application/json; charset=utf-8
אורך תוכן: xx
מיקום: <https://api.na.myreports.cloud/api/v1.0/contactdirectories/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000123> 
{ 
	"data": { 
        "id": "00000000-0000-0000-0000-00000-000000000123", 
        "שדות": { 
            "כותרת": "מר", 
            "fullName": "CRM3a", 
            "שם חברה": "חברה", 
            "jobTitle": "Job Title", 
            "phone1": "+44XXXXXXXXXXXX", 
            "phone2": "+44YYYYYYYYY", 
            "אימייל": "כתובת דוא"ל", 
            "field1": "field1", 
            "field2": "field2", 
            "crmId": "00000000-00000-00000-00000-0000000001" 
        }
    }, 
	"סטטוס": "הצלחה", 
	"חותמת זמן": "2019-11-29T16:03:23.9251680Z" 
}

טעויות #

לא מורשה #

כאשר האסימון אינו מסופק, אינו תקף או פג תוקף

 
HTTP/1.1 401 לא מורשה

בקשה גרועה #

כאשר מזהה פריט התיקייה שסופק אינו בפורמט הנכון

 
HTTP/1.1 בקשה רעה 400
תאריך: יום ה', 06 בפברואר 2020, 12:45:27 GMT
סוג תוכן: application/json; charset=utf-8
אורך התוכן: 149
{ 
	"שגיאה": 400, 
	"הודעה": "הערך '<tenant id>' אינו תקף.", 
	"סטטוס": "שגיאה", 
	"חותמת זמן": "2020-02-06T12:45:27.5903465Z" 
}

לא נמצא #

כשאין פריטי תיקייה שיש להם מזהה תואם

 
HTTP/1.1 404 לא נמצא
תאריך: יום ה', 06 בפברואר 2020 12:46:58 GMT
סוג תוכן: application/json; charset=utf-8
אורך התוכן: 95
{ 
	"שגיאה": 404, 
	"הודעה": "לא נמצא", 
	"סטטוס": "שגיאה", 
	"חותמת זמן": "2020-02-06T12:46:58.7669535Z" 
}